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

POST /api/agent/ai-builder-prompt

​
Headers

HeaderRequeridoDescripcion
Content-TypeSiapplication/json
AuthorizationSiBearer {token}
x-workspace-idSiID del workspace

​
Request Body

CampoTipoRequeridoDescripcion
promptstringSiDescripcion en lenguaje natural del agente que necesitas

​
Ejemplo de Request

curl -X POST "https://api-la-plazbot.azurewebsites.net/api/agent/ai-builder-prompt" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "x-workspace-id: TU_WORKSPACE_ID" \
  -d '{
    "prompt": "Necesito un agente para mi clinica dental DentalSmile en Lima Peru, que agende citas, confirme y cancele citas, horario lunes a viernes 9am a 6pm, tono amable y profesional, en español, que use emojis, canal whatsapp, si no puede resolver que derive a un humano"
  }'

​
Ejemplo de Response

{
  "success": true,
  "config": {
    "name": "Asistente DentalSmile",
    "description": "Asistente virtual de clinica dental para DentalSmile",
    "question": "Hola, soy Sofia de DentalSmile. En que puedo ayudarte hoy?",
    "prompt": "Eres el asistente virtual de DentalSmile, clinica dental...",
    "zone": "LA",
    "timezone": "America/Lima",
    "buffer": 8,
    "color": "green",
    "enable": true,
    "tags": ["clinica dental", "sofia"],
    "instructions": {
      "tone": "amable y profesional",
      "personality": "amable, paciente y servicial",
      "language": "es-419",
      "emojis": true,
      "objective": "agendar citas y atender consultas"
    },
    "person": {
      "name": "Sofia",
      "role": "Asistente de Atencion",
      "speaksInFirstPerson": true,
      "isHuman": false
    },
    "fallbacks": {
      "noAnswer": "Lo siento, no tengo informacion sobre eso...",
      "serviceError": "Disculpa, estoy teniendo problemas tecnicos...",
      "doNotUnderstand": "No estoy seguro de entender tu consulta..."
    },
    "actions": [
      {
        "intent": "agendar_cita",
        "reference": "agendar una cita, reservar cita...",
        "enabled": true,
        "requiredFields": [
          { "name": "titulo", "type": "string" },
          { "name": "descripcion", "type": "string" },
          { "name": "fecha", "type": "datetime" }
        ],
        "action": [
          { "type": "action.event.add", "value": "" },
          { "type": "action.tag", "value": "cita-agendada" }
        ]
      },
      {
        "intent": "hablar_humano",
        "reference": "quiero hablar con una persona...",
        "enabled": true,
        "action": [
          { "type": "action.asign", "value": "[EMAIL_DEL_AGENTE]" },
          { "type": "action.agentShutDown", "value": "" }
        ]
      }
    ],
    "channels": [
      { "channel": "whatsapp", "key": "[WHATSAPP_KEY]" }
    ],
    "useToolCalling": true,
    "customAIConfig": true,
    "aiProviders": [
      {
        "provider": "openai",
        "model": "gpt-4o",
        "apiToken": "",
        "temperature": 0.7,
        "maxTokens": 500,
        "isDefault": true
      }
    ]
  },
  "usage": {
    "input_tokens": 1847,
    "output_tokens": 623
  }
}
El campo usage muestra los tokens consumidos en la generacion. Esto es util para monitorear costos.

​
Respuesta de Error

{
  "success": false,
  "error": "No se pudo generar la configuracion del agente. Intenta con un prompt mas descriptivo.",
  "usage": {
    "input_tokens": 512,
    "output_tokens": 89
  }
}

​
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:
Tipo de negocioAcciones generadasServicios generados
Clinica / SaludAgendar, ver, confirmar, cancelar, reagendar citas-
RestauranteHacer, ver, cancelar reservasConsultar menu, pedido delivery
Ventas / Ecommerce-Consultar productos, crear cotizacion
Soporte / IT-Crear ticket, consultar ticket
InmobiliariaAgendar, ver visitasBuscar propiedad
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:
CampoValor por defecto
Idiomaes-419 (Espanol Latinoamerica)
Tonoprofesional y amable
Canalwhatsapp
ZoneLA
Buffer8 mensajes
Proveedor IAopenai con gpt-4o
Temperatura0.7
Emojistrue

​
Tips para un mejor resultado

{
  "prompt": "Un agente para una tienda de ropa online"
}
Generara un agente generico de ecommerce con acciones basicas de consulta de productos.
{
  "prompt": "Agente para restaurante El Buen Sabor en Bogota Colombia, reservas de mesas, consultar menu, pedidos a domicilio, horario 11am a 10pm, tono cercano y divertido"
}
Generara acciones de reservas + servicios de menu y delivery con la zona horaria de Colombia.
{
  "prompt": "Necesito un agente llamado Laura para mi clinica veterinaria PetCare en Santiago de Chile. Debe agendar citas, confirmar y cancelar citas, derivar a un humano (andrea@petcare.cl) cuando no pueda resolver, tono amable y empatico, en español, usar emojis, canales whatsapp y widget web, horario lunes a sabado 8am a 7pm, no debe dar diagnosticos medicos, proveedor Claude con modelo claude-3-5-sonnet"
}
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