SuperAPI AI 工具集

fix-agent-qa-ticket

智能体与模型

查看项目

更新于 10-15 21:37

技能介绍

用途:把一条 Agent Conversation Triage Ticket(agtqa_*,评审员针对 Architect/ConvAI 真实对话具体轮次提出的意见)转化为已验证、限定在分支内的修复。全程走原始 ConvAI REST API(主机 https://api.elevenlabs.io,请求头 xi-api-key),不直接改动 main,只在分支上暂存,合并由用户决定。

使用前提:需要用户提供 API key,以及工单 id(agtqa_...)或含该 id 的 URL;agent id、conversation id、分支等均从工单推导。仅限平台侧;除根因确为代码缺陷(少见,多数分诊发现是提示词/流程缺口)外,不编写仓库代码;若确为代码根因,应说明并移交,而非在平台侧猜测规避。

主要流程:1) 获取工单,得到 conversation_id、agent_id、qa_comment、工单评论、逐轮评论(含 turn_index)与状态;2) 获取对话,读取被标记轮次前后窗口的 transcript(role、message、tool_calls),找出导致问题轮次的具体工具调用、提示词缺口或缺失指令;3) 从 main 真实末端创建修复分支,需正确取得 main 分支的 HEAD 版本(most_recent_versions[0].id)作为 parent_version_id,name、description、parent_version_id 三者缺一会 422;4) 定位并修复根因,常见为流程缺指令、系统提示词或评估标准;5) 添加可复现工单场景的模拟测试;6) 轮询测试结果(后台轮询,不要前台空等),读取 condition_result.result 与 rationale.messages,失败则调整重跑;7) 在工单下评论根因、分支 id(注明未合并)、测试 id 与结果,并按仓库惯例署名;8) 汇报根因、未合并分支、测试结果及需用户复核的判断点。工单状态默认保持 open,除非用户明确要求关闭。

限制:编辑已有流程需先暂存草稿再提交(无直接 PATCH 提交);直接 PATCH .../procedures/{pid} 返回 405;新建流程会立即提交,不应据以就地“替换”已有流程。模拟测试只能删除后重建。mocking_strategy 仅 all/selected/none,all 会忽略覆盖项;依赖工具真实返回时须用 selected 并在 mocked_tool_ids 中逐一列出。chat_history 每项需 time_in_call_secs,且须以用户消息结尾。DOM 写工具即使在 selected 下也可能无法完全通过,属行为说明而非缺陷。其余细节资料未提供。