SuperAPI AI 工具集

truefoundry-logs

部署与运维

查看项目

更新于 10-16 07:15

技能介绍

用途:该技能用于查看、下载和搜索 TrueFoundry 中的应用(application)与任务(job)日志,适合调试部署、检查启动输出和查找错误。

主要能力:支持按工作区、应用 ID、应用 FQN、部署 ID、任务运行名称、Pod 名称过滤;支持 start_ts 与 end_ts 时间范围(ISO 8601);支持 search_string 配合 search_type(contains、regex)在日志中搜索。

使用方式:可通过工具调用执行 tfy_logs_download(payload={...}),传入 workspace_id、application_fqn、start_ts、end_ts 等参数;也可通过直接 API 调用。使用直接 API 时,需将 TFY_API_SH 设为该技能 scripts/tfy-api.sh 的完整路径(不同 agent 的路径见 references/tfy-api-setup.md),示例:TFY_API_SH=~/.claude/skills/truefoundry-logs/scripts/tfy-api.sh,然后执行 $TFY_API_SH GET '/api/svc/v1/logs/WORKSPACE_ID/download?applicationFqn=APP_FQN&startTs=START&endTs=END',带搜索过滤时可用 applicationId、searchString=error、searchType=contains 等查询参数。

展示方式:按时间顺序展示日志;输出较长时显示最后 N 行或汇总错误。

限制与注意:日志可能含敏感数据(密钥、令牌、PII),未经检查不要转发原始日志或放入响应;workspace_id 为必填,缺失时需先用 workspaces 技能获取;无日志时需检查时间范围、应用 ID/FQN 是否正确以及应用是否在该时段运行;权限不足时需检查 API key 对该工作区的权限。其他细节暂未提供。