iblai-agent-chat

用途

iblai-agent-chat 用于与已部署的 ibl.ai 智能体进行实时聊天。与其他 iblai-* 技能（直接调用 REST API）不同，运行时聊天——包括流式响应、工具使用、RAG——由托管的 iblai-agent-chat MCP 服务器提供。该技能完成一次性接线，使你的助手能够与智能体对话；对话本身随后通过该服务器的 MCP 工具运行。

何时使用

当你想要与智能体对话（而非配置它）时使用。若要配置智能体，请使用其他 /iblai-agent-* 技能；若要查找智能体的 unique_id，请使用 /iblai-search。

所需条件

IBLAI_API_KEY —— 你的平台 API Token（来自 .env；若未设置，请运行 /iblai-login）。
智能体的 unique_id —— 要对话的智能体。可从 /iblai-search 获取（每个结果的 unique_id），然后与用户确认选择。

设置

服务器通过两个请求头进行认证：Authorization: Api-Token <key> 和 X-Mentor-Unique-Id: <unique_id>（每个连接一个智能体）。

Claude Code

claude mcp add iblai-agent-chat \
  --transport http https://asgi.data.iblai.app/mcp/agent-chat/ \
  --header "Authorization: Api-Token $IBLAI_API_KEY" \
  --header "X-Mentor-Unique-Id: $MENTOR"

.mcp.json / Claude Desktop / Cursor

添加到项目的 .mcp.json（或客户端的 MCP 配置）。替换为真实的 token 和 unique_id —— 不要提交密钥：

{
  "mcpServers": {
    "iblai-agent-chat": {
      "transport": "streamable-http",
      "url": "https://asgi.data.iblai.app/mcp/agent-chat/",
      "headers": {
        "Authorization": "Api-Token YOUR_API_TOKEN",
        "X-Mentor-Unique-Id": "YOUR_MENTOR_UNIQUE_ID"
      }
    }
  }
}

添加后，助手将获得该服务器的聊天工具——使用这些工具发送消息并接收智能体的流式回复。

注意事项

每个连接一个智能体 —— X-Mentor-Unique-Id 在每个服务器条目中是固定的。要与多个智能体对话，请添加多个命名条目（例如 iblai-agent-chat-tutor、iblai-agent-chat-advisor），每个都有自己的 unique_id。
Token 存放在客户端配置 / .env 中 —— 切勿提交；.env 和本地 MCP 配置应保持被 gitignore 忽略。
这是 iblai/api 中唯一的运行时接口；其他所有内容（configure、search、recommend、profile、analytics、admin）都是直接 REST 技能。