用途：直接驱动已部署 ibl.ai 智能体的聊天传输层，并读取其会话记录。与封装 MCP 服务器的 /iblai-api-agent-chat 不同，本技能暴露原始 REST/SSE 与 WebSocket 接口。
认证与约定：每个请求带 Authorization: Api-Token $IBLAI_API_KEY；路径变量 {org}=$IBLAI_ORG、{user}=$IBLAI_USERNAME。聊天走 https://asgi.data.iblai.app，会话读写走 https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{user}/v1。未连接时先运行 /iblai-api-login。
主要能力：发送聊天轮次（POST /api/agent/chat/，SSE 流式；WebSocket 为 wss://asgi.data.iblai.app/ws/chat/），请求体含 session_id、flow（name 为智能体 unique_id，tenant 为组织 key）、prompt、page_content、metadata、document_filter。metadata 为软上下文，会拼入提示并持久化为会话的 client_context，逐轮覆盖；document_filter 为硬检索范围，按文档 custom_metadata 做包含式逐键过滤，仅作用于当轮且不持久化。读取接口可列出会话、查看分页消息（含 client_context）、导出聊天历史（?to_csv=true 时列为 type,content,timestamp,client_context）。
限制：session_id 与 flow 每轮必填，flow.name 须解析到已部署智能体。document_filter 键须为扁平字母数字/下划线，值为标量，匹配区分大小写与类型，多键为 AND；过滤只缩小候选集，top-k 排序仍会执行，合格文档不保证被检索到。metadata 不限制检索，document_filter 不进入提示。历史导出任务的启动与轮询由 /iblai-api-agent-history 负责，分析回显见 /iblai-api-analytics。