Skip to main content
POST
查询 A2A 智能体列表

限制说明

使用说明

  • 分页使用 offset/limit(而非 p/limit)。
  • scope=account 仅返回账户级智能体;scope=team 仅返回调用者可见团队中的智能体;默认 all 两者兼含,受 include_account 影响。
  • query 会在智能体名称、指令、卡片 URL、智能体 ID 以及解析得到的卡片名称中执行不区分大小写的子串搜索。
  • card_resolve_timeouttask_timeout 目前恒为 0 —— API 尚未提供设置方式。

授权

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 智能体列表的分页、范围与搜索过滤参数。

offset
integer
默认值:0

分页偏移量。

limit
integer
默认值:20

页面大小。

scope
enum<string>
默认值:all

可见范围:all(账户级加上调用者可见的团队)、account(仅账户级)或 team(调用者可见团队中的团队级记录)。

可用选项:
all,
account,
team
query
string

在智能体名称、指令、卡片 URL、智能体 ID 以及解析得到的卡片名称中进行不区分大小写的子串搜索。

Maximum string length: 128
team_ids
integer<int64>[]

限定在这些团队 ID 内;留空表示使用调用者可见的团队集合。

include_account
boolean | null

是否包含账户级(team_id=0)记录。默认为 true。

响应

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
object

分页的 A2A 智能体列表。