1. Mejores Prácticas para Implementación y Orquestación
El despliegue exitoso de agentes en la plataforma EKB requiere planificación estratégica y adherencia a las mejores prácticas de orquestación.Planificación Estratégica
Identificación de Casos de Uso de Alto Valor
Aproveche las capacidades de la plataforma enfocándose en industrias donde los agentes EKB destacan:- Finanzas: Agentes de consulta SQL para informes de pérdidas y ganancias y análisis de riesgos.
- RR. HH.: Agentes Filtrador de CVs que analizan PDFs y redactan correos electrónicos.
- Desarrollo de Software: Agentes Revisor de PR para análisis de código y documentación.
- Ventas: Agentes de Enriquecimiento de Leads que integran Búsqueda Web y Salesforce.
- Soporte al Cliente: Agentes de soporte de nivel 1 con acceso a ERP y Base de Conocimiento.
Definición del Alcance del Agente
Patrones de Diseño de Agentes
Patrón 1: Especialista Único Un agente dedicado equipado con conocimiento profundo del dominio y herramientas específicas. Por ejemplo, un agente “Analista de Datos” configurado con el Toolkit de Base de Datos y el Toolkit de Ejecución de Código Python. Patrón 2: Sistemas Multi-Agente Use el Toolkit de Comunicación entre Agentes para crear un sistema donde un “Agente Gerente” descompone solicitudes complejas y delega tareas a “Agentes Trabajadores” especializados. Esto asegura la separación de responsabilidades y mayor precisión para flujos de trabajo complejos.Estrategia de Base de Conocimiento
El Toolkit de Base de Conocimiento impulsa la Generación Aumentada por Recuperación (RAG). Para optimizar el rendimiento:- Segmentación: La plataforma maneja la segmentación, pero asegurar una estructura clara del documento mejora la recuperación.
- Versionado: Elimine documentos obsoletos para prevenir respuestas contradictorias.
Ingeniería de Prompts (Prompts de Personalidad)
El Prompt de Personalidad (también llamado Instrucción de Sistema) en la pestaña de Configuración General es la palanca de configuración más poderosa disponible en la plataforma EKB. Este solo campo de texto gobierna la identidad, comportamiento, marco de toma de decisiones y estilo de interacción de su agente. A diferencia de lo que sugiere el nombre del campo, debe contener instrucciones completas — no solo rasgos de personalidad.Por Qué Importan los Prompts de Personalidad
Un Prompt de Personalidad bien elaborado es la diferencia entre un chatbot poco confiable y un asistente empresarial de confianza. Él:- ✅ Define el dominio de expertise y alcance de responsabilidad del agente
- ✅ Establece barreras de comportamiento para prevenir alucinaciones o respuestas inapropiadas
- ✅ Instruye al agente sobre cuándo y cómo usar herramientas (Base de Datos, Búsqueda Web, etc.)
- ✅ Especifica el formato de respuesta para consistencia entre conversaciones
- ✅ Establece desencadenantes de escalamiento para escenarios que requieren intervención humana
Anatomía de un Prompt de Personalidad Robusto
Estructure su Prompt de Personalidad con estos componentes esenciales:Ejemplo Completo de Prompt de Personalidad: Agente de Soporte de TI
Mejor Práctica: Refinamiento Iterativo
Ningún Prompt de Personalidad es perfecto el Día 1. Después del despliegue:- Revise los registros de conversación en la interfaz de Chat
- Identifique dónde el agente falló o dio respuestas incorrectas
- Actualice el Prompt de Personalidad para abordar esos escenarios específicos
- Use el Historial de Versiones para rastrear cambios y revertir si es necesario
- Repita mensualmente para mejora continua
Técnicas Avanzadas de Ingeniería de Prompts
Ejemplos Few-Shot (Aprendizaje en Contexto)
Incluya 2-3 ejemplos de interacciones directamente en su Prompt de Personalidad para demostrar el comportamiento deseado:Restricciones Negativas (Qué NO Hacer)
Enumere explícitamente los comportamientos prohibidos para reducir alucinaciones y errores:- ❌ “Nunca invente información de empleados si no se encuentra un usuario. Diga: ‘No puedo localizar ese ID de empleado. Por favor verifique e intente de nuevo.’”
- ❌ “Nunca proporcione instrucciones de restablecimiento de contraseña para cuentas que no pueda verificar.”
- ❌ “Nunca asuma permisos. Si no está seguro, escale.”
Razonamiento de Cadena de Pensamiento
Instruya al agente a explicar su proceso de razonamiento para transparencia:Lógica Condicional para Manejo Multi-Escenario
Use estructuras SI-ENTONCES para manejar diferentes tipos de solicitudes:Prueba de Su Prompt de Personalidad
Use la interfaz de Chat para probar estos escenarios antes del despliegue:
💡 Consejo de Plataforma: Use la Configuración de Prompts
Habilite Configuración de Prompts > Mejorar Prompts para que EKB mejore automáticamente las consultas de los usuarios antes de que lleguen a su agente. Esta función agrega claridad y contexto, mejorando la comprensión de su agente incluso si los usuarios envían solicitudes vagas.
Orquestación de Herramientas y Toolkits
Seleccione los Toolkits EKB apropiados para extender las capacidades del agente:- Toolkit de Base de Conocimiento: Recuperación impulsada por RAG de documentos propietarios.
- Toolkit de Búsqueda Web: Acceso a información en tiempo real.
- Toolkit de Base de Datos: Consulte bases de datos SQL y Smart Tables.
- Toolkits de Python/Node.js: Sandboxes seguros de ejecución de código.
- Toolkit de Gestión de Documentos: Cree y edite documentos en el chat.
- Toolkit de Gestión de Smart Tables: Gestión interna de datos estilo NoSQL.
- Toolkit de Comunicación entre Agentes: Delegue tareas a otros agentes.
- Toolkit de Gestión de Flujos de Trabajo: Ejecute flujos de trabajo de automatización deterministas.
- Toolkit de Generación de Imágenes: Cree imágenes usando DALL-E 3.
Flujo de Trabajo de Pruebas e Iteración
Use el Panel Central Chat/Lienzo para pruebas iterativas. Lista de Verificación de Escenarios de Prueba- Ruta Feliz: Consulta estándar con todo el contexto.
- Información Faltante: ¿El agente hace preguntas aclaratorias?
- Activaciones de Herramientas: Verifique que los toolkits específicos se activen correctamente.
- Casos Extremos: Solicitudes ambiguas o fuera de alcance.
- Latencia: Verifique el rendimiento en cadenas de herramientas complejas.
Gobernanza y Cumplimiento
Adhiera a las mejores prácticas de seguridad de EKB:- Principio de Menor Privilegio: Otorgue a los agentes solo las herramientas mínimas requeridas.
- Humano en el Proceso: Configure flujos de trabajo de aprobación para acciones de alto riesgo (por ejemplo, correos masivos, escrituras en BD).
- Controles de Acceso a Datos: Use acceso basado en roles y enmascaramiento de PII.
- Registro de Auditoría: Habilite el registro de todas las acciones para cumplimiento.
- Protección contra Inyección de Prompts: Valide las entradas para prevenir sobrescripciones maliciosas.
¿Qué Va en el Prompt de Personalidad?
Cada agente de producción debe tener estos elementos claramente definidos:- Rol y Expertise: ¿Quién es este agente? ¿Qué conocimiento del dominio posee?
- Declaración de Misión: ¿Cuál es el objetivo principal del agente? ¿Qué problemas resuelve?
- Audiencia de Usuarios: ¿Quién interactuará con este agente? ¿Cuál es su nivel técnico?
- Alcance y Límites: ¿Con QUÉ PUEDE ayudar el agente? ¿Qué está explícitamente FUERA DE ALCANCE?
- Reglas de Comportamiento: Comportamientos obligatorios y prohibidos
- Directrices de Uso de Herramientas: Cuándo y cómo usar Base de Datos, Búsqueda Web, Python, etc.
- Estructura de Respuesta: ¿Cómo deben formatearse las respuestas?
- Criterios de Escalamiento: Cuándo delegar a un humano o agente especializado
- Tono y Estilo: ¿Formal? ¿Amigable? ¿Técnico? ¿Empático?
Ejemplo del Mundo Real: Agente de Enriquecimiento de Leads de Ventas
Qué Hacer y Qué No Hacer en el Prompt de Personalidad
💡 Consejo Pro: Plantillas de Prompts por Caso de Uso
Las Plantillas de Agentes de EKB (por ejemplo, Asistente de Planificación Presupuestaria, IA de Revisión de Contratos y Asistente de Empleados) vienen con prompts de personalidad preconfigurados optimizados para esos roles. Comience con una plantilla, luego personalice el prompt de personalidad para su contexto empresarial específico. Esto ahorra tiempo significativo de configuración inicial.
Pruebas y Solución de Problemas
Problemas Comunes y Soluciones
Lista de Verificación de Preparación para Producción
Asegúrese de que su agente esté listo para el despliegue usando el marco de verificación EKB.- ✅ Verificación de Configuración: Los prompts están estructurados, el Modelo correcto seleccionado.
- ✅ Verificación de Seguridad: Menor privilegio aplicado, flujos de trabajo de aprobación configurados para acciones de alto riesgo.
- ✅ Verificación de Pruebas: Ruta feliz, casos extremos y activaciones de herramientas probados en Chat.
- ✅ Documentación: Guías de usuario y pasos de solución de problemas preparados.
6. Optimización de Rendimiento
Estrategias de mejora continua para mantener la efectividad de los agentes:- Ingeniería de Prompts del Sistema: Refine continuamente los Prompts de Personalidad basándose en registros de interacción del usuario.
- Optimización de la Base de Conocimiento: Audite regularmente los documentos de la KB; optimice tamaños de archivo y convenciones de nombres.
- Gestión de Contexto y Tokens: Equilibre la calidad de la respuesta con el costo mediante el manejo del uso de la ventana de contexto.
- Uso de Herramientas: Minimice llamadas innecesarias; aproveche la ejecución paralela donde sea posible.