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,取自 POST /safari/a2a-agent/list 返回的列表。

agent_name
string | null

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

Maximum string length: 128
instructions
string | null

新的指令文档(约定同创建:可带 summary frontmatter,正文非空,最大 50 KiB)。省略则保持不变。已弃用的 description 字段仍可传入,若两者同时传入则必须一致。

Maximum string length: 51200
card_url
string | null

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

auth_type
enum<string> | null

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

可用选项:
none,
api_key,
bearer
auth_config
object

整体替换认证配置;省略则保持不变。未包含在 map 中的键会被删除。敏感键回传掩码值时保留已存储的密钥,传空字符串则清除该密钥。

streaming
boolean | null

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

team_id
integer<int64> | null

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

environments
string[] | null

该智能体可运行的执行环境:cloud 和/或 BYOC Runner 的环境 ID 列表。省略(null)表示保持不变;传入列表即整体设置——空列表表示清除限制、恢复为所有环境。

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 证书验证跳过开关。省略则保持不变。

响应

成功

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
必填

本次请求的唯一 ID,与 Flashcat-Request-Id 响应头一致。反馈问题时请携带该 ID。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

error
object

响应结构中的错误 payload,仅在非 2xx 响应时出现。

data
null

Always null on success.