Skip to main content
此为预览文档，正式版本尚未发布。
External 的支持范围由 SDK 适配器及其所接入对象共同决定。这里列出仓库已有的适配路径，方便选择集成对象和验收范围。

​
Java

agentscope-extensions-aistio 提供 AgentScope Java Agent 的适配器，包含上下文、消息、会话命令、中止与任务查询等合约能力。不同 Agent 的底层实现仍决定具体命令能否执行。 可选扩展点：SessionHistorySource 提供历史，AgentRuntimeSource 提供 Workspace/Subagent 目录与运行信息，AgentTaskStarter 启动派发任务。HarnessAgentTaskStarter 可以结合 Workspace 工厂消费平台定义。只有配置任务 starter 才声明 agent-task，不能仅创建 bridge 就视为工作执行器。

​
Python 内置适配器

自动识别使用 can_handle(target)，并按注册顺序选择首个匹配项。遇到包装对象无法识别或多个适配器可能匹配时，通过 adapter= 显式指定目标适配器。 当前 Python 内置适配器没有实现 handle_agent_task。 它们可以接入观测与各自实现的会话能力，但不自动获得 Issue/Team 派发能力。框架名相同也不代表 External 与 Hosted 的能力相同，例如 Claude Agent SDK 集成与 Runtime Host 启动 Claude Code CLI 是两条路径。

​
自定义适配器实现哪些部分

继承 FrameworkAdapter 后通过 aistio.instrument(..., adapter=your_adapter) 使用，或用 register_adapter() 加入注册表。基础类会根据覆写方法推导能力；不要用空实现换取 capability 标志。

​
任务接入的额外验收

先验证两个并行 Attempt 不共享会话状态，再验证重试、取消、事件恢复和 Artifact 上传。只显示最终 assistant 消息不等于完成 Attempt；团队协调角色还必须处理节点完成与失败。应用自行维护所需模型、工具和部署依赖。 相关：连接参数 · 工作原理 · Team 协作。