SuperAPI AI 工具集

truefoundry-access-tokens

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:该技能用于管理 TrueFoundry 个人访问令牌(PAT),覆盖 API 认证、CI/CD 流水线以及 AI Gateway 访问等场景,可列出、创建和删除令牌。

主要能力:调用工具 tfy_access_tokens_list() 列出令牌;调用 tfy_access_tokens_create(payload={"name": "my-token"}) 创建令牌(需人工审批 HITL);调用 tfy_access_tokens_delete(id="TOKEN_ID") 删除令牌(需人工审批)。也可通过直接 API 完成同样操作,例如先设置 TFY_API_SH=~/.claude/skills/truefoundry-access-tokens/scripts/tfy-api.sh,再执行 $TFY_API_SH GET /api/svc/v1/personal-access-tokens 列出,$TFY_API_SH POST /api/svc/v1/personal-access-tokens '{"name":"my-token"}' 创建,或 $TFY_API_SH DELETE /api/svc/v1/personal-access-tokens/TOKEN_ID 删除。

必要用法与安全策略:操作前需先运行 status 技能,确认 TFY_BASE_URL 与 TFY_API_KEY 已设置且有效。若尚无账号或 PAT,则不应继续调用令牌 API,需先运行 uv run tfy register,完成浏览器验证、邮箱验证,打开 CLI 返回的租户 URL,并在租户仪表盘创建首个 PAT。代理不得重复、存储或记录令牌值;创建后仅引导用户从 API 响应中复制,默认只显示掩码预览(如首 4 位与末 4 位),仅在用户明确确认可以立即复制时一次性显示完整令牌,且不得在摘要或后续消息中再次出现。删除前必须确认,因为不可逆。

适用场景与限制:适用于为 CI/CD 自动部署、AI Gateway 请求认证以及将 PAT 存储为密钥等场景。令牌值仅在创建时返回,之后无法再次获取;如遗失需删除旧令牌并新建。删除令牌会导致使用它的服务或流水线失败。若权限不足、令牌 ID 不存在、名称重复等会返回相应错误。令牌仅在创建时显示一次,需保存到密码管理器、CI/CD 密钥库或 TrueFoundry 密钥组,切勿提交到 Git 或明文共享。可组合使用 status 技能验证 PAT 是否有效,secrets 技能存储 PAT 用于部署。完整 API 参考见 references/api-endpoints.md。