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
| Alcance | Descripción | Configuración EKB |
|---|---|---|
| Propósito Único | Maneja un flujo de trabajo específico (por ejemplo, Restablecimiento de Contraseña) | Prompt de Personalidad Enfocado, Toolkit Único |
| Departamental | Cubre tareas del equipo (por ejemplo, Generalista de RR. HH.) | Múltiples Colecciones de Conocimiento, Gestor de Flujos de Trabajo |
| Asistente Empresarial | Delega a agentes especializados | Utiliza el Toolkit de Comunicación entre Agentes para delegación multi-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:| Componente | Propósito | Ejemplo |
|---|---|---|
| 1. Definición de Rol | Establece experiencia y autoridad | ”Eres un Desarrollador Senior Python experto con 10 años de experiencia en sistemas backend y diseño de API.” |
| 2. Misión Principal | Define la tarea/objetivo central | ”Tu responsabilidad principal es revisar fragmentos de código enviados por desarrolladores junior y sugerir optimizaciones de rendimiento, mejoras de seguridad y mejores prácticas.” |
| 3. Contexto del Usuario | Describe a quién sirve el agente | ”Tus usuarios son ingenieros junior (1-3 años de experiencia) aprendiendo Python. Asume que entienden la sintaxis básica pero pueden necesitar orientación en patrones avanzados.” |
| 4. Restricciones de Comportamiento | Establece límites y barreras | ”NO escribas código desde cero. Solo revisa el código enviado. Si una solicitud no está relacionada con el desarrollo en Python, rechace cortésmente y sugiera contactar al equipo apropiado.” |
| 5. Reglas de Uso de Herramientas | Instruye cuándo/cómo usar toolkits | ”Siempre usa el Toolkit de Ejecución de Código Python para verificar tus sugerencias antes de responder. Si no puedes probar el código, declara explícitamente: ‘Esta recomendación no ha sido probada.‘“ |
| 6. Formato de Salida | Asegura estructura de respuesta consistente | ”Formatea todas las respuestas usando Markdown con: 1) Resumen del problema, 2) Recomendaciones específicas en viñetas, 3) Ejemplo de código en bloques de código, 4) Explicación de por qué el cambio mejora el rendimiento/seguridad.” |
| 7. Desencadenantes de Escalamiento | Define cuándo involucrar humanos | ”Si el código involucra migraciones de base de datos, cálculos financieros o autenticación de seguridad, responda: ‘Esto requiere revisión de ingeniería senior. Por favor escale al equipo de Arquitectura.‘“ |
| 8. Tono y Estilo | Establece el enfoque de comunicación | ”Sé alentador y educativo. Evite el lenguaje condescendiente. Celebre las buenas prácticas cuando las vea. Mantenga las respuestas en menos de 200 palabras a menos que se requiera una explicación técnica profunda.” |
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:| Escenario de Prueba | Comportamiento Esperado | Valida |
|---|---|---|
| Ruta Feliz | El usuario proporciona toda la información necesaria; el agente completa la tarea exitosamente | La funcionalidad principal funciona |
| Información Faltante | El agente hace preguntas aclaratorias en lugar de asumir | Lógica de recopilación de información |
| Solicitud Fuera de Alcance | El agente rechaza cortésmente y explica por qué | Refuerzo de límites |
| Consulta Ambigua | El agente pide aclaración antes de actuar | Barreras de seguridad |
| Fallo de Herramienta | El agente explica el problema y sugiere alternativas | Manejo de errores |
| Desencadenante de Escalamiento | El agente identifica correctamente la necesidad de intervención humana | Lógica de escalamiento |
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
| ✅ HACER | ❌ NO HACER |
|---|---|
| Sea explícito sobre lo que el agente PUEDE y NO PUEDE hacer | Asumir que el agente “lo resolverá” |
| Incluya 2-3 ejemplos concretos de comportamiento deseado | Use instrucciones vagas como “sea útil” |
| Especifique patrones exactos de uso de herramientas | Dependa del agente para saber cuándo usar herramientas |
| Defina el formato de respuesta con secciones numeradas | Deje que el agente elija su propia estructura de salida |
| Establezca directrices de recuento de palabras o longitud | Acepte longitudes de respuesta verbosas o inconsistentes |
| Use encabezados y estructura dentro del propio prompt | Escriba un párrafo largo sin organización |
| Pruebe con casos extremos antes del despliegue | Despliegue y espere lo mejor |
| Use control de versiones a través de la pestaña de Historial e itere mensualmente | Configure una vez y nunca actualice |
Pruebas y Solución de Problemas
Problemas Comunes y Soluciones
| Problema | Síntoma | Solución |
|---|---|---|
| Agente no usa herramientas | Responde “No tengo acceso” | Verifique que la herramienta esté habilitada, la descripción sea clara y el Prompt fomente explícitamente su uso. |
| Alucinación de datos | Inventa información | Instruya al agente en el Prompt de Personalidad para decir “No sé” cuando falte información. |
| Respuestas lentas | Consultas >10 segundos | Verifique el tamaño de la ventana de contexto, optimice la Base de Conocimiento, use ejecución paralela. |
| Fallo de autenticación de herramientas | Error de no autorizado | Verifique las credenciales en la configuración de Integraciones, verifique la expiración y alcances del token. |
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.