Skip to main content
此为预览文档，正式版本尚未发布。
选择 SDK 前，先确定你是在“调用能力”还是“接入运行时”。业务应用调用 Endpoint 不需要安装运行时 SDK；已有 Agent 应用才需要注册与适配。

​
安装包与版本

Service、Java、Python 和 DSH 包独立版本化。按 Release 的 release-manifest.json 选择配套版本，不把镜像版本直接填进所有包管理器。
在对应应用目录执行，变量设为 manifest 中的 SDK 版本。安装 DSH npm 包只是提供插件文件，还需要将插件加入你的 DSH profile，并配置控制面 HTTP、ASDP gRPC 和控制面可达的 contract 地址。provider 登录和应用生命周期仍由 DSH 管理。

​
检查能力与传输

标准完整 Service 使用 standalone HTTP；Java 提供 HTTP 注册与合约能力。ASDP 接入另外需要启用对应 listener 的部署。Python 自动注册依赖其 ASDP 路径，关闭 gRPC 并不能代替这一前提。 先验证目录身份，再验证会话/history，最后验证支持的派发、取消和结果回传。自定义框架通过适配器扩展，不能仅通过修改框架名称宣称新增能力。代码片段、凭据和网络细节见 External Agent。

​
接入验收清单

把“注册成功”和“业务可用”分开验证。按实际支持的能力执行以下步骤，不要求每一种框架实现全部能力：
  1. 目录：确认 Agent 身份、运行方式与声明能力正确，服务地址能从控制面访问。
  2. 会话：提交固定问题，检查回复、工具事件（如有）和历史；再次打开会话确认上下文路径可用。
  3. 任务：如果需要 Issue 或 Team，提交带验收标准的小任务，核对派发、最终结果和 Artifact。只有会话能力的适配器不能据此通过任务接入验收。
  4. 异常：在测试环境停止该应用，观察不可用状态与失败记录；恢复后使用明确的新执行验证。不把旧运行的状态当作新运行结果。
  5. 应用调用：参考订单履约案例，验证 External 成员任务能力后发布 Team Endpoint，检查输入、SSE、结果与业务授权。
验收记录包含 Service、SDK、框架版本和传输方式。完整 Service 的 standalone HTTP 测试通过，不能证明另一套 ASDP listener 已部署或可达。