用途:通过 ibl.ai 平台 API 管理某个智能体的人工支持工单,适合对从智能体对话升级而来的支持请求进行分诊与回复。
主要能力:列出并筛选工单(可按智能体、请求者、状态、会话过滤,支持分页);读取单张工单;读取工单的回复线程与单条消息;以支持团队身份回复工单;编辑工单字段与消息;推进工单生命周期(open → in_progress → closed);关闭或删除工单。
使用方式:基础地址为 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 填充环境变量。工单由智能体在对话中开启,本 API 没有创建工单的 POST 端点;回复用 POST {u}/support-ticket-messages/,关闭用 POST {u}/support-tickets/{id}/close/(会写入 resolved_at),删除用 DELETE(破坏性,需先与用户确认)。列表读取返回 DRF 分页信封,需遍历 results;DELETE 返回 204。
适用场景:组织管理员查看本组织全部工单,其他用户仅能看到自己提交的工单;按智能体或请求者筛选工单;加载某张工单的对话线程并按时间升序排序,通过 sender 区分请求者与支持团队回复。
限制:工单只能来自智能体对话,无法通过本 API 创建;智能体仅在启用人工支持工具时才会提供升级入口,可用 /iblai-api-agent-tool 切换;mentor_id 按智能体唯一 id 而非名称过滤;description 由智能体生成,常为 HTML 或 Markdown,不应假定为纯文本;普通 PATCH 将状态改为 closed 不会写入 resolved_at。