Skip to main content
POST
创建 A2A 智能体

限制说明

使用说明

  • instructions 为必填项;已弃用的 description 字段仍保留以兼容旧客户端,若两者同时传入则必须与 instructions 完全一致。
  • card_url 必须是 host 非空的绝对 http/https URL(可达性由执行环境验证,此处不检查);auth_type 仅接受 noneapi_keybearer
  • environments 限定智能体可运行的环境:cloud 和/或 BYOC Runner 的环境 ID 列表;省略或为空表示所有环境,且每个 Runner 必须对调用者可见。
  • 创建到某个团队(team_id > 0)需要调用者真实属于该团队;只有账户 owner/admin 可以在账户级(team_id=0)创建。
  • 每次调用都会记录到账户审计日志。

授权

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

智能体显示名称。

Maximum string length: 128
instructions
string
必填

远程智能体的自然语言指令:Markdown 文档,可带 summary frontmatter,正文非空,最大 50 KiB(51200 字节)。必填 —— 已弃用的 description 字段仍保留以兼容旧客户端,若两者同时传入则必须与 instructions 完全一致。

Maximum string length: 51200
card_url
string
必填

远程智能体卡片的 URL。必须是 host 非空的绝对 httphttps URL;可达性由执行环境在运行时验证,创建时不检查。

auth_type
enum<string>

访问远程智能体的认证类型:none(省略时默认)、api_keybearer

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

认证配置键值,例如 API key 或 bearer token。键名疑似凭据(包含 KEY、SECRET、TOKEN、PASSWORD 等)的值在响应中会被脱敏。

streaming
boolean

远程智能体是否支持流式响应。

team_id
integer<int64>

团队范围:0 = 账户级;>0 = 团队。在账户级创建需要 owner/admin 角色;创建到某个团队需要真实属于该团队。

environments
string[]

该智能体可运行的执行环境:cloud 和/或 BYOC Runner 的环境 ID 列表。省略或为空表示所有环境。

auth_mode
string

认证模式:shared(默认)所有用户共享一份凭证;per_user_secret 需要 secret_schema.header_nameper_user_oauth 为每个用户单独进行 OAuth。

secret_schema
string

JSON 编码的密钥 schema,例如 {"header_name":"X-Api-Key"}auth_mode=per_user_secret 时必填。

oauth_metadata
string

JSON 编码的 OAuth 元数据;由 per_user_oauth 模式的 OAuth 发现流程填充。

allow_insecure_oauth_http
boolean

允许该智能体使用非回环的 HTTP OAuth 发现/元数据端点,而非强制 HTTPS。默认为 false。

allow_insecure_tls_skip_verify
boolean

连接到该智能体端点时跳过 TLS 证书验证(自签/私有证书)。默认为 false。

响应

成功

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
object

注册 A2A 智能体的结果。