AI Builder Prompt

01POST /api/agent/ai-builder-prompt

01curl -X POST "https://api-la-plazbot.azurewebsites.net/api/agent/ai-builder-prompt" \
02  -H "Content-Type: application/json" \
03  -H "Authorization: Bearer TU_TOKEN" \
04  -H "x-workspace-id: TU_WORKSPACE_ID" \
05  -d '{
06    "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"
07  }'

01{
02  "success": true,
03  "config": {
04    "name": "Asistente DentalSmile",
05    "description": "Asistente virtual de clinica dental para DentalSmile",
06    "question": "Hola, soy Sofia de DentalSmile. En que puedo ayudarte hoy?",
07    "prompt": "Eres el asistente virtual de DentalSmile, clinica dental...",
08    "zone": "LA",
09    "timezone": "America/Lima",
10    "buffer": 8,
11    "color": "green",
12    "enable": true,
13    "tags": ["clinica dental", "sofia"],
14    "instructions": {
15      "tone": "amable y profesional",
16      "personality": "amable, paciente y servicial",
17      "language": "es-419",
18      "emojis": true,
19      "objective": "agendar citas y atender consultas"
20    },
21    "person": {
22      "name": "Sofia",
23      "role": "Asistente de Atencion",
24      "speaksInFirstPerson": true,
25      "isHuman": false
26    },
27    "fallbacks": {
28      "noAnswer": "Lo siento, no tengo informacion sobre eso...",
29      "serviceError": "Disculpa, estoy teniendo problemas tecnicos...",
30      "doNotUnderstand": "No estoy seguro de entender tu consulta..."
31    },
32    "actions": [
33      {
34        "intent": "agendar_cita",
35        "reference": "agendar una cita, reservar cita...",
36        "enabled": true,
37        "requiredFields": [
38          { "name": "titulo", "type": "string" },
39          { "name": "descripcion", "type": "string" },
40          { "name": "fecha", "type": "datetime" }
41        ],
42        "action": [
43          { "type": "action.event.add", "value": "" },
44          { "type": "action.tag", "value": "cita-agendada" }
45        ]
46      },
47      {
48        "intent": "hablar_humano",
49        "reference": "quiero hablar con una persona...",
50        "enabled": true,
51        "action": [
52          { "type": "action.asign", "value": "[EMAIL_DEL_AGENTE]" },
53          { "type": "action.agentShutDown", "value": "" }
54        ]
55      }
56    ],
57    "channels": [
58      { "channel": "whatsapp", "key": "[WHATSAPP_KEY]" }
59    ],
60    "useToolCalling": true,
61    "customAIConfig": true,
62    "aiProviders": [
63      {
64        "provider": "openai",
65        "model": "gpt-4o",
66        "apiToken": "",
67        "temperature": 0.7,
68        "maxTokens": 500,
69        "isDefault": true
70      }
71    ]
72  },
73  "usage": {
74    "input_tokens": 1847,
75    "output_tokens": 623
76  }
77}

01{
02  "success": false,
03  "error": "No se pudo generar la configuracion del agente. Intenta con un prompt mas descriptivo.",
04  "usage": {
05    "input_tokens": 512,
06    "output_tokens": 89
07  }
08}

01    {
02      "prompt": "Un agente para una tienda de ropa online"
03    }
04    ```
05    Generara un agente generico de ecommerce con acciones basicas de consulta de productos.
06 
07 
08 
09  
10 
11### Prompt intermedio
12 
13```json
14    {
15      "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"
16    }
17    ```
18    Generara acciones de reservas + servicios de menu y delivery con la zona horaria de Colombia.
19 
20 
21 
22  
23 
24### Prompt detallado (mejor resultado)
25 
26```json
27    {
28      "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"
29    }
30    ```
31    Generara un agente completo con nombre, acciones de citas, escalacion configurada, reglas de salud, multiples canales, y Claude como proveedor.
32 
33 
34 
35 
36### Flujo posterior
37 
38Una vez obtenido el JSON de configuracion, puedes:
39 
401. **Crear el agente** directamente con `POST /api/agent/add`
412. **Modificar campos** manualmente antes de crearlo
423. **Importar** el JSON desde la interfaz de Plazbot
43 
44 
45 
46**[Campos del Agente de IA](/guides/agents/fields)**
47 
48Consulta todos los campos disponibles del configurador de agentes
49 
50 
51 
52 
53 
54**[Acciones del Agente](/guides/agents/actions)**
55 
56Detalle de todas las acciones internas que un agente puede ejecutar
57 
58 
59 
60 
61 
62**[Servicios del Agente](/guides/agents/services)**
63 
64Como configurar conexiones a APIs externas