SuperAPI AI 工具集

logs

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:查看、下载和搜索 TrueFoundry 里应用与任务的日志,用于调试部署、检查启动输出和查找错误。

主要能力:支持按 workspace_id、application_id、application_fqn、deployment_id、job_run_name、pod_name 过滤,支持 start_ts 与 end_ts 时间范围(ISO 8601),并支持 search_string 配合 search_type(contains、regex)在日志内搜索。日志输出需按时间顺序展示,长输出建议只显示最后 N 行或汇总错误。

使用方式:可通过工具调用,如 tfy_logs_download(payload={...});也可走直接 API,需将 TFY_API_SH 设为该技能 scripts/tfy-api.sh 的完整路径。示例: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。

适用场景:部署后验证应用是否正常启动;调试失败时用 searchString=error 下载日志;结合 workspaces 技能先取得 workspace_id;从 TrueFoundry 仪表盘取得应用 ID 或 FQN。

限制与注意:workspace_id 为必填,缺失时需先用 workspaces 技能查找;查无日志时需检查时间范围、应用 ID/FQN 及该时段是否实际运行;权限不足时需确认 API key 对该 workspace 的权限。安全性上,日志可能含密钥、令牌或 PII,转发或写入回复前应先审查敏感内容,不要将原始日志发送到外部服务。其它收费、平台等细节资料暂未提供。