用途:该技能生成完整的 pro-code AI 智能体项目,使用 LangGraph 构建,以 SAP GenAI Hub 的 OrchestrationClient 作为 LLM 提供方,支持 A2A 协议 v0.3.0,并可部署到 SAP BTP Cloud Foundry,同时创建带 A2A action 的 Joule 能力。
主要能力:支持 TypeScript + Express、TypeScript + CAP、Python + Express 三种配置;通过 scaffold 脚本生成项目;提供 Joule 能力多文件 DTA 格式(capability.sapdas.yaml、da.sapdas.yaml、functions/、scenarios/);提供编译并部署能力的 CLI 命令;支持以 createReactAgent 或 StateGraph 模式实现智能体。
使用方式:提供 scaffold-ts.sh 或 scaffold.py 生成项目,按需修改 src/tools.ts、srv/tools/tools.ts 或 app/tools.py 中的工具、系统提示词和 Agent Card;Express 项目执行 npm install、npm run build 后 cf push;CAP 项目执行 mbt build 后 cf deploy mta_archives/<agent-name>_1.0.0.mtar;随后创建 BTP Destination,并执行 joule deploy ./da.sapdas.yaml --compile -n "<assistant_name>" 部署能力。Joule CLI 安装命令为 npm install -g @sap/joule-cli。
适用场景:需要将外部 LangGraph 智能体接入 SAP Joule,通过 A2A 协议由 Joule 路由用户请求并返回结果的场景。
限制:Joule DTA schema 需 3.28.0 及以上,capability.sapdas.yaml 必须指定 schema_version: "3.28.0",否则部署报错;需 SAP BTP 子账号、启用 Cloud Foundry、部署 GenAI Hub 模型的 AI Core 实例;Joule CLI 需 capabilityadmin 与 extensibility_developer 角色;destination 必须使用 NoAuthentication 或 OAuth2ClientCredentials;metadata.namespace 必须为 joule.ext,其他命名空间会导致部署失败;CAP 仅支持 TypeScript;Python 不支持 CAP;A2A 协议基于 JSON-RPC 2.0 over HTTP(S),Agent Card 必须位于 /.well-known/agent.json;CAP 还需 mbt 与 multiapps CF CLI 插件。官方未提供收费与价格信息。