SuperAPI AI 工具集

truefoundry-access-tokens

部署与运维

查看项目

更新于 10-16 04:58

技能介绍

用途:管理 TrueFoundry 个人访问令牌(PAT),用于 API 认证和 CI/CD 流水线。适用场景为列出、创建或删除个人访问令牌。

前置检查:先运行 status 技能,确认 TFY_BASE_URL 与 TFY_API_KEY 已设置且有效。若用户尚无账号或 PAT,不应继续调用令牌 API,而应先让其运行 uv run tfy register,完成 CLI 要求的浏览器验证码或人机验证,验证邮箱,打开 CLI 返回的租户 URL,并在租户仪表板创建首个 PAT。直接使用 API 时,需将 TFY_API_SH 设置为该技能 scripts/tfy-api.sh 的完整路径。

列出令牌:可通过工具调用 tfy_access_tokens_list(),或直接 API 执行 $TFY_API_SH GET /api/svc/v1/personal-access-tokens,结果以表格展示名称、ID、创建时间、过期时间。令牌值不会展示,仅在创建时出现一次。

创建令牌:先询问令牌名称。工具调用为 tfy_access_tokens_create(payload={"name": "my-token"}),需人工批准;直接 API 为 $TFY_API_SH POST /api/svc/v1/personal-access-tokens '{"name":"my-token"}'。令牌值仅在创建响应中返回。默认只显示掩码预览(如前 4 位加后 4 位),仅在用户明确确认已准备好立即复制时才完整显示一次,且不得在摘要或后续消息中重复。之后若用户想再次查看,应让其新建令牌。

删除令牌:删除前需确认,此操作不可逆且会中断使用该令牌的集成。工具调用为 tfy_access_tokens_delete(id="TOKEN_ID"),需人工批准;直接 API 为 $TFY_API_SH DELETE /api/svc/v1/personal-access-tokens/TOKEN_ID。

安全策略:代理不得在自身响应中重复、存储或记录令牌值;不得展示已有令牌值,仅可在创建时一次性展示新令牌;需提醒用户立即保存到密码管理器、CI/CD 密钥库或 TrueFoundry 密钥组,切勿提交到 Git 或明文分享。

错误处理:权限不足、令牌不存在、名称重复、删除后仍有服务使用、令牌值无法再次获取等情况均有对应提示。可与其他技能组合用于 GitOps/CI/CD、状态检查与密钥管理。API 端点完整参考见 references/api-endpoints.md。