用途:列出、检查和管理 TrueFoundry 上的应用及其部署历史,查看服务、作业等资源的状态、健康与详情。适用于用户想查看已部署应用、按工作空间或名称筛选、确认部署是否完成或失败、查询部署详情,以及用 API manifest 为预构建镜像创建部署的场景。
主要能力:简单读取/列表操作优先调用 MCP 工具 tfy_applications_list 与 tfy_applications_list_deployments;工具不可用时回退到 tfy-api.sh 直连 API。支持按 workspace_fqn、application_name、cluster_id、application_type、name_search_query 过滤,可按 ID 查询应用。可列出某应用的部署、同步应用状态、提升指定部署为活跃版本、以相同配置重新部署,以及用 PUT /api/svc/v1/apps 创建部署(manifest 含 kind、name、image、ports、resources、env、replicas、workspaceId 等)。状态监控通过 deployment.currentStatus.status/transition 及 state.isTerminalState 判断,建议轮询 15-30 秒直至 isTerminalState 为 true。
使用方式:配置 MCP 后直接用工具调用;否则设置 TFY_API_SH 指向 scripts/tfy-api.sh,再用 GET/POST/PUT 调用相应接口。列表结果以表格呈现,用 updatedAt 作为最后部署时间。
限制:删除应用不支持 CLI、API 或任何代理工具,必须在 TrueFoundry 仪表盘的 Deployments 中选择工作空间,点击应用卡片三点菜单删除,且不可逆。不要在 manifest 中内联密钥,敏感环境变量应使用 tfy-secret:// 引用。部署本地代码应改用 deploy skill,工作空间/集群信息改用 workspaces skill,作业明细用 jobs skill。通过工具创建部署需人工审批。expose 为 true 时 host 必须匹配集群 base_domain,否则会报错。