用途:本技能用于与已部署的 ibl.ai 智能体进行实时对话。与其他 iblai-* 技能不同(它们直接调用 REST API),运行时聊天(流式响应、工具使用、RAG)由托管的 iblai-api-agent-chat MCP 服务器提供。本技能负责一次性接入配置,之后的会话通过该服务器的 MCP 工具运行。
适用场景:想与智能体对话(而非配置它)时使用。配置智能体请用其他 /iblai-api-agent-* 技能;查找智能体的 unique_id 请用 /iblai-api-search。
前置条件:IBLAI_API_KEY(平台 API Token,来自 .env;若未设置可运行 /iblai-api-login);以及要对话的智能体的 unique_id(可通过 /iblai-api-search 的每条结果获取),并与用户确认选择。
配置方式:服务器通过两个请求头认证:Authorization: Api-Token <key> 与 X-Mentor-Unique-Id: <unique_id>(每个连接对应一个智能体)。
Claude Code:
claude mcp add iblai-api-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-api-agent-chat-tutor、iblai-api-agent-chat-advisor),各自使用自己的 unique_id。Token 存放在客户端配置或 .env 中,切勿提交;.env 与本地 MCP 配置应保持 gitignore。此技能是 iblai-api-* 技能中唯一的运行时界面,其余功能(配置、搜索、推荐、档案、分析、管理)均通过直接 REST 调用。价格、平台支持等更详细信息暂未提供。