SDK 与组件选择 - AgentScope Java

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

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

安装包与版本

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

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。