跳转到主要内容
POST
/
safari
/
a2a-agent
/
update
更新 A2A 智能体
curl --request POST \
  --url 'https://api.flashcat.cloud/safari/a2a-agent/update?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "agent_id": "a2a_6mWqZ2pK9nLcR3tY8uVb4D",
  "description": "Inspects deployment pipelines and proposes rollbacks."
}
'
{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "data": null
}

​
限制说明

项目说明
速率限制每个 app_key 1,000 次/分钟；50 次/秒
权限要求Agent 管理（ai-sre）

​
使用说明

  • 每次调用都会记录到账户审计日志。

授权

​
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 智能体的部分更新；为空或省略的字段保持不变。

​
agent_id
string
必填

目标智能体 ID。

​
agent_name
string | null

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

Maximum string length: 128
​
description
string | null

新的描述。省略则不变。

Maximum string length: 2000
​
card_url
string | null

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

​
auth_type
string | null

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

​
auth_config
object

替换认证配置。省略则不变。

​
streaming
boolean | null

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

​
team_id
integer<int64> | null

重新分配团队范围。省略则不变。

​
auth_mode
string | null

新的认证模式：shared、per_user_secret 或 per_user_oauth。

​
secret_schema
string | null

新的 JSON 密钥 schema。

​
oauth_metadata
string | null

新的 JSON OAuth 元数据。

响应

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

成功时恒为 null。