Listar versões do agente - Qoder CN Series: Central de Documentação do Alibaba Cloud

Liste o histórico de versões de um agente específico em ordem decrescente.

Cabeçalhos da requisição

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

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
`agent_id`	string	Sim	Identificador exclusivo do agente.

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.
`order`	string	Não	`desc`	Direção da ordenação: `"asc"` ou `"desc"`.
`after_id`	string	Não	-	Cursor. Retorna registros posteriores a esta versão.
`before_id`	string	Não	-	Cursor. Retorna registros anteriores a esta versão.

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/agent_019eXXXX.../versions" \
  -H "Authorization: Bearer $QODER_PAT"

Exemplo de resposta

HTTP 200 OK

{
  "data": [
    {
      "type": "agent",
      "id": "agent_019eXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
      "name": "doc-test-agent-updated",
      "description": "Used for API documentation testing.",
      "model": "ultimate",
      "system": "You are the updated documentation test assistant.",
      "instructions": "You are the updated documentation test assistant.",
      "tools": [],
      "mcp_servers": [],
      "default_environment": "",
      "version": 2,
      "created_at": "2026-05-18T15:26:39.61669Z",
      "updated_at": "2026-05-18T15:27:07.967138Z"
    },
    {
      "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,
      "created_at": "2026-05-18T15:26:39.61669Z",
      "updated_at": "2026-05-18T15:26:39.61669Z"
    }
  ],
  "first_id": "2",
  "last_id": "1",
  "has_more": false
}

Campos da resposta

Campo	Tipo	Descrição
`data`	array	Array de snapshots das versões do agente. Cada elemento é um objeto completo do agente no momento daquela versão.
`first_id`	string	Identificador da versão do primeiro registro na página atual.
`last_id`	string	Identificador da versão do último registro na página atual.
`has_more`	boolean	Indica se há registros adicionais de versões disponíveis.

Comportamento do histórico de versões

Toda atualização PUT em um agente cria uma nova versão.
Os números de versão começam em 1 e incrementam de um em um.
Cada versão armazena um snapshot completo do agente no momento da alteração.
Use este endpoint para auditar o histórico de alterações ou como referência para rollback.

Erros

HTTP	Tipo	Gatilho
401	`authentication_error`	O PAT é inválido ou expirou.
403	`permission_error`	O chamador não tem autorização para acessar este agente.
404	`not_found_error`	Não existe agente com o ID especificado.

Consulte Erros para ver a estrutura completa de erros.

Observações

Neste endpoint, os campos first_id e last_id correspondem aos números de versão em formato string, como "1" ou "2".
Por padrão, os resultados são ordenados por número de versão em ordem decrescente (mais recentes primeiro).
Combine este recurso com as verificações de concorrência otimista (OCC) em requisições PUT para rastrear alterações de configuração ao longo do tempo.