Skip to main content
此为预览文档，正式版本尚未发布。
将已开发并运行的 AgentScope 应用注册为 External Agent，保留应用自身的部署方式。先完成目录与会话接入，再验证所需的任务能力。

​
准备接入信息

向管理员获取注册范围、应用可访问的 Service HTTP 地址和首次注册凭据。为每个应用副本设置稳定的 instance key，并准备控制面可回连的应用 HTTP 合约地址。

​
注册 Java 应用

  1. 在应用中添加与 SDK 版本配套的 agentscope-extensions-aistio 依赖。
  2. 在 Agent 初始化后调用 Aistio.instrument(agent, config)，保留返回的 SessionBridge。
  3. 对标准 Service 部署，配置 controlPlaneHttp、身份凭据、范围和 publicBaseUrl，启用 startHttpRegister(true) 与 HTTP 合约，设置 startGrpc(false)。
  4. 启动应用，在 DESIGN → Agents 查看注册的 Agent、实例和合约地址。
  5. 在应用自身运行一轮对话，检查平台能读取适配器提供的会话信息；应用退出时关闭 bridge。
可复制的 Maven 与 Java 接入片段见参考手册的Java HTTP 注册与合约。

​
接受平台任务

需要接收 Issue 或加入 Team 时，配置 AgentTaskStarter 等真实任务入口，并验证一次执行的成功、失败和取消回报。仅注册目录和暴露会话信息不会自动获得任务执行能力。 Python 的自动注册与 ASDP 初始化关联，先按参考手册准备支持 ASDP 的部署，再使用 aistio.instrument()。框架与适配能力说明各适配器已实现的范围。 接入完成后，按能力选择Endpoint或控制台 Issue；参数和生命周期见External Agent 参考手册。