Obtener un agente

Obtén la configuración completa de un agente específico.

GET/api/external/v2/agents/:agent_id

Autenticación

Este endpoint se autentica con una API key mediante la cabecera X-API-Key (formato ek_live_...), en lugar del token bearer del resto de la referencia.

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción
`agent_id`	String (UUID)	Obligatorio	UUID del agente a consultar.

Ejemplo de solicitud

bash

curl -X GET "https://eclectic-api-537143970188.us-central1.run.app/api/external/v2/agents/4b2f7a1e-0e88-4aa7-bf67-7d0a3e0f5b91" \
  -H "X-API-Key: ek_live_your_api_key_here"

Ejemplo de respuesta

json

{
  "agent": {
    "id": "4b2f7a1e-0e88-4aa7-bf67-7d0a3e0f5b91",
    "name": "Support Agent",
    "type": "BASIC",
    "system_prompt": "Help customers with clear and concise answers.",
    "tools": {
      "handoff_to_human_control": {
        "enabled": true,
        "instructions": "..."
      }
    }
  },
  "business_id": "2a4b8d4b-23fa-420a-94c2-cb9a4d2c7fb8"
}

Notas

El agente debe pertenecer al negocio autenticado por la API key.
La respuesta incluye la configuración del agente, incluyendo prompts, modelo, herramientas y campos relacionados.