SuperAPI AI 工具集

debugger

编程与开发

查看项目

更新于 10-15 23:44

技能介绍

用途:作为 Keboola Python 组件的专家调试智能体,快速定位组件失败的根本原因,并给出可执行的修复方案,使组件恢复正常运行。

主要能力:

  1. 上下文收集:了解用户看到的错误(错误信息、job ID、堆栈)、失败的组件与配置、失败起始时间及近期变更(代码、配置、数据)。
  2. 工具调用:Keboola MCP Server(可用时)提供 list_jobs 查找失败任务、get_job 获取任务详情与错误、get_config 检查配置、query_data 校验输出数据、run_job 修复后重跑;文件系统工具用于阅读组件代码(src/component.py、src/configuration.py)、配置模式(component_config/configSchema.json)、测试用例(tests/)及日志;命令行用于本地运行与测试。
  3. 根因归类:配置问题(参数缺失或无效、凭据或 API token 错误、输入输出映射错误)、代码缺陷(未处理异常、类型错误、数据处理逻辑错误)、数据问题(格式异常、必填字段缺失、编码问题如 UTF-8 与空字符)、环境问题(依赖缺失、Python 版本不兼容、文件权限)、API 问题(限流、认证失败、端点变更)。
  4. 输出修复:给出根因、具体修复步骤(代码或配置改动)与验证方式。

使用方式:

  • 失败任务排查:用 mcp__keboola__get_job 传 job_id 获取错误与退出码;用 mcp__keboola__get_config 传 component_id 与 config_id 校验参数;阅读报错位置附近代码;用 mcp__keboola__run_job 验证修复。
  • 本地调试:创建 data/config.json 测试参数,执行 mkdir -p data/in/tables data/out/tables,运行 KBC_DATADIR=data uv run src/component.py,检查 data/out/tables/ 与 data/out/state.json,并查看控制台日志。
  • 依赖与测试:uv sync 检查依赖,uv run pytest 运行测试。

退出码约定:退出码 1 表示用户错误(配置、输入、校验失败);退出码 2 表示系统错误(未捕获异常、编程错误、外部 API 失败)。

常见问题与修复:TypeError 类型不匹配时补充类型提示与校验;KeyError 用 .get() 提供默认值;UnicodeDecodeError 读取文件时指定 encoding="utf-8";CSV 空字符在读取时过滤;未捕获异常用 try/except 区分用户错误与系统错误并分别以 1 或 2 退出。

输出格式:按“问题识别、受影响代码(位置与问题)、建议修复、验证步骤”组织结果。

限制:资料未提供该智能体的收费、价格、平台支持范围与效果数据;其能力依赖 Keboola MCP 工具、Datadog 日志与本地环境的可用性。