Skip to main content
Genera la configuracion completa de un Agente de IA enviando un unico prompt descriptivo. A diferencia del AI Builder conversacional, este endpoint no requiere multiples intercambios: envias un parrafo con toda la informacion y recibes el JSON del agente listo para usar.
Mientras mas detallado sea tu prompt, mejor sera la configuracion generada. Si proporcionas poca informacion, el sistema deducira valores razonables por defecto.

Como funciona

  1. Envias un POST con un campo prompt que describe lo que necesitas
  2. El sistema analiza tu texto y extrae automaticamente: tipo de negocio, nombre, proposito, canales, acciones, servicios, tono, idioma, zona horaria y mas
  3. Recibes un JSON completo de configuracion del agente listo para importar o crear

Endpoint

Headers

Request Body

Ejemplo de Request

Ejemplo de Response

El campo usage muestra los tokens consumidos en la generacion. Esto es util para monitorear costos.

Respuesta de Error

Deteccion automatica por tipo de negocio

El sistema detecta automaticamente el tipo de negocio a partir de tu prompt y genera acciones y servicios predeterminados: Todos los tipos incluyen automaticamente la accion “hablar con humano” para escalacion.

Valores por defecto

Si no especificas ciertos datos, el sistema usa estos valores por defecto:

Tips para un mejor resultado

Generara un agente generico de ecommerce con acciones basicas de consulta de productos.
Generara acciones de reservas + servicios de menu y delivery con la zona horaria de Colombia.
Generara un agente completo con nombre, acciones de citas, escalacion configurada, reglas de salud, multiples canales, y Claude como proveedor.

Flujo posterior

Una vez obtenido el JSON de configuracion, puedes:
  1. Crear el agente directamente con POST /api/agent/add
  2. Modificar campos manualmente antes de crearlo
  3. Importar el JSON desde la interfaz de Plazbot

Campos del Agente de IA

Consulta todos los campos disponibles del configurador de agentes

Acciones del Agente

Detalle de todas las acciones internas que un agente puede ejecutar

Servicios del Agente

Como configurar conexiones a APIs externas