用途:引导新用户从零完成 TrueFoundry 环境搭建,包括账号注册、邮箱验证、凭据配置和首次成功 API 调用。适用于尚无账号、说“get started/set up/register/onboard”、缺少 TFY_BASE_URL 与 TFY_API_KEY,或询问如何创建账号与获取 API Key 的场景;已有凭据查状态、管理令牌、部署、列出工作区等应改用对应技能。
主要能力与用法:先检测当前状态,运行 echo "TFY_BASE_URL: ${TFY_BASE_URL:-(not set)}" 等命令检查环境变量与 .env。若无账号,运行 tfy register(未安装可用 uv run --from truefoundry tfy register),该命令为交互式向导,需用户手动完成租户名、工作邮箱、密码、用途、条款确认、人机验证与邮箱验证,不可自动化或绕过。注册后获得租户 URL,并在 Settings → Access → Personal Access Tokens → Generate New Token 创建 PAT。
凭据配置支持环境变量 export TFY_BASE_URL="https://your-org.truefoundry.cloud"、export TFY_API_KEY="tfy-..."、export TFY_HOST="${TFY_BASE_URL}",或写入 .env 文件;切勿将含密钥的 .env 提交到 Git。CLI 可选,安装命令为 pip install 'truefoundry==0.5.0',使用 CLI 时需同时设置 TFY_HOST。最后用 scripts/tfy-api.sh GET '/api/svc/v1/workspaces?limit=1' 验证连接。
限制:注册需人工完成验证步骤;连接失败、401、邮箱未收到等需按错误处理排查,必要时联系 support@truefoundry.com。后续可衔接 status、access-tokens、deploy、workspaces 等技能。