Consultar lista de versiones de Agent

Permite consultar la lista del historial de versiones del Agent de destino.

Esta interfaz utiliza la propia API Key del Agent de destino para la autenticación y solo permite la invocación por parte de Agents que tengan habilitado el permiso de gestión de versiones.

Método de solicitud

GET

URL de la solicitud

https://api.${endpoint}/v1/agent/version/list

Autenticación de la solicitud

Para más detalles, consulte la descripción del método de autenticación en la Visión general de la API. Utilice la API Key del Agent de destino como token.

Solicitud

Ejemplo de solicitud

curl -X GET 'https://api.${endpoint}/v1/agent/version/list' \ -H 'Authorization: Bearer ${token}'

                      
                      curl -X GET 'https://api.${endpoint}/v1/agent/version/list' \
  -H 'Authorization: Bearer ${token}'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo	Tipo	Descripción
Authorization	Bearer ${token}	Utiliza la API Key del Agent de destino para la validación de la llamada.

Parámetros de la solicitud

Ninguno.

Respuesta

Cuerpo de la respuesta

{ "code": 0, "message": "OK", "data": [ { "id": "bv-xxxx", "bot_id": "bot-xxxx", "create_time": 1786327712000, "release_time": 1786327812000, "version": "v2", "version_desc": "Update prompt and tools", "version_status": "PUBLISHED", "creator_email": "owner@example.com" } ] }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": [
    {
      "id": "bv-xxxx",
      "bot_id": "bot-xxxx",
      "create_time": 1786327712000,
      "release_time": 1786327812000,
      "version": "v2",
      "version_desc": "Update prompt and tools",
      "version_status": "PUBLISHED",
      "creator_email": "owner@example.com"
    }
  ]
}

Este bloque de código en una ventana flotante

Respuesta correcta

Campo	Tipo	Descripción
id	String	ID del registro de versión.
bot_id	String	ID del Agent.
create_time	Long	Hora de creación de la versión, marca de tiempo en milisegundos.
release_time	Long	Hora de publicación, marca de tiempo en milisegundos; vacío si no se ha publicado.
version	String	Número de versión.
version_desc	String	Descripción de la versión.
version_status	String	Estado de la versión.
creator_email	String	Correo electrónico del creador.

Respuesta fallida

Campo	Tipo	Descripción
code	int	Código de error.
message	string	Mensaje de error.

Códigos de estado

Código de estado	Descripción
200	Correcto
401	No autorizado
403	Permisos insuficientes o la API Key no tiene habilitada la gestión de versiones
429	Demasiadas solicitudes
500	Error del servidor