分頁列出 自訂 Agent
介面說明
請求說明
搜尋關鍵詞：通過
Q參數可以按 Agent 名稱進行模糊比對。可見度層級過濾：使用
Visibility參數可以根據可見度層級（如TENANT、PROJECT、USER）來過濾結果。分頁資訊：通過
MaxResults和NextToken參數實現分頁查詢，其中NextToken用於擷取下一頁的資料。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| MaxResults |
integer |
否 |
本次請求返回的最大條數。 |
20 |
| NextToken |
string |
否 |
分頁 Token。首次查詢不傳；後續查詢傳上一次返回的 |
12345 |
| Q |
string |
否 |
搜尋關鍵詞，按 Agent 名稱模糊比對。 |
analysis |
| Visibility |
array |
否 |
按可見度層級過濾，可傳多個。 |
- |
|
string |
否 |
可見度 |
TENANT |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回參數 |
||
| RequestId |
string |
請求 ID。 |
824F80BA-1778-5D8A-BAFF-668A4D9C4CC7 |
| PagingInfo |
object |
分頁資訊。 |
|
| TotalCount |
integer |
合格總條數。 |
100 |
| MaxResults |
integer |
本次返回的最大條數。 |
20 |
| NextToken |
string |
下一頁 Token，為空白表示已到末頁。 |
5 |
| Agents |
array<object> |
自訂 Agent 列表。 |
|
|
object |
Agent 列表 |
||
| Name |
string |
Agent 名稱。 |
my-agent |
| DisplayName |
string |
展示名稱。 |
我的助手 |
| Description |
string |
描述。 |
資料分析助手 |
| CreatorId |
string |
建立者 ID。 |
123456 |
| ModifierId |
string |
最近修改者 ID。 |
123456 |
| Visibility |
string |
可見度層級。 |
TENANT |
| GmtCreateTime |
string |
建立時間（毫秒時間戳記）。 |
1780555634000 |
| GmtModifiedTime |
string |
最近修改時間（毫秒時間戳記）。 |
1780555634000 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "824F80BA-1778-5D8A-BAFF-668A4D9C4CC7",
"PagingInfo": {
"TotalCount": 100,
"MaxResults": 20,
"NextToken": "5",
"Agents": [
{
"Name": "my-agent",
"DisplayName": "我的助手",
"Description": "資料分析助手",
"CreatorId": "123456",
"ModifierId": "123456",
"Visibility": "TENANT",
"GmtCreateTime": "1780555634000",
"GmtModifiedTime": "1780555634000"
}
]
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。