Listar agentes - Qoder CN Series: Central de Documentação do Alibaba Cloud

Lista todos os agentes da conta atual com paginação e ordenação.

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
`Authorization`	Sim	`Bearer <PAT>`

Parâmetros de consulta

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`limit`	integer	Não	20	Número de resultados por página, entre 1 e 100.
`order`	string	Não	`desc`	Direção da ordenação: `"asc"` ou `"desc"`.
`after_id`	string	Não	-	Cursor. Retorna registros posteriores a este ID.
`before_id`	string	Não	-	Cursor. Retorna registros anteriores a este ID.

Consulte Paginação para entender a semântica dos cursores.

Exemplo de requisição

curl -X GET "https://api.qoder.com.cn/api/v1/cloud/agents?limit=2&order=desc" \
  -H "Authorization: Bearer $QODER_PAT"

Exemplo de resposta

HTTP 200 OK

{
  "data": [
    {
      "type": "agent",
      "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "name": "doc-test-agent",
      "description": "",
      "model": "ultimate",
      "system": "You are a documentation test assistant.",
      "instructions": "You are a documentation test assistant.",
      "tools": [],
      "mcp_servers": [],
      "default_environment": "",
      "version": 1,
      "archived": false,
      "archived_at": null,
      "created_at": "2026-05-18T15:26:39.61669Z",
      "updated_at": "2026-05-18T15:26:39.61669Z"
    },
    {
      "type": "agent",
      "id": "agent_019eYYYYYYYYYYYYYYYYYYYYYYYYYYYY",
      "name": "test-agent-e2e",
      "description": "Agent used for E2E testing.",
      "model": "ultimate",
      "system": "You are a test assistant.",
      "instructions": "You are a test assistant.",
      "tools": [],
      "mcp_servers": [],
      "default_environment": "",
      "version": 2,
      "archived": false,
      "archived_at": null,
      "created_at": "2026-05-18T03:04:33.952256Z",
      "updated_at": "2026-05-18T03:05:28.023697Z"
    }
  ],
  "first_id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "last_id": "agent_019eYYYYYYYYYYYYYYYYYYYYYYYYYYYY",
  "has_more": true
}

Campos da resposta

Campo	Tipo	Descrição
`data`	array	Array de objetos agent.
`first_id`	string	ID do primeiro registro na página atual.
`last_id`	string	ID do último registro na página atual.
`has_more`	boolean	Indica se há mais registros disponíveis.

Paginação direta (próxima página):

curl "https://api.qoder.com.cn/api/v1/cloud/agents?limit=20&after_id=agent_019eYYYY..." \
  -H "Authorization: Bearer $QODER_PAT"

Paginação reversa (página anterior):

curl "https://api.qoder.com.cn/api/v1/cloud/agents?limit=20&before_id=agent_019eXXXX..." \
  -H "Authorization: Bearer $QODER_PAT"

Erros

HTTP	Tipo	Causa
400	`invalid_request_error`	O valor de `limit` está fora do intervalo permitido ou um parâmetro é malformado.
401	`authentication_error`	O PAT é inválido ou expirou.
403	`permission_error`	O chamador não tem autorização para esta operação.

Consulte Erros para ver a estrutura completa de erros.

Observações

Por padrão, os resultados são ordenados por data de criação em ordem decrescente (mais recentes primeiro).
Agentes arquivados não aparecem na listagem padrão.
A paginação usa cursores; a paginação por offset não é compatível.