SuperAPI AI 工具集

workspaces

部署与运维

查看项目

更新于 10-16 07:15

技能介绍

用途:列出 TrueFoundry 的工作区(workspace,部署目标)与集群(cluster,底层基础设施),帮助确定部署目标、检查集群连接状态、发现可用 GPU 类型与基础域名。

主要能力:1) 列出集群并展示名称、ID、连接状态;2) 按集群筛选列出工作区,展示名称与 FQN;3) 获取指定工作区或集群详情;4) 查询集群是否连接、addons、节点池以发现 GPU 类型;5) 查询集群基础域名,用于构造公开服务的合法主机名。

使用方式:优先使用 MCP 工具调用 tfy_clusters_list、tfy_workspaces_list;若 MCP 服务器未配置或工具缺失,回退到通过 tfy-api.sh 直连 API,需将 TFY_API_SH 设为该技能 scripts/tfy-api.sh 的完整路径。推荐流程为“先集群、后工作区”:先列出集群让用户选择,再按 cluster_id 过滤工作区;若只有一个集群可跳过选择。常用 API:GET /api/svc/v1/clusters、GET /api/svc/v1/workspaces、GET /api/svc/v1/workspaces/WORKSPACE_ID、GET /api/svc/v1/clusters/CLUSTER_ID、.../is-connected、.../get-addons。

关键字段:工作区的 fqn 即部署所需的 TFY_WORKSPACE_FQN。

适用场景:为部署查找工作区 FQN、检查基础设施状态、需要 GPU 资源前确认集群支持的 GPU 类型、以及需要公开暴露服务时获取基础域名。

限制:不要要求用户手动设置 TFY_CLUSTER_ID,应通过列表让用户选择;GPU 类型并非每个集群都支持,需先检查;使用无效主机名会导致部署失败。常见错误包括无工作区(可能集群无工作区或 API key 无权限)与权限被拒。含糊意图可参考 references/intent-clarification.md 的澄清模板。