MaxKB 多智能体路由

解决什么问题

在 MaxKB 中同时部署多个智能体时，宿主模型面临一个朴素难题：它不知道平台上有哪些智能体，更不知道当前问题该分派给谁。硬编码路由规则意味着每新增一个智能体就要改一次代码，而靠自然语言描述做判断又缺少统一的调用接口。这个技能把「发现—选择—调用」拆成两个函数，把路由决策权交还给 LLM，宿主程序只负责传参。

核心能力与调用流程

技能提供两个工具函数，配合宿主智能体的 LLM 完成路由与调用：

• list_agents：无需参数，返回所有已发布智能体的 name 和 desc，以 JSON 数组形式供 LLM 判断选择
• chat_to_agent：按 LLM 指定的 agent_name 调用对应智能体，传入 question 后返回该智能体的回答

推荐流程是先枚举再调用：

• 第一步，宿主程序调用 list_agents 拿到智能体清单
• 第二步，LLM 结合每个智能体的 desc 判断问题归属，选定 agent_name
• 第三步，调用 chat_to_agent 传入 question 与 agent_name，拿到结构化结果

返回值为 JSON 字符串，包含两个字段：agent_name（实际调用的智能体名称）与 answer（智能体的回答内容）。宿主程序可原样返回回答，也可读取 agent_name 做调用审计。

适用边界与注意点

• 路由质量取决于 desc 的描述质量：描述含糊的智能体容易被 LLM 误选或漏选，维护清单时应保证描述与实际能力一致
• 调用前必须配置环境变量：MAXKB_DOMAIN 指定服务地址；认证支持 MAXKB_TOKEN（管理员 API Key）或 MAXKB_USERNAME/MAXKB_PASSWORD 登录凭据，且用户名密码优先于 Token
• MAXKB_WORKSPACE_ID 默认为 default，多工作空间场景需显式指定
• 技能只做发现与调用，不做重试、降级或超时控制，这些逻辑需宿主程序自行处理