Los servicios permiten que tu agente de IA se conecte con APIs externas para ejecutar acciones complejas como consultar bases de datos, realizar reservas, procesar pagos, o cualquier integración que necesites. El agente recolectará automáticamente la información necesaria del usuario antes de llamar a la API.
✅ Los servicios están en Producción Estable y han demostrado alta fiabilidad. El sistema maneja automáticamente la recolección de datos, validación y ejecución de APIs externas.
{ "services": [ { "intent": "schedule_appointment", "reference": "Servicio para agendar citas médicas en la clínica", "enabled": true, "method": "POST", "requiredFields": [ { "name": "nombre", "description": "Nombre completo del paciente", "promptHint": "¿Podrías indicarme tu nombre completo, por favor?", "type": "string" }, { "name": "email", "description": "Correo electrónico para confirmaciones", "promptHint": "¿Cuál es tu dirección de correo electrónico?", "type": "email" }, { "name": "fecha", "description": "Fecha y hora preferida para la cita", "promptHint": "¿Qué día y hora te gustaría agendar? (Ejemplo: mañana a las 3pm)", "type": "date" }, { "name": "telefono", "description": "Número de teléfono de contacto", "promptHint": "¿Cuál es tu número de teléfono?", "type": "phone" } ], "endpoint": "https://api.clinica.com/v1/appointments", "tags": ["citas", "agendamiento", "medical"], "headers": { "Authorization": "Bearer {{apiKey}}", "Content-Type": "application/json", "X-Clinic-ID": "clinic_123" }, "bodyTemplate": { "patient_name": "{{nombre}}", "patient_email": "{{email}}", "appointment_date": "{{fecha|format('yyyy-MM-dd HH:mm')}}", "phone": "{{telefono}}", "source": "plazbot_ai" }, "responseMapping": { "appointmentId": "$.data.appointment_id", "confirmedDate": "$.data.scheduled_date", "doctorName": "$.data.doctor.name", "status": "$.status", "errorMessage": "$.error.message" }, "responseMessage": "¡Perfecto! Tu cita ha sido agendada para el {{confirmedDate}} con {{doctorName}}. ID de cita: {{appointmentId}}", "responseConditions": [ { "condition": "$.status == 'success'", "message": "✅ ¡Cita confirmada! Te esperamos el {{confirmedDate}} con {{doctorName}}. Recibirás un recordatorio por email.", "nextService": "verify_contact_info" }, { "condition": "$.status == 'conflict'", "message": "❌ Lo siento, ese horario no está disponible. ¿Te gustaría que te sugiera horarios libres?", "nextService": "verify_contact_info" }, { "condition": "$.status == 'error'", "message": "⚠️ Hubo un problema al agendar: {{errorMessage}}. ¿Podrías intentar con otra fecha?", "nextService": "verify_contact_info" } ], "action": "notify_doctor" } ]}
Los campos de tipo date son procesados inteligentemente por la IA. El usuario puede escribir “mañana a las 3pm” y se convertirá automáticamente al formato correcto.
Puedes probar servicios usando el chat del agente:
Copy
Usuario: "Quiero agendar una cita"Bot: "¿Podrías indicarme tu nombre completo, por favor?"Usuario: "Juan Pérez"Bot: "¿Cuál es tu dirección de correo electrónico?"Usuario: "juan@email.com"Bot: "¿Qué día y hora te gustaría agendar?"Usuario: "Mañana a las 3pm"Bot: "✅ ¡Cita confirmada! Te esperamos el 2024-03-16 15:00..."
Puedes probar servicios directamente desde el chat del agente:
Copy
👤 Usuario: "Quiero agendar una cita"🤖 Bot: "¿Podrías indicarme tu nombre completo, por favor?"👤 Usuario: "Juan Pérez"🤖 Bot: "¿Cuál es tu dirección de correo electrónico?"👤 Usuario: "juan@email.com"🤖 Bot: "¿Qué día y hora te gustaría agendar?"👤 Usuario: "Mañana a las 3pm"🤖 Bot: "✅ ¡Cita confirmada! Te esperamos el 2024-03-16 15:00..."
{ "fallbacks": { "serviceError": "Hubo un problema al procesar tu solicitud. Inténtalo más tarde.", "noAnswer": "No pude obtener una respuesta del servicio." }}
⏳ Timeout y Reintentos Configurables: Configuración de timeout por servicio
🧪 Mock Responses: Respuestas simuladas para testing
🔒 Encriptación Automática: Cifrado de campos sensibles
📊 Métricas Avanzadas: Analytics detallados de performance
⚡ Caché de Respuestas: Cache con TTL configurable
🔄 Llamadas Paralelas: Ejecución simultánea de múltiples APIs
✅ Validación Regex: Patrones personalizados para campos
🛡️ Validación de Permisos: Control de acceso por roles
📋 Importante: Si necesitas alguna de estas funcionalidades, puedes implementarlas en tu API externa o contactar al equipo de Plazbot para priorización en el roadmap.
Los servicios son una funcionalidad poderosa que transforma tu agente de IA en un asistente capaz de ejecutar acciones reales. Con la configuración correcta, puedes integrar cualquier API REST y proporcionar una experiencia conversacional fluida a tus usuarios.
Assistant
Responses are generated using AI and may contain mistakes.