用途:列出 TrueFoundry 工作区与集群,帮助确认部署目标、集群连通性、可用 GPU 类型与基础域名。工作区是部署目标,集群是底层基础设施。
主要能力:支持查询工作区列表、按集群过滤工作区、查询单个工作区、查询集群详情与连通状态、集群插件(addons),以及发现工作区或集群支持的 GPU 类型和集群基础域名。
使用方式:简单读取/列出操作优先使用 MCP 工具 tfy_clusters_list 和 tfy_workspaces_list;若 MCP 未配置或工具缺失,则回退到直接 API,通过 $TFY_API_SH 调用,如 $TFY_API_SH GET /api/svc/v1/clusters、/api/svc/v1/workspaces、/api/svc/v1/workspaces/WORKSPACE_ID。推荐流程为先列集群让用户选择,再按 cluster_id 过滤工作区,避免手动设置 TFY_CLUSTER_ID。若用户只有一个集群,可跳过集群选择直接列工作区。工作区关键字段 fqn 用于部署时的 TFY_WORKSPACE_FQN;公开服务需使用集群基础域名构造主机名,否则部署可能失败;使用 GPU 前应先发现可用类型。
适用场景:部署前确定工作区 FQN、检查集群连通与基础设施、发现 GPU 资源、构造公开访问 URL。
限制:可能需要 API key 权限;未找到工作区时需检查集群是否有工作区或权限是否足够;GPU 类型并非每个集群都可用,需先检查。完整 GPU 参考表与 SDK 示例见 references/gpu-reference.md,集群发现细节见 references/cluster-discovery.md,意图澄清模板见 references/intent-clarification.md。