用途:在 SAP BTP 上开通并调用 SAP AI Core,完成服务实例、资源组、部署配置与部署的创建,并通过 OAuth2 访问模型。
主要能力:用 btp create services/instance 创建 aicore 服务实例(extended 计划),再创建服务绑定并导出为 ai-core-key.json;从绑定 JSON 中提取 AICORE_BASE_URL、AICORE_AUTH_URL、AICORE_CLIENT_ID、AICORE_CLIENT_SECRET;用 client_credentials 换取 access_token;调用 /v2/admin/resourceGroups 创建资源组;调用 /v2/lm/scenarios/foundation-models/configurations 查询区域内可用模型。部署调用可使用 generative-ai-hub-sdk 的 init_llm("模型名", deployment_id=..., temperature=0.0),SDK 会读取 AICORE_* 环境变量并自动刷新 token。
区域限制:china、ksa 区域不要用 anthropic--、gpt-,改用 mistralai--mistral-large-2407、本地开源模型或 Qwen(合作方);ns2 不要硬编码模型,需拉取实时目录并受授权层级限制;commercial 可用完整目录。可用 scripts/region-preflight/region-preflight.sh <region> 预检。
常见问题:缺少 AI-Resource-Group 头会返回 403;部署未 RUNNING 时调用返回 503,需先轮询状态;主权区域调用商业端点会被跨区拦截;容量紧张区域不要长期运行开发部署以免消耗配额。
校验:GET /v2/lm/deployments/$AICORE_MODEL_DEPLOYMENT_ID(带 Authorization 与 AI-Resource-Group 头)应返回 RUNNING。定价、配额与模型清单等未在资料中提供。