SuperAPI AI 工具集

iblai-api-agent-support

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:通过 ibl.ai 平台 API 管理某个智能体的人工支持工单,包括列出与筛选工单、读取回复线程、以支持团队身份回复、推进工单生命周期、关闭或删除工单。适用于分诊或回复从智能体会话升级的支持请求。

认证与约定:基础地址为 https://api.iblai.app,每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量 {org}=$IBLAI_ORG、{username}=$IBLAI_USERNAME、{mentor}=智能体唯一 id。所有路由前缀为 https://api.iblai.app/dm/api/ai-mentor/orgs/{org}/users/{username}。未连接时先运行 /iblai-api-login 填充环境变量。DELETE 为破坏性操作,需先与用户确认。

概念:工单由智能体开启,本 API 无创建端点;用户在会话中请求人工帮助时,智能体的人工支持工具会生成 HumanSupportTicket,请求者字段与会话由服务端解析,subject 与 description 由智能体撰写(description 常为 HTML 或 Markdown)。可见性:组织管理员可见全部工单,其他用户仅见自己提交的。生命周期:open → in_progress → closed,专用 close/ 端点会同时设置状态并记录 resolved_at。每条工单有 TicketMessage 回复,sender 为作者数字用户 id,null 表示系统消息。前提:智能体需启用人工支持工具,可用 /iblai-api-agent-tool 切换。

读取:GET {u}/support-tickets/ 支持 mentor_id、status、username、session、page、page_size 筛选;GET {u}/support-tickets/{id}/ 获取单条;GET {u}/support-ticket-messages/ 支持 ticket、sender、page、page_size;GET {u}/support-ticket-messages/{id}/ 获取单条消息。

写入:PUT/PATCH {u}/support-tickets/{id}/ 编辑工单字段(subject 必填且不超过 255 字符、description 必填、status);POST {u}/support-tickets/{id}/close/ 关闭工单;DELETE {u}/support-tickets/{id}/ 删除工单。消息方面:POST {u}/support-ticket-messages/ 回复(ticket 必填、message 必填、sender 可选);PUT/PATCH/DELETE {u}/support-ticket-messages/{id}/ 编辑或删除消息。

限制:无工单创建端点,工单仅来自智能体会话;mentor_id 按智能体唯一 id 而非名称筛选;description 常为完整 HTML 文档或 Markdown,不应假定为纯文本;列表返回 DRF 分页信封,需遍历 results;DELETE 返回 204;用 close/ 关闭才会记录 resolved_at,直接 PATCH 为 closed 不会记录解决时间戳。