Skip to main content
POST
更新 A2A 智能体

限制说明

使用说明

  • 任何字段变更前都需要对智能体当前所属团队具备编辑权限(access.CanEdit)。
  • 重新分配 team_id 需要对目标团队的权限;若团队变更且未同时传入新的环境绑定,则现有 Runner 绑定必须对调用者仍可选,否则更新将被拒绝。
  • 变更 auth_mode 时会始终一并重写 secret_schema;若变更 auth_mode 时未传入 oauth_metadata,则将其清空。
  • 对敏感的 auth_config 键(api_keytokenclient_secret)回传挖码值或空字符串将保留已存储的密钥,而不会覆盖。
  • 每次调用都会记录到账户审计日志。

授权

app_key
string
query
必填

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.

请求体

application/json

对 A2A 智能体执行部分更新。字段为 null 或省略时保持不变。

agent_id
string
必填

目标智能体 ID。

agent_name
string | null

新的显示名称。省略则保持不变。

Maximum string length: 128
instructions
string | null

新的指令。省略则保持不变。已弃用的 description 字段仍可传入,若两者同时传入则必须一致。

Maximum string length: 2000
card_url
string | null

新的卡片 URL。省略则保持不变。

auth_type
string | null

新的认证类型。省略则保持不变。

auth_config
object

替换认证配置。省略则保持不变。对敏感键回传挖码值(或空字符串)将保留已存储的密钥而非覆盖。

streaming
boolean | null

切换流式支持。省略则保持不变。

team_id
integer<int64> | null

重新分配团队范围。省略则保持不变。重新分配需要对目标团队的权限;若团队变更且未同时传入新的环境绑定,则现有 Runner 绑定必须对调用者仍可选,否则更新将被拒绝。

environment_kind
string | null

新的执行环境绑定:空字符串表示自动,byoc 表示指定 Runner。不接受 cloud。省略则保持不变。

environment_id
string | null

新的 BYOC Runner ID。与 environment_kind=byoc 一同传入。省略则保持不变。

auth_mode
string | null

新的认证模式:shared、per_user_secret 或 per_user_oauth。变更时会一并重写 secret_schema。

secret_schema
string | null

新的 JSON 密钥 schema。

oauth_metadata
string | null

新的 JSON OAuth 元数据。若 auth_mode 变更但未传入此字段,将被清空。

allow_insecure_oauth_http
boolean | null

切换该智能体的非回环 HTTP OAuth 发现开关。省略则保持不变。

allow_insecure_tls_skip_verify
boolean | null

切换该智能体的 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.

request_id
string
必填

Unique ID for this request. Mirrored in the Flashcat-Request-Id header. Include it when reporting issues.

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

Error payload inside the response envelope. Present only on non-2xx responses.

data
null

Always null on success.