用途:浏览 TrueFoundry 的 ML 仓库和模型注册表,列出 ML 仓库、查看仓库详情、列出仓库内的模型与制品,并获取可供其它技能(prompts、llm-deploy)使用的 FQN。
主要能力:列出全部 ML 仓库并输出 Name/ID/FQN 表格;按 ID 获取仓库详情;按 ml_repo_id、name 或 fqn 过滤列出模型,展示名称、ID、FQN 与版本数。
使用方式:先运行 status 技能验证 TFY_BASE_URL 和 TFY_API_KEY 是否设置且有效。可直接调用工具:tfy_ml_repos_list()、tfy_ml_repos_get(id="REPO_ID")、tfy_models_list(ml_repo_id="REPO_ID")。也可走直接 API,需将 TFY_API_SH 设为该技能 scripts/tfy-api.sh 的完整路径,例如 TFY_API_SH=~/.claude/skills/truefoundry-ml-repos/scripts/tfy-api.sh,然后执行 $TFY_API_SH GET /api/ml/v1/ml-repos;获取仓库详情用 $TFY_API_SH GET /api/ml/v1/ml-repos/REPO_ID;列出模型用 $TFY_API_SH GET "/api/ml/v1/models?ml_repo_id=REPO_ID",也可按 name 或 fqn 查询,如 $TFY_API_SH GET "/api/ml/v1/models?fqn=model:my-models:my-model"。
适用场景:需要了解已有 ML 仓库与模型清单;为创建提示词准备 ML 仓库 FQN;查看微调输出保存到的 ML 仓库;从注册表选取模型交给 llm-deploy 部署。
限制与错误处理:仓库 ID 不存在时需先列出仓库找到正确 ID;仓库无模型时提示尚无模型,模型需经 SDK 记录制品或微调后出现;权限不足时检查 API key 权限;结果为空表示没有 ML 仓库,可通过 TrueFoundry UI 或 SDK 创建,示例:import truefoundry as tfy; client = tfy.TrueFoundryClient(); client.create_ml_repo(name="my-repo")。更多接口见 references/api-endpoints.md,歧义意图可使用 references/intent-clarification.md 的澄清模板。