用途:把当前 AI 智能体会话整理成 Markdown 缺陷报告,供 watsonx.data integration 技能作者排查智能体在创建、运行或管理集成流程时出现的问题。该技能不绑定特定 AI 运行时、模型或会话文件结构。
触发方式:手动时用户明确要求报告缺陷,直接执行无需确认;自动时仅在循环检测规则命中后由智能体提议,且每会话最多一次,必须等待用户明确回复后才执行,用户拒绝或忽略则不写文件。
循环检测规则:每次工具调用后维护滚动调用日志。当同一工具或同一有序工具序列在单轮中连续 3 次及以上调用,且每次产生相同错误、相同失败状态或输出无实质变化时,立即停止,不再做第 4 次尝试,并提议生成报告。输入或参数有实质差异、工具返回空但成功的情况不触发。
会话判定:技能名以 di-agent- 开头、调用 Agentic Data Integration MCP 服务器工具(如 mcp__ibm-agentic-data-integration__*),或用户要求创建/编辑/运行/调试 watsonx.data integration 流程或作业,均视为相关会话;否则打印一行跳过信息并停止。
参数:--name <filename> 可选,覆盖输出文件名,仅取基名,写入 agent/bug_reports/ 下,缺失时自动追加 .md,拒绝路径分隔符和 ..。
不变式:写入前对所有用户文本、助手文本、转录条目和错误字符串做 PII 脱敏,但不脱敏技能名、工具名、错误信息、模式/列名、用户 id、项目 id、资产 id、流程 id、作业 id 或公开数据集名。每次调用只写一个文件,默认路径为 ibm-watsonx-data-integration-agent-skills/agent/bug_reports/watsonx_di_agent_bug_report_<YYYY-MM-DD><HH-MM-SS><session_name>.md,目标已存在时先询问是否覆盖。以实际对话为唯一事实来源。
工作流:解析会话元数据(日期时间、会话名 slug、会话 id、get_session_info 输出、LLM 名称版本);按时间顺序构建统一编号的转录;调用 get_job_run_logs 和 retrieve_datastage_flow_code 等诊断工具收集深层信号;对会话结果分类为成功、空结果成功、预期零输出成功或失败,描述限 5–6 句;按固定模板写文件,首行为 # IBM watsonx.data integration Agent Bug Report,章节顺序为 Session Info、Description、Transcript,仅用 # 和 ## 两级标题,不使用水平分隔线;最后向用户打印绝对路径、结果和转录条目数。
限制:资料未提供具体安装命令、收费方式或平台支持信息。