更新 A2A 智能体
对 A2A 智能体执行部分更新;省略字段表示不变。
限制说明
使用说明
- 任何字段变更前都需要对智能体当前所属团队具备编辑权限(
access.CanEdit)。 - 重新分配
team_id需要对目标团队的权限;若团队变更且未同时传入新的环境绑定,则现有 Runner 绑定必须对调用者仍可选,否则更新将被拒绝。 - 变更
auth_mode时会始终一并重写secret_schema;若变更auth_mode时未传入oauth_metadata,则将其清空。 - 对敏感的
auth_config键(api_key、token、client_secret)回传挖码值或空字符串将保留已存储的密钥,而不会覆盖。 - 每次调用都会记录到账户审计日志。
授权
App key issued from the Flashduty console. Required on every public API call. Keep it secret — it grants the same access as the owning account.
请求体
对 A2A 智能体执行部分更新。字段为 null 或省略时保持不变。
目标智能体 ID。
新的显示名称。省略则保持不变。
128新的指令。省略则保持不变。已弃用的 description 字段仍可传入,若两者同时传入则必须一致。
2000新的卡片 URL。省略则保持不变。
新的认证类型。省略则保持不变。
替换认证配置。省略则保持不变。对敏感键回传挖码值(或空字符串)将保留已存储的密钥而非覆盖。
切换流式支持。省略则保持不变。
重新分配团队范围。省略则保持不变。重新分配需要对目标团队的权限;若团队变更且未同时传入新的环境绑定,则现有 Runner 绑定必须对调用者仍可选,否则更新将被拒绝。
新的执行环境绑定:空字符串表示自动,byoc 表示指定 Runner。不接受 cloud。省略则保持不变。
新的 BYOC Runner ID。与 environment_kind=byoc 一同传入。省略则保持不变。
新的认证模式:shared、per_user_secret 或 per_user_oauth。变更时会一并重写 secret_schema。
新的 JSON 密钥 schema。
新的 JSON OAuth 元数据。若 auth_mode 变更但未传入此字段,将被清空。
切换该智能体的非回环 HTTP OAuth 发现开关。省略则保持不变。
切换该智能体的 TLS 证书验证跳过开关。省略则保持不变。
响应
Success
Standard response envelope used by every Flashduty public API. On success data contains the endpoint-specific payload and error is absent. On failure error is present and data is absent. request_id is always present and is also mirrored in the Flashcat-Request-Id response header.