genai-hub-orchestration

Rules

1. Orchestration always requires a running orchestration deployment as a prerequisite — invoke aicore-lifecycle-management first if one does not exist.
2. The orchestration endpoint is POST {DEPLOYMENT_URL}/v2/completion — not /v1/chat/completions.
3. Orchestration scenario_id and executable_id are always "orchestration" — these are fixed.
4. The Harmonized API normalizes all models to OpenAI message format — the same client code works for GPT, Gemini, and Bedrock.
5. If credentials are not configured, invoke aicore-admin-resources first.
6. generative-ai-hub-sdk is deprecated — always use sap-ai-sdk-gen. Import namespace gen_ai_hub is shared by both.
7. If the user's request does not explicitly specify an approach, use AskUserQuestion to ask whether they prefer the REST API (curl) or the Python SDK before writing or running any code.

Deployment Prerequisite

Before using the orchestration service, a deployment must be running:

# Check for an existing orchestration deployment:
uv run skills/aicore-lifecycle-management/scripts/get_deployments.py --scenario orchestration