SAP AI Core CLI (saic-cli)

A developer-friendly CLI for managing SAP AI Core resources — deployments, executions, configurations, secrets, and more.

Interact with SAP AI Core APIs directly from your terminal.

Motivation

Managing AI Core resources through SAP AI Launchpad presents several challenges:

• No entry to create custom scenarios
• No straightforward way to create, update, or delete prompt templates in bulk
• Repetitive tasks like listing scenarios or managing configurations require multiple UI clicks
• No quick way to manage deployments, executions, or secrets from the command line

This CLI bridges these gaps by providing a command-line interface for all SAP AI Core APIs.

Quick Start

1. Install

git clone <repo-url>
cd sap-ai-core-cli
npm run install-global

2. Setup

Connect to your AI Core instance:

# Interactive setup with SSO
saic-cli setup --sso -a <your_api_endpoint>

# Example
saic-cli setup --sso -a https://api.cf.eu10.hana.ondemand.com

Advanced setup options

# Setup manually
saic-cli setup

# Pass any cf login arguments
saic-cli setup --sso -o my-org -s my-space

# Reset configuration
saic-cli setup --reset

All arguments except --force and --reset are passed directly to cf login.

3. Use

# List all deployments
saic-cli list-deployments

# Get deployment details as JSON
saic-cli get-deployment <id> --json

# Create a deployment
saic-cli create-deployment --config-id <configuration-id>

# Preview what a command would do
saic-cli create-deployment --config-id <id> --dry-run

Commands

Setup

Command	Description
setup	Interactive setup wizard for AI Core configuration
install	Build and install CLI globally (for local development)
uninstall	Remove CLI from global installation

Prompt Templates

Command	Description
list-scenarios	List all available scenarios in the registry
list-templates	List prompt templates (all or by scenario)
create-prompt	Create a new prompt template from YAML config
delete	Delete prompt templates (by scenario or specific template)
generate-template	Generate a prompt template from OpenAPI spec

Deployments

Command	Description
list-deployments	List deployments
get-deployment <id>	Get deployment details
create-deployment	Create a new deployment
update-deployment <id>	Update a deployment (e.g. stop/start)
delete-deployment <id>	Delete a deployment

Executions

Command	Description
list-executions	List executions
get-execution <id>	Get execution details
create-execution	Create a new execution
update-execution <id>	Update an execution
delete-execution <id>	Delete an execution

Configurations

Command	Description
list-configurations	List configurations
get-configuration <id>	Get configuration details
create-configuration	Create a new configuration

Scenarios & Models

Command	Description
get-scenario <id>	Get scenario details
list-scenario-versions	List versions of a scenario
list-executables	List executables for a scenario
get-executable <id>	Get executable details
list-models	List models for a scenario

Artifacts

Command	Description
list-artifacts	List artifacts
get-artifact <id>	Get artifact details
create-artifact	Create a new artifact

Execution Schedules

Command	Description
list-execution-schedules	List execution schedules
get-execution-schedule <id>	Get execution schedule details
create-execution-schedule	Create a new execution schedule
update-execution-schedule <id>	Update an execution schedule
delete-execution-schedule <id>	Delete an execution schedule

Metrics & Meta

Command	Description
list-metrics	List metrics
delete-metrics	Delete metrics for an execution
get-meta	Get AI Core service metadata and capabilities

Dataset Files

Command	Description
upload-dataset-file	Upload a file to dataset storage
get-dataset-file	Download a file from dataset storage
delete-dataset-file	Delete a file from dataset storage

Repositories

Command	Description
list-repositories	List git repositories
get-repository <name>	Get repository details
create-repository	Onboard a git repository
update-repository <name>	Update repository credentials
delete-repository <name>	Delete a repository

Applications

Command	Description
list-applications	List ArgoCD applications
get-application <name>	Get application details
create-application	Create an ArgoCD application
update-application <name>	Update an application
delete-application <name>	Delete an application

Secrets

Command	Description
list-docker-secrets	List Docker registry secrets
create-docker-secret	Create a Docker registry secret
update-docker-secret <name>	Update a Docker registry secret
delete-docker-secret <name>	Delete a Docker registry secret
list-object-store-secrets	List object store secrets
create-object-store-secret	Create an object store secret
update-object-store-secret <name>	Update an object store secret
delete-object-store-secret <name>	Delete an object store secret
list-secrets	List generic secrets
get-secret <name>	Get generic secret details
create-secret	Create a generic secret
update-secret <name>	Update a generic secret
delete-secret <name>	Delete a generic secret

Resource Groups & Services

Command	Description
list-resource-groups	List resource groups
get-resource-group <id>	Get resource group details
create-resource-group	Create a resource group
update-resource-group <id>	Update a resource group
delete-resource-group <id>	Delete a resource group
list-services	List AI Core services
get-service <name>	Get service details

Global Options

Option	Description	Default
--json	Output as JSON (available on all commands)	false
--dry-run	Preview action without executing	false
--resource-group	AI resource group (lifecycle commands)	"default"
--force	Skip confirmation on delete commands	false
--top	Max results to return (list commands)	-
--skip	Results to skip for pagination (list commands)	-
--debug	Enable debug logging	false
--verbose	Show detailed output	false

Examples

Manage Deployments

# List running deployments
saic-cli list-deployments --status RUNNING

# List deployments as JSON
saic-cli list-deployments --json

# Create a deployment from a configuration
saic-cli create-deployment --config-id <config-id> --resource-group default

# Stop a deployment
saic-cli update-deployment <id> --target-status STOPPED

# Delete a stopped deployment
saic-cli delete-deployment <id> --force

Manage Configurations

# Create a configuration for GPT-4o
saic-cli create-configuration \
  --name "gpt-4o" \
  --executable-id "azure-openai" \
  --scenario-id "foundation-models" \
  --params '[{"key":"modelName","value":"gpt-4o"}]'

# List configurations for a scenario
saic-cli list-configurations --scenario-id foundation-models

Manage Secrets

# Create a generic secret
saic-cli create-secret --name my-api-key --data '{"key":"sk-xxx"}'

# List secrets in a resource group
saic-cli list-secrets --resource-group my-group

# Delete a secret
saic-cli delete-secret my-api-key --force

List Foundation Models

saic-cli list-models --scenario-id foundation-models --json

Uninstall

saic-cli uninstall