> ## Documentation Index
> Fetch the complete documentation index at: https://java.agentscope.io/llms.txt
> Use this file to discover all available pages before exploring further.

# SDK 与组件选择

<Note>
  此为预览文档，正式版本尚未发布。
</Note>

选择 SDK 前，先确定你是在“调用能力”还是“接入运行时”。业务应用调用 Endpoint 不需要安装运行时 SDK；已有 Agent 应用才需要注册与适配。

| 目标 | 使用组件 | 接下来 |
| - | - | - |
| 应用调用 Agent/Team/Workflow | 普通 HTTP 客户端 | [Endpoint](/v2/zh/service/endpoints) |
| Java 应用加入目录 | `io.agentscope:agentscope-extensions-aistio` | [External Agent](/v2/zh/service/external-agent) |
| Python 框架接入 ASDP | `aistio-sdk` | [External Agent](/v2/zh/service/external-agent) |
| DeepSeek Harness 接入 | `@agentscope/dsh-aistio` 插件 | 安装插件并配置 HTTP 合约与 ASDP 地址 |
| 本机 Coding Agent 接入 | `agentscope` CLI 与 Runtime Host | [Hosted Agent](/v2/zh/service/hosted-agent) |

## 安装包与版本

Service、Java、Python 和 DSH 包独立版本化。按 Release 的 `release-manifest.json` 选择配套版本，不把镜像版本直接填进所有包管理器。

```bash theme={null}
python -m pip install "aistio-sdk==$AISTIO_SDK_VERSION"
npm install "@agentscope/dsh-aistio@$DSH_AISTIO_VERSION"
```

在对应应用目录执行，变量设为 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](/v2/zh/service/external-agent)。

## 接入验收清单

把“注册成功”和“业务可用”分开验证。按实际支持的能力执行以下步骤，不要求每一种框架实现全部能力：

1. **目录**：确认 Agent 身份、运行方式与声明能力正确，服务地址能从控制面访问。
2. **会话**：提交固定问题，检查回复、工具事件（如有）和历史；再次打开会话确认上下文路径可用。
3. **任务**：如果需要 Issue 或 Team，提交带验收标准的小任务，核对派发、最终结果和 Artifact。只有会话能力的适配器不能据此通过任务接入验收。
4. **异常**：在测试环境停止该应用，观察不可用状态与失败记录；恢复后使用明确的新执行验证。不把旧运行的状态当作新运行结果。
5. **应用调用**：参考[订单履约案例](/v2/zh/service/cases/order-fulfillment)，验证 External 成员任务能力后发布 Team Endpoint，检查输入、SSE、结果与业务授权。

验收记录包含 Service、SDK、框架版本和传输方式。完整 Service 的 standalone HTTP 测试通过，不能证明另一套 ASDP listener 已部署或可达。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.