Agente de IA

01const agent = await plazbot.agent.addAgent(config);
02const agentId = agent.agentId;

01await plazbot.agent.updateAgent(agentId, {
02  name: "Agente Actualizado",
03  buffer: 8
04});

01{
02  "name": "Sales Clinic",
03  "description": "Virtual Agent IA assistant of the Dental Clinic Smiles",
04  "prompt": "You are Máximo, a professional virtual assistant for Smiles Dental Clinic. Help patients with appointments, general information, and guide them through our services. Always maintain a professional yet friendly tone.",
05  "zone": "LA",
06  "buffer": 15,
07  "color": "blue",
08  "question": "How can I help you today?",
09  "timezone": "America/Lima",
10  "enable": true,
11  "tags": [
12    "health",
13    "dentistry",
14    "ia",
15    "plazbot"
16  ],
17  "showInChat": false,
18  "useToolCalling": true,
19  "enableWebSearch": false,
20  "enableContingency": false,
21  "enableAudioInput": false,
22  "responseMode": "direct",
23  "batchWaitSeconds": 3,
24  "version": "v2.0",
25  "enableWidget": true,
26  "darkWidget": true,
27  "nameWidget": "Dental Assistant",
28  "initialShowWidget": true,
29  "examples": [
30    { "value": "How to schedule an appointment?", "color": "green" },
31    { "value": "What are your office hours?", "color": "blue" },
32    { "value": "Do you accept insurance?", "color": "orange" },
33    { "value": "Emergency contact information", "color": "gray" },
34    { "value": "Location and directions", "color": "white" }
35  ],
36  "instructions": {
37    "tone": "professional",
38    "style": "short answers",
39    "personality": "friendly",
40    "objective": "help with clarity",
41    "language": "es-419",
42    "emojis": false,
43    "preferredFormat": "plain text",
44    "maxWords": 80,
45    "avoidTopics": [
46      "laboratory costs",
47      "external claims",
48      "specific medical diagnoses"
49    ],
50    "respondOnlyIfKnows": true,
51    "maintainToneBetweenMessages": true,
52    "greeting": "Hello, I am Máximo, your virtual assistant from Smiles Dental Clinic. How can I help you today?"
53  },
54  "person": {
55    "name": "Máximo",
56    "role": "Virtual customer service assistant",
57    "speaksInFirstPerson": true,
58    "isHuman": false
59  },
60  "fallbacks": {
61    "noAnswer": "Sorry, I don't have information on that topic. Let me connect you with one of our specialists.",
62    "serviceError": "There was a problem processing your request. Please try again later or contact us directly.",
63    "doNotUnderstand": "Could you please repeat it in another way? I want to make sure I help you correctly."
64  },
65  "rules": {
66    "doNotMentionPrices": false,
67    "doNotDiagnose": true,
68    "doNotRespondOutsideHours": "Our office hours are Monday to Saturday, from 8am to 6pm. For emergencies, please call our emergency line."
69  },
70  "customAIConfig": true,
71  "aiProviders": [
72    {
73      "provider": "openai",
74      "model": "gpt-4o",
75      "apiToken": "sk-proj-xxxxxxxxxxxxx",
76      "temperature": 0.7,
77      "maxTokens": 4096,
78      "isDefault": true
79    },
80    {
81      "provider": "claude",
82      "model": "claude-sonnet-4-6",
83      "apiToken": "sk-ant-xxxxxxxxxxxxx",
84      "temperature": 0.5,
85      "maxTokens": 8192,
86      "isDefault": false
87    }
88  ],
89  "channels": [
90    {
91      "channel": "whatsapp",
92      "key": "+51987654321",
93      "multianswer": false
94    },
95    {
96      "channel": "telegram",
97      "key": "smiles_clinic_bot",
98      "multianswer": true
99    }
100  ],
101  "services": [
102    {
103      "intent": "schedule_appointment",
104      "reference": "Service for scheduling patient appointments at the dental clinic",
105      "enabled": true,
106      "method": "POST",
107      "tags": ["appointment", "scheduling"],
108      "endpoint": "https://api.smilesclinic.com/v1/appointments/schedule",
109      "requiredFields": [
110        {
111          "name": "patient_name",
112          "description": "Full name of the patient who wants to schedule the appointment",
113          "promptHint": "Could you please provide your full name?",
114          "type": "string"
115        },
116        {
117          "name": "email",
118          "description": "Patient's email address for appointment confirmation",
119          "promptHint": "What's your email address for the appointment confirmation?",
120          "type": "email"
121        },
122        {
123          "name": "phone",
124          "description": "Patient's phone number for contact",
125          "promptHint": "Could you provide your phone number?",
126          "type": "phone"
127        },
128        {
129          "name": "preferred_date",
130          "description": "Preferred date and time for the appointment",
131          "promptHint": "What date and time would work best for your appointment?",
132          "type": "datetime"
133        },
134        {
135          "name": "service_type",
136          "description": "Type of dental service needed",
137          "promptHint": "What type of dental service do you need? (cleaning, consultation, etc.)",
138          "type": "string"
139        }
140      ],
141      "headers": {
142        "Authorization": "Bearer {{clinic_api_key}}",
143        "Content-Type": "application/json",
144        "X-Clinic-ID": "smiles_001"
145      },
146      "bodyTemplate": {
147        "patient": {
148          "name": "{{patient_name}}",
149          "email": "{{email}}",
150          "phone": "{{phone}}"
151        },
152        "appointment": {
153          "datetime": "{{preferred_date|format('yyyy-MM-dd HH:mm')}}",
154          "service": "{{service_type}}",
155          "timezone": "America/Lima"
156        }
157      },
158      "bodySchema": {
159        "patient_name": "string",
160        "email": "string",
161        "preferred_date": "date",
162        "service_type": "string"
163      },
164      "responseMapping": {
165        "confirmation_id": "$.data.appointment.id",
166        "scheduled_date": "$.data.appointment.datetime",
167        "status": "$.status",
168        "doctor_name": "$.data.appointment.doctor.name",
169        "conflict_reason": "$.error.reason"
170      },
171      "responseMessage": "Your appointment has been successfully scheduled for {{scheduled_date}} with Dr. {{doctor_name}}",
172      "responseConditions": [
173        {
174          "condition": "$.status == 'confirmed'",
175          "message": "¡Perfect! Your appointment has been confirmed for {{scheduled_date}} with Dr. {{doctor_name}}. We'll send you a reminder 24 hours before. Confirmation ID: {{confirmation_id}}",
176          "nextService": "send_appointment_reminder"
177        },
178        {
179          "condition": "$.status == 'conflict'",
180          "message": "Sorry, that time slot is not available. {{conflict_reason}}. Would you like me to suggest other available times?",
181          "nextService": "suggest_alternative_times"
182        },
183        {
184          "condition": "$.status == 'error' && $.error.code == 'invalid_email'",
185          "message": "The email address provided seems invalid. Could you please verify your email address?",
186          "nextService": "verify_contact_info"
187        },
188        {
189          "condition": "$.status == 'error' && $.error.code == 'past_date'",
190          "message": "I cannot schedule appointments for past dates. Could you please choose a future date?"
191        },
192        {
193          "condition": "$.status == 'pending'",
194          "message": "Your appointment request is being reviewed. We'll contact you within 24 hours to confirm availability and finalize the details."
195        }
196      ],
197      "action": "conversar_humano"
198    },
199    {
200      "intent": "check_insurance",
201      "reference": "Service to verify patient insurance coverage and benefits",
202      "enabled": true,
203      "method": "GET",
204      "tags": ["insurance", "verification"],
205      "endpoint": "https://api.smilesclinic.com/v1/insurance/verify",
206      "requiredFields": [
207        {
208          "name": "insurance_provider",
209          "description": "Name of the insurance company",
210          "promptHint": "What's your insurance provider name?",
211          "type": "string"
212        },
213        {
214          "name": "policy_number",
215          "description": "Insurance policy or member ID number",
216          "promptHint": "Could you provide your policy or member ID number?",
217          "type": "string"
218        }
219      ],
220      "headers": {
221        "Authorization": "Bearer {{insurance_api_key}}",
222        "Content-Type": "application/json"
223      },
224      "responseMapping": {
225        "coverage_status": "$.data.coverage.status",
226        "deductible": "$.data.coverage.deductible",
227        "copay": "$.data.coverage.copay",
228        "covered_services": "$.data.coverage.services"
229      },
230      "responseMessage": "Your insurance verification is complete. Coverage status: {{coverage_status}}",
231      "responseConditions": [
232        {
233          "condition": "$.data.coverage.status == 'active'",
234          "message": "Great news! Your insurance is active. Your copay is ${{copay}} and your remaining deductible is ${{deductible}}. Covered services include: {{covered_services}}."
235        },
236        {
237          "condition": "$.data.coverage.status == 'inactive'",
238          "message": "It appears your insurance policy is not currently active. Please contact your insurance provider or we can discuss our self-pay options."
239        },
240        {
241          "condition": "$.data.coverage.status == 'not_found'",
242          "message": "I couldn't find your policy in our system. Please verify your insurance information or contact us directly for assistance."
243        }
244      ]
245    }
246  ],
247 
248  "actions": [
249    {
250      "intent": "assign_urgent_tag",
251      "reference": "Tags patients as urgent when they mention emergency dental situations",
252      "tags": ["emergency", "urgent"],
253      "enabled": true,
254      "responseMessage": "I've marked your case as urgent and notified our emergency team.",
255      "responseJson": false,
256      "responseExact": true,
257      "action": [
258        {
259          "type": "action.tag",
260          "value": "urgent_case"
261        },
262        {
263          "type": "action.asign",
264          "value": "emergency@smilesclinic.com"
265        }
266      ]
267    },
268    {
269      "intent": "schedule_follow_up",
270      "reference": "Automatically schedules follow-up appointments and assigns appropriate case management",
271      "tags": ["follow-up", "scheduling"],
272      "enabled": true,
273      "responseMessage": "Your follow-up has been scheduled and assigned to our treatment coordinator.",
274      "responseJson": false,
275      "responseExact": false,
276      "action": [
277        {
278          "type": "action.stage",
279          "value": "follow_up_scheduled"
280        },
281        {
282          "type": "action.segmentation",
283          "value": "post_treatment_care"
284        }
285      ]
286    },
287    {
288      "intent": "end_consultation",
289      "reference": "Ends the AI consultation when the patient no longer needs assistance",
290      "tags": ["consultation", "end"],
291      "enabled": true,
292      "responseMessage": "Thank you for contacting Smiles Dental Clinic. Have a great day!",
293      "responseJson": false,
294      "responseExact": true,
295      "action": [
296        {
297          "type": "action.agentShutDown",
298          "value": "true"
299        },
300        {
301          "type": "action.solved",
302          "value": "true"
303        }
304      ]
305    }
306  ]
307}

01"channels": [
02  { "channel": "whatsapp", "key": "123456789", "multianswer": true },
03  { "channel": "telegram", "key": "@mi_bot" },
04  { "channel": "messenger", "key": "page_id_123" }
05]

01{
02  "customAIConfig": true,
03  "aiProviders": [
04    {
05      "provider": "openai",
06      "model": "gpt-4o",
07      "apiToken": "sk-proj-xxxxxxxxxxxxx",
08      "temperature": 0.7,
09      "maxTokens": 4096,
10      "isDefault": true
11    },
12    {
13      "provider": "claude",
14      "model": "claude-sonnet-4-6",
15      "apiToken": "sk-ant-xxxxxxxxxxxxx",
16      "temperature": 0.5,
17      "maxTokens": 8192,
18      "isDefault": false
19    }
20  ]
21}

01{
02  "customAIConfig": true,
03  "enableContingency": true,
04  "aiProviders": [
05    { "provider": "openai", "model": "gpt-4o", "apiToken": "sk-proj-xxx", "isDefault": true },
06    { "provider": "claude", "model": "claude-sonnet-4-6", "apiToken": "sk-ant-xxx" }
07  ]
08}

01"variables": [
02  {
03    "code": "sucursal",
04    "name": "Sucursal",
05    "type": "string",
06    "defaultValue": "Lima Centro",
07    "description": "Sucursal desde donde responde el agente"
08  }
09]

01"source": {
02  "enabled": true,
03  "reference": "Catalogo de productos con precios y stock actualizado",
04  "sourceType": "googlesheets",
05  "businessType": "products",
06  "columnMapping": { "nombre": "Producto", "precio": "Precio", "stock": "Stock" },
07  "googleSheets": {
08    "integrationId": "int_xxx",
09    "spreadsheetId": "1AbC...",
10    "sheetName": "Catalogo",
11    "sheetId": 0
12  }
13}

01"voiceConfig": {
02  "enabled": true,
03  "phoneNumber": "+573151234567",
04  "ttsProvider": "openai",
05  "ttsVoiceId": "nova",
06  "ttsLanguage": "es-CO",
07  "greeting": "Hola, gracias por llamar a Smiles Dental Clinic. En que puedo ayudarte?",
08  "maxCallDurationSeconds": 300,
09  "voiceType": "complete",
10  "fillersEnabled": true
11}

01const response = await bot.onMessage({
02  agentId: "agentId",
03  question: "Can you give me a summary of the new Meta WhatsApp prices?",
04  sessionId: "2aff0c11-434f-4d7c-a325-697128bb8a20",
05  file: "https://.../archivo.pdf", // 
06  multipleAnswers: true // Optional
07});
08 
09console.log(" IA Response:", respuesta);

01{
02  "answer": "Los precios de Meta WhatsApp se actualizaron...",
03  "sources": [
04    {
05      "title": "Documento de precios",
06      "content": "Fragmento relevante del documento..."
07    }
08  ],
09  "actionsExecuted": [
10    {
11      "name": "action.tag",
12      "intent": "consulta_precios",
13      "result": {}
14    }
15  ]
16}

01const response = await fetch('https://api.plazbot.com/api/agent/on-message', {
02  method: 'POST',
03  headers: {
04    'Content-Type': 'application/json',
05    'Authorization': 'Bearer YOUR_API_KEY',
06    'x-workspace-id': 'YOUR_WORKSPACE_ID'
07  },
08  body: JSON.stringify({
09    agentId: "agentId",
10    question: "Cuales son los horarios?",
11    sessionId: "2aff0c11-434f-4d7c-a325-697128bb8a20",
12    stream: true
13  })
14});

01data: {"type":"tool_call","tool_name":"search_knowledge_base"}
02 
03data: {"type":"tool_result","tool_name":"search_knowledge_base"}
04 
05data: {"type":"text","content":"Los"}
06 
07data: {"type":"text","content":" horarios"}
08 
09data: {"type":"text","content":" de atencion son..."}
10 
11data: {"type":"done","input_tokens":1250,"output_tokens":380,"estimated_cost":0.0045}

01const reader = response.body.getReader();
02const decoder = new TextDecoder();
03let buffer = '';
04let fullText = '';
05 
06while (true) {
07  const { done, value } = await reader.read();
08  if (done) break;
09 
10  buffer += decoder.decode(value, { stream: true });
11  const lines = buffer.split('\n');
12  buffer = lines.pop() || '';
13 
14  for (const line of lines) {
15    if (!line.startsWith('data: ')) continue;
16    const chunk = JSON.parse(line.substring(6));
17 
18    if (chunk.type === 'text') {
19      fullText += chunk.content;
20      // Actualizar la UI progresivamente
21    } else if (chunk.type === 'tool_call') {
22      // Mostrar indicador: "Buscando informacion..."
23    } else if (chunk.type === 'done') {
24      // Stream finalizado
25      console.log('Tokens:', chunk.input_tokens, chunk.output_tokens);
26    }
27  }
28}

01const agents = await plazbot.agent.getAgents();

01const agent = await plazbot.agent.getAgentById({ id: agentId });

01const copy = await plazbot.agent.copyAgent({ id: agentId });

01const agent = await plazbot.agent.getAgentByChannel({
02  channel: "whatsapp",
03  key: "+51987654321"
04});

01await plazbot.agent.deleteAgent({ id: agentId });

01// Instrucciones
02await plazbot.agent.setInstructions(agentId, {
03  tone: "professional",
04  style: "short answers",
05  language: "es-419",
06  emojis: false,
07  maxWords: 100
08});
09 
10// Persona
11await plazbot.agent.setPersona(agentId, {
12  name: "Maximo",
13  role: "Asistente virtual",
14  speaksInFirstPerson: true,
15  isHuman: false
16});
17 
18// Fallbacks
19await plazbot.agent.setFallbacks(agentId, {
20  noAnswer: "No tengo informacion sobre ese tema.",
21  serviceError: "Hubo un problema. Intenta mas tarde.",
22  doNotUnderstand: "Podrias reformular tu pregunta?"
23});
24 
25// Reglas
26await plazbot.agent.setRules(agentId, {
27  doNotMentionPrices: false,
28  doNotDiagnose: true,
29  doNotRespondOutsideHours: "Lunes a Viernes 9am a 6pm."
30});
31 
32// Tags
33await plazbot.agent.setTags(agentId, ["ventas", "soporte"]);
34 
35// Greeting (saludo)
36await plazbot.agent.setGreeting(agentId, "Hola! Soy tu asistente virtual.");

01const logs = await plazbot.agent.getDebugLogs(agentId);
02console.log(logs);

01const result = await plazbot.agent.improvePrompt("eres un bot que ayuda personas");
02console.log(result.result); // Prompt mejorado

01try {
02  const response = await plazbot.agent.onMessage({
03    agentId: "agent_123",
04    question: "Cuales son los horarios?",
05    sessionId: "session_456"
06  });
07} catch (error) {
08  if (error.status === 401) {
09    // Error de autenticacion - Revisa tu API Key
10  } else if (error.status === 404) {
11    // Agente no encontrado
12  } else if (error.status === 429) {
13    // Rate limit - Espera antes de reintentar
14  }
15}