cURL
curl --request GET 'https://api.brightalk.ai/agents?limit=20' \
--header "Authorization: Bearer $BRIGHTALK_API_KEY" \
--header "Brightalk-Version: 2026-07-16"const response = await fetch("https://api.brightalk.ai/agents?limit=20", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`,
"Brightalk-Version": "2026-07-16",
},
});
console.log(response.status, await response.json());import os
import requests
response = requests.request(
"GET",
"https://api.brightalk.ai/agents?limit=20",
headers={
"Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
"Brightalk-Version": "2026-07-16",
},
)
print(response.status_code, response.json()){
"data": [
{
"id": "agt_demo_001",
"name": "Renewal Assistant",
"description": "Handles renewal reminders.",
"language": "zh-Hant",
"availability": "available"
}
],
"next_cursor": "<string>"
}Agents
列出符合資格的 AI 語音代理
傳回組織擁有且目前符合對外 AI 撥號資格的代理。結果採用由新到舊的不透明游標分頁。每個回應都包含 Brightalk-Version 與 X-Request-Id；受到速率限制的回應還會提供實際套用之配額群組的計數器。
GET
/
agents
cURL
curl --request GET 'https://api.brightalk.ai/agents?limit=20' \
--header "Authorization: Bearer $BRIGHTALK_API_KEY" \
--header "Brightalk-Version: 2026-07-16"const response = await fetch("https://api.brightalk.ai/agents?limit=20", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.BRIGHTALK_API_KEY}`,
"Brightalk-Version": "2026-07-16",
},
});
console.log(response.status, await response.json());import os
import requests
response = requests.request(
"GET",
"https://api.brightalk.ai/agents?limit=20",
headers={
"Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
"Brightalk-Version": "2026-07-16",
},
)
print(response.status_code, response.json()){
"data": [
{
"id": "agt_demo_001",
"name": "Renewal Assistant",
"description": "Handles renewal reminders.",
"language": "zh-Hant",
"availability": "available"
}
],
"next_cursor": "<string>"
}授權
Use a server-side Brightalk API key in the Authorization header.
標頭
選擇以日期為基礎的 API 版本。省略時會使用組織固定的預設版本。
Allowed value:
"2026-07-16"由呼叫端產生且符合 [A-Za-z0-9._:-]{1,64} 的關聯值。無效值會被取代。
Maximum string length:
64Pattern:
^[A-Za-z0-9._:-]{1,64}$查詢參數
要傳回的資源數量。預設為 20，上限為 100。
必填範圍:
1 <= x <= 100前一頁傳回的不透明游標。
Required string length:
1 - 2048