外部智能体适配

外部智能体适配

外部智能体接入现有 OpenClaw 或 Hermes 服务。平台保存连接配置、发布版本和资源权限，通过协议客户端执行对话，并将结果纳入统一会话与用量记录。

一、分层位置

业务管理位于 business/agent，协议与执行位于 blade-ai-extension 的 engine/agent。AgentClientFactory 收集 AgentClient 实现，按 provider 选择客户端。

实现	提供方
OpenClawAgentClient	OpenClaw
HermesAgentClient	Hermes
AgentChatServiceImpl	组织调用上下文和对话执行

接入提供方描述协议类型；实际服务地址和认证配置指向具体部署实例。

二、运行上下文

一次调用包含资源定义、当前输入、会话标识与调用方信息。平台会话负责记录，外部会话负责协议上下文；连续对话依赖两者之间的会话映射。

三、新增适配

实现 AgentClient，提供唯一的提供方标识，并完成配置校验、请求构建、响应映射与停止处理。客户端由工厂统一分发，业务控制器不写提供方分支。

前端同步 src/const/agent.ts、实体类型与配置表单。连接测试、草稿试聊和发布运行分别验证连通性、当前配置与线上版本。

接入验证

先使用外部服务自身的地址和凭证完成连接测试，再进行平台内对话。平台登录有效与外部服务认证有效是两项独立条件。

操作步骤见 外部智能体配置。