Crear un agente

Crea un agente BASIC dentro del negocio asociado a tu API key.

POST/api/external/v2/agents

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.

Cuerpo de la solicitud

Parámetro	Tipo	Obligatorio	Descripción
`agent.name`	String	Obligatorio	Nombre visible del agente.
`agent.system_prompt`	String	Obligatorio	Prompt principal del agente.
`agent.tools`	Object	Opcional	Configuración opcional de herramientas del agente.

Ejemplo de solicitud

bash

curl -X POST "https://eclectic-api-537143970188.us-central1.run.app/api/external/v2/agents" \
  -H "X-API-Key: ek_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {
      "name": "Support Agent",
      "system_prompt": "Help customers with clear and concise answers."
    }
  }'

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": {}
  },
  "business_id": "2a4b8d4b-23fa-420a-94c2-cb9a4d2c7fb8"
}

Notas

El business_id se determina desde la API key y no debe enviarse en el body.
El body debe incluir un objeto agent. El tipo siempre será BASIC y Eclectic configura internamente el proveedor y modelo.
Si envías tools reutilizados desde un GET, los campos description generados para documentación se ignoran al guardar.