chat_to_agents — 智能路由与调用

功能描述

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

| 函数 | 作用 | |-----------------|----------------------------------------------------------------------| | list_agents | 返回所有已发布智能体的 name 和 desc，供 LLM 判断选择 | | chat_to_agent | 按 LLM 指定的 agent_name 调用对应智能体，返回回答 |

推荐调用流程

用户提问
   │
   ▼
LLM 调用 list_agents()          ← 获取智能体列表
   │  返回 [{"name":..., "desc":...}, ...]
   ▼
LLM 根据问题选出最合适的 agent_name
   │
   ▼
LLM 调用 chat_to_agent(question, agent_name)  ← 发起对话
   │  返回 {"agent_name":..., "answer":...}
   ▼
将 answer 返回给用户

list_agents

python3 scripts/main.py 

无需参数，返回 JSON 数组：

[
  {"name": "客服助手", "desc": "处理用户常见问题"},
  {"name": "代码助手", "desc": "辅助编写和审查代码"}
]

chat_to_agent

python3 scripts/main.py <question> <agent_name>

| 参数 | 类型 | 说明 | |--------------|--------|--------------------------------------| | question | string | 用户的问题文本 | | agent_name | string | 由 LLM 从 list_agents 结果中选定的名称 |

返回 JSON 字符串：

| 字段 | 类型 | 说明 | |--------------|--------|--------------------| | agent_name | string | 实际调用的智能体名称 | | answer | string | 智能体的回答内容 |

示例：

{
  "agent_name": "客服助手",
  "answer": "您好，有什么可以帮助您的？"
}

环境变量

| 变量 | 说明 | 默认值 | |-----------------------|--------------------------------|-------------------------| | MAXKB_DOMAIN | MaxKB 服务地址 | <maxkb_domain> | | MAXKB_TOKEN | Bearer Token（管理员 API Key） | — | | MAXKB_WORKSPACE_ID | 工作空间 ID | default | | MAXKB_USERNAME | 登录用户名（优先于 TOKEN） | — | | MAXKB_PASSWORD | 登录密码（优先于 TOKEN） | — |