查詢目前使用者名下的Agent列表及用量匯總資訊。
介面說明
請求說明
分頁支援:通過
NextToken和MaxResults參數實現分頁,首次請求時NextToken應為空白字串。過濾條件:可以使用
AgentType和AgentIds參數來過濾返回的 Agent 列表。狀態過濾:通過
Status參數(0-已刪除,1-生效中)來過濾 Agent 的狀態。定序:預設按
id升序排列。匿名版額外參數:
FillInstance參數用於自動填滿當前登入使用者的已綁定 JVS_COPILOT AgentId。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ecd:DescribeCreditPackageAgents |
list |
*全部資源
|
無 | 無 |
請求文法
GET HTTP/1.1
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| BizType |
string |
否 |
業務類型 |
BUSINESS |
| AgentType |
string |
否 |
Agent 類型: |
JVS_COPILOT |
| AgentIds |
array |
否 |
AgentId 列表的 JSON 字串,例: |
|
|
string |
否 |
AgentId 列表 |
jvs-xxxx |
|
| MaxResults |
integer |
否 |
每頁數量 |
100 |
| NextToken |
string |
否 |
分頁 Token;首次請求傳空,後續取上一次響應的 |
eyJvZmZzZXQiOjIwfQ== |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
Schema of Response |
||
| RequestId |
string |
請求追蹤識別碼,用於問題排查 |
xxxx-xxxx-xxxx |
| Agents |
array<object> |
Agent 列表 |
|
|
object |
|||
| AgentId |
string |
Agent ID |
agent-abc |
| InstanceType |
string |
執行個體規格 |
jvs-copilot.standard |
| CreatedTime |
string |
執行個體建立時間 |
2026-04-01 10:00:00 |
| ExpiredTime |
string |
執行個體到期時間 |
2026-10-01 10:00:00 |
| UsedCredit |
integer |
已使用積分量 |
100 |
| TotalCredit |
integer |
積分總量 |
2000 |
| CreditPackageId |
string |
當前生效積分包執行個體 ID |
cp-inst-001 |
| WarnPercent |
integer |
警示閾值百分比(0–100) |
80 |
| MaxResults |
integer |
每頁數量 |
20 |
| NextToken |
string |
分頁 Token;首次請求傳空,後續取上一次響應的 |
eyJvZmZzZXQiOjIwfQ== |
樣本
正常返回樣本
JSON格式
{
"RequestId": "xxxx-xxxx-xxxx",
"Agents": [
{
"AgentId": "agent-abc",
"InstanceType": "jvs-copilot.standard",
"CreatedTime": "2026-04-01 10:00:00",
"ExpiredTime": "2026-10-01 10:00:00",
"UsedCredit": 100,
"TotalCredit": 2000,
"CreditPackageId": "cp-inst-001",
"WarnPercent": 80
}
],
"MaxResults": 20,
"NextToken": "eyJvZmZzZXQiOjIwfQ=="
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。