用途：在 TrueFoundry Agent Registry 中管理 AI 智能体，包括列出与查看智能体详情、创建或更新智能体定义、配置协作者访问权限，以及删除智能体。
主要能力：支持列出全部智能体或按 ID 查询单个智能体；创建/更新为 upsert 操作（存在则更新）；可设置 manifest 字段，包括 name、type（必须为 agent）、description、source（当前仅支持 prompt 类型，需填 prompt_version_fqn）、collaborators 和 sample_inputs。协作者角色有 agent-manager（可编辑删除）和 agent-access（可使用调用），主体格式为 user:email@example.com 或 team:team-name。
使用方式：先运行 status 技能校验 TFY_BASE_URL 与 TFY_API_KEY。该技能没有 CLI 支持，全部操作走 Direct API，需将 TFY_API_SH 设为该技能 scripts/tfy-api.sh 的完整路径。常用操作：GET /api/svc/v1/agents 列出；GET /api/svc/v1/agents/{id} 查看单个；PUT /api/svc/v1/agents 创建或更新；DELETE /api/svc/v1/agents/{id} 删除。创建与删除通过工具调用时需人工审批（HITL）。删除不可逆，需先确认。创建前需先通过 prompts 技能获取正确的 prompt_version_fqn。
适用场景：管理 TrueFoundry 中智能体的全生命周期与访问授权。
限制与不适用：用户想直接管理 prompt 应使用 prompts 技能；部署服务需 TrueFoundry Enterprise 账号与已连接集群；配置 AI Gateway 路由用 ai-gateway 技能；管理访问控制角色用 access-control 技能。常见错误包括 agent 不存在、prompt_version_fqn 无效、权限不足、协作者主体格式错误、名称重复以及缺少必填字段（至少需 name、type 和含 prompt_version_fqn 的 source）。