← 返回
未分类

ADP排查问题

Diagnose OP/QBot conversation, workflow, Agent, API, RAG retrieval, knowledge base indexing, multimodal and file-dialog issues. Use when investigating OP后台, QBot, record_id, session_id, request_id, trace_id, cfg_version_id, reply_method, prompt_raw, knowledge_raw, workflow, RunNodes, Agent, handoff, tool_call, task_done, Galileo, Trace, 日志, API报错, 请求失败, QA未命中, 兜底, 样表或示例数据误答, chunk, segment, vector index, embedding, rerank, RRF, 文件解析, 图片问答, 图文检索, 实时文档问答. Start by classifying the app mode, then us
Diagnose OP/QBot conversation, workflow, Agent, API, RAG retrieval, knowledge base indexing, multimodal and file-dialog issues. Use when investigating OP后台, QBot, record_id, session_id, request_id, trace_id, cfg_version_id, reply_method, prompt_raw, knowledge_raw, workflow, RunNodes, Agent, handoff, tool_call, task_done, Galileo, Trace, 日志, API报错, 请求失败, QA未命中, 兜底, 样表或示例数据误答, chunk, segment, vector index, embedding, rerank, RRF, 文件解析, 图片问答, 图文检索, 实时文档问答. Start by classifying the app mode, then use OP structured data and Galileo runtime evidence to produce an evidence-based diagnosis card.
user_e6029055
未分类 community v1.0.1 2 版本 97561 Key: 无需
★ 1
Stars
📥 20
下载
💾 0
安装
2
版本
#latest

概述

OP Galileo Triage

用于 OP / QBot 对话链路排查的路由型 Skill。保持入口轻量:先判断路径,再按需读取对应流程文件和参考资料。

1) 核心原则

  1. 先判模式,再排查:先判断应用模式(标准模式 / 单工作流 / CLAW / Multi-Agent),未判定前不输出最终根因。
  2. 主链路固定:OP 结构化数据 -> Galileo runtime -> 结合分析。
  3. 准确充分利用 MCP:涉及外部证据时,按 references/mcp_utilization_playbook.md 先识别系统、读取工具描述、选择最小必要 MCP、交叉验证后再下结论。
  4. 默认从会话层看起:先看 Session / Steps / Agent,再下钻单条 Record 字段。
  5. 运行时证据优先:同一请求/同一 trace 下,OP 页面字段与运行时不一致时,以 Galileo trace/log/span 的真实入参出参为准;跨请求或未确认对应关系的 trace 只能作旁证。
  6. 接口报错单独处理:纯 API/request_id 报错,不要求 OP 五文件,直接走接口报错链路。
  7. 输出要有归属:明确归属层级(配置问题 / ADP 问题 / 第三方模型或外部依赖问题)。

2) 使用方式

先读取 references/workflows/triage-dispatcher.md 完成模式判定和路径选择;随后只读取当前路径需要的流程文件。references/workflows/ 下文件是普通 Markdown 工作流文档,不是独立或嵌套 Skill。

输出最终结论前,依据 references/workflows/anti-misdiagnosis-check.md 完成自检;需要对外同步、提单或复盘时,再读取 references/workflows/compose-triage-report.md

3) 路由索引

场景按需读取说明
---------
任意排查起点references/workflows/triage-dispatcher.md先判模式,再分流
OP 链接 / record_id / session_idreferences/workflows/query-record.md查询 OP 结构化数据后转 Galileo 复核
安灯工单 / ticket 链接references/workflows/collect-andon-evidence.md只提取排查线索,再回到 OP/Galileo 主链路
只有截图/现象/业务描述references/workflows/collect-minimal-evidence.md最小补料,不阻塞推进
已有 OP 字段(reply_method/prompt_raw 等)references/workflows/analyze-record-path.md做 Record/路径层归因
request_id / 接口报错 / 请求失败references/workflows/query-api-error.mdAPI 错误链路,按服务归属定位
知识库索引 / chunk / segment / 召回排序references/kb_vector_chunk_retrieval_runtime.md定位解析、入索引、embedding、VDB、rerank/RRF、passage 入模问题
图片问答 / 文件解析 / 图文检索 / 实时文档references/multimodal_file_dialog_runtime.md定位文件解析 SSE、多模态状态、图片理解、实时文档问答问题
只有 trace_id / Galileo 链接references/workflows/verify-with-galileo.md先做运行时复核,再回填 OP 层判断
用户要求汇报/提单/复盘references/workflows/compose-triage-report.md输出诊断卡/报告
历史导出五文件(补充证据)references/workflows/analyze-op-five-files.md仅作为补充证据,不是默认入口
需要实现级归因references/adp_implementation_map.mdreferences/runtime_code_path_matrix.md把 OP/Galileo 现象映射到 ADP 模块与代码路径
OP 字段互相矛盾references/op_field_lineage.md判断问题记录、答案记录、chat_prompt、pipeline、procedures 的字段血缘
标准模式 RAG 运行时问题references/rag_runtime_implementation.md排查 BasicSearch、Rewrite、KnowledgeSearch、IntentRecognize、DirectReply
工作流引擎运行时问题references/workflow_engine_runtime.md排查 Master/Executor、NodeTask/NodeResult、belongNodeID、结束节点输出
工作流配置/发布态问题references/workflow_config_publish_runtime.md排查草稿/发布态差异、引用关系、发布依赖、START/END 输入输出
Chat/SSE/网关入口问题references/chat_gateway_runtime.md排查 CreateSession、SSE connect、RecordTrace、OpenAI 风格 remote bot 网关
模型调用/无输出/慢响应问题references/model_gateway_runtime.md排查 ai-gateway 路由、限流、熔断、endpoint、LLM span、TTFT/TPOT
Agent 工具/Skill/沙箱问题references/agent_runtime_environment.md排查 tool_call、project_path、stdout/stderr、用户 Skill 目录
Agent 编排/task_done/Steps 问题references/agent_orchestration_runtime.md排查工具定义入模、思考上限、task_done、ReplyEvent、Step 上报
插件/MCP 工具调用问题references/plugin_gateway_runtime.md排查 OAuth、session、tools/call、配额、下游 MCP 转发
知识库文件/解析/索引问题references/kb_file_import_runtime.md排查 FileId、SaveDoc、文档解析、学习任务、Connector 导入
API 网关/身份/metadata 问题references/api_gateway_runtime.md排查 request_id、upstream_action、uin/sub_uin、metadata 映射
权限/401/403/资源鉴权问题references/platform_permission_runtime.md排查主账号/子账号、SpaceID、企业权限、角色、资源权限

4) 默认输出

默认输出一屏诊断卡,不展开长文:

  • 结论(发生在哪一层)
  • 状态(已定位 / 初步判断 / 待补证)
  • 归属(配置问题 / ADP 问题 / 第三方问题)
  • 2~3 条硬证据(字段或日志)
  • 下一步动作(可直接执行)

仅在提单、复盘或用户明确要求时展开完整报告。

5) 边界与禁区

  • 不走 OP Cookie/HTTP 抓取路径。
  • 不把知识库查询作为默认第一步。
  • 不只凭 knowledge_raw 下结论;必须结合 prompt_raw 与 Galileo runtime 证据。
  • 若模式未知且关键 ID 缺失,先做最小补料,不做武断根因判断。
  • 不写死特定运行环境的 Galileo 工具名;按当前环境可用的 Galileo 查询能力执行 trace/log/span 复核。
  • 不把 ADP 源码原文塞进回答或报告;只引用从实现中提炼出的字段来源、链路和排查矩阵。

6) 快速参考

  • 分流规则:references/workflows/triage-dispatcher.md
  • 反误判:references/workflows/anti-misdiagnosis-check.md
  • 输出模板:references/output_templates.md
  • MCP 利用:references/mcp_utilization_playbook.md(工具发现、参数确认、场景选择、交叉验证、证据格式)
  • 标准模式排查:references/standard_mode_main_flow.mdreferences/rag_runtime_implementation.md
  • 工作流排查:references/workflow_node_analysis.mdreferences/workflow_engine_runtime.mdreferences/workflow_config_publish_runtime.md(模式判定、Record 定路径、Steps 定节点、State/Status 字段兼容、Master/Executor、配置校验、发布依赖、条件分支、结束节点与最终 answer 比对、诊断卡模板)
  • ADP 工作流节点类型:references/adp_workflow_node_types.md(NodeType 1~19 对照、分组、字段与误判规则)
  • 知识库/RAG 检索:references/rag_query_rewrite_flow.mdreferences/rag_intent_flow.mdreferences/rag_doc_reply_flow.mdreferences/rag_reference_flow.md
  • 知识库向量索引 / chunk / 召回排序:references/kb_vector_chunk_retrieval_runtime.md(解析、segment、embedding、VDB、mixed retrieval、rerank/RRF、小找大、大 TopN 补召)
  • 多模态 / 文件对话:references/multimodal_file_dialog_runtime.md(文件解析 SSE、StreamSaveDoc、多模态 session、图片问答、图文检索、实时文档问答)
  • Chat/SSE/网关入口:references/chat_gateway_runtime.md
  • 模型调用:references/model_gateway_runtime.md
  • Agent:references/agent_runtime_environment.mdreferences/agent_orchestration_runtime.md
  • 插件/MCP 工具:references/plugin_gateway_runtime.md
  • 权限鉴权:references/platform_permission_runtime.md
  • 安灯线索提取:references/andon_evidence_extraction.md
  • Galileo 作战:references/galileo_playbook.md
  • API 报错映射:references/api-error-query/
  • ADP 实现级参考:references/adp_implementation_map.mdreferences/op_field_lineage.mdreferences/runtime_code_path_matrix.mdreferences/rag_runtime_implementation.mdreferences/workflow_engine_runtime.mdreferences/workflow_config_publish_runtime.mdreferences/chat_gateway_runtime.mdreferences/model_gateway_runtime.mdreferences/agent_runtime_environment.mdreferences/agent_orchestration_runtime.mdreferences/plugin_gateway_runtime.mdreferences/kb_file_import_runtime.mdreferences/api_gateway_runtime.mdreferences/platform_permission_runtime.mdreferences/kb_vector_chunk_retrieval_runtime.mdreferences/multimodal_file_dialog_runtime.md

版本历史

共 2 个版本

  • v1.0.1 Initial release 当前
    2026-06-05 14:07 安全 安全
  • v1.0.0 Initial release
    2026-06-05 11:10 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

ai-intelligence

Self-Improving + Proactive Agent

ivangdavila
自我反思+自我批评+自我学习+自组织记忆。智能体评估自身工作、发现错误并持续改进。
★ 1,353 📥 317,862
developer-tools

Github

steipete
使用 `gh` CLI 与 GitHub 交互,通过 `gh issue`、`gh pr`、`gh run` 和 `gh api` 管理议题、PR、CI 运行及高级查询。
★ 668 📥 323,917
security-compliance

Skill Vetter

spclaudehome
AI智能体技能安全预审工具。安装ClawdHub、GitHub等来源技能前,检查风险信号、权限范围及可疑模式。
★ 1,212 📥 266,298