SuperAPI AI 工具集

sap-sovereign-regions

智能体与模型

查看项目

更新于 10-16 08:45

技能介绍

用途:在建议或生成任何 SAP AI Core 模型、Joule 能力、BTP 服务的配方或代码前,先确认客户所在区域,避免因硬编码不支持的模型而在部署时报 403。

决策规则:用户已指明区域(china、ns2、ksa、commercial/EU/US/AP)则直接采用;未指明但提示词出现主权关键词(如 21Vianet、FedRAMP、Saudi、国产化、ITAR)时推断区域并确认;仍不明确必须先询问再生成代码。

模型可用性(2026 年 6 月快照,需对照线上目录核实):Anthropic Claude 在 commercial 提供 Sonnet/Opus 4.x,china 与 ksa 无,ns2 为受管子集;OpenAI GPT 在 commercial 提供 4o/5/o 系列,china 与 ksa 无,ns2 为受管子集;Mistral 在 commercial、china、ksa 提供 Large 2407,ns2 需核查;Llama/SAP 托管开源模型在四区均可用(china 优先);Qwen/DeepSeek 在 china 经伙伴提供,其余基本罕见;Falcon 主要在 ksa;OpenAI 嵌入在 commercial 可用、china 与 ksa 不可用、ns2 为子集;多语言 SAP 托管嵌入四区均可用。

新配方默认选择:commercial 用 anthropic--claude-sonnet-4-5 与 text-embedding-3-large;china 与 ksa 用 mistralai--mistral-large-2407 与 SAP 托管多语言嵌入(ksa 需验证阿拉伯语质量);ns2 一律拉取线上目录,不要设默认。

其他差异:跨区域出口在 china 与 ns2 被阻断(FedRAMP)、ksa 受限;公共 PyPI/Docker Hub 在 china 被阻断(用镜像)、ns2 与 ksa 仅镜像;Joule UI 在 china 与 ns2 受限、ksa 正式可用;Joule Studio 2.0/BAIP 三区均为后续支持。

不要硬编码区域默认值。应通过 A2A Agent Toolkit 子模块(toolkits/a2a-agent-toolkit/)的 /sap-a2a-agent-toolkit:create-agent 脚手架,依据实时预检输出与 references/btp-regional-availability.md 的源依据区域参考,传入 --llm-provider aicore 或 --llm-provider openai-compatible。生成项目从环境变量读取模型名(AI Core 用 MODEL_NAME,openai-compatible 用 MODEL_GATEWAY_URL 加网关侧部署名),绝不在模板源码内联模型名。

验证可用 curl -s "$AICORE_BASE_URL/v2/lm/scenarios/foundation-models/configurations" -H "Authorization: Bearer $TOKEN" -H "AI-Resource-Group: $AICORE_RESOURCE_GROUP" | jq -r '.resources[].name' | grep -i "$MODEL_QUERY" 确认模型在客户区域是否可用。

限制:模型与服务可用性会变化,须以线上目录为准;本技能仅涉及区域可用性与预检流程,未提供价格、性能或具体业务效果信息。