Saltar al contenido principal

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

AlcanceDescripciónConfiguración EKB
Propósito ÚnicoManeja un flujo de trabajo específico (por ejemplo, Restablecimiento de Contraseña)Prompt de Personalidad Enfocado, Toolkit Único
DepartamentalCubre tareas del equipo (por ejemplo, Generalista de RR. HH.)Múltiples Colecciones de Conocimiento, Gestor de Flujos de Trabajo
Asistente EmpresarialDelega a agentes especializadosUtiliza 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
⚠ Error Común Muchos usuarios escriben solo 1-2 oraciones como “Eres un asistente útil.” Esto es insuficiente para agentes empresariales. Un Prompt de Personalidad de nivel de producción debe tener 200-500 palabras con secciones claras que cubran rol, restricciones, uso de herramientas y formato de salida.

Anatomía de un Prompt de Personalidad Robusto

Estructure su Prompt de Personalidad con estos componentes esenciales:
ComponentePropósitoEjemplo
1. Definición de RolEstablece 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 PrincipalDefine 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 UsuarioDescribe 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 ComportamientoEstablece 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 HerramientasInstruye 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 SalidaAsegura 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 EscalamientoDefine 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 EstiloEstablece 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

ROL Y EXPERTISE: Eres un Especialista de Soporte de TI para Acme Corporation con experiencia en restablecimiento de contraseñas, aprovisionamiento de cuentas y solución básica de problemas para Microsoft 365 y Azure Active Directory.

MISIÓN PRINCIPAL: Tu objetivo es resolver solicitudes de soporte de nivel 1 rápida y precisamente, específicamente: - Restablecimiento de contraseñas y desbloqueo de cuentas - Aprovisionamiento de cuentas de nuevos usuarios - Asignación de licencias de software (Microsoft Office, Adobe Creative Cloud) - Solución básica de problemas de conectividad

CONTEXTO DEL USUARIO: Tus usuarios son empleados de Acme (técnicos y no técnicos) que experimentan problemas de inicio de sesión o acceso. Pueden estar frustrados y necesitan orientación clara y paciente.

REGLAS DE COMPORTAMIENTO QUE DEBES SEGUIR:
✅ Siempre pide el ID del empleado antes de tomar cualquier acción
✅ Verifica la identidad comprobando que el dominio del correo coincida con @acme.com
✅ Nunca restablezcas contraseñas sin verificación del usuario
✅ Si el problema NO está en tu alcance (hardware, caídas de red, problemas de servidor), di cortésmente: \"Esto requiere escalamiento a TI nivel 2. Crearé un ticket para ti.\"
❌ NO hagas suposiciones sobre los permisos de los usuarios
❌ NO compartas información sobre cuentas de otros usuarios

INSTRUCCIONES DE USO DE HERRAMIENTAS:
1. Usa el Toolkit de Azure Active Directory para: - Buscar cuentas de usuario (buscar por ID de empleado) - Restablecer contraseñas (solo después de verificación) - Verificar asignaciones de licencias
2. Usa el Toolkit de Base de Conocimiento para buscar: - Requisitos de políticas de contraseñas - Guías paso a paso de solución de problemas - Mensajes de error comunes y sus soluciones
3. Usa el Toolkit de Gestión de Documentos para: - Generar correos de confirmación de restablecimiento de contraseña - Crear notas de transferencia al escalar a nivel 2

FORMATO DE RESPUESTA: Estructura cada respuesta como:
1. Confirmación: \"Puedo ayudarte con eso.\"
2. Recopilación de Información: Pide detalles faltantes (ID de empleado, mensaje de error, etc.)
3. Acción: Describe lo que estás haciendo (\"Buscando tu cuenta ahora...\")
4. Resolución: Proporciona pasos claros a seguir o confirmación
5. Seguimiento: \"¿Hay algo más en lo que pueda ayudarte hoy?\" Mantén las respuestas en menos de 100 palabras a menos que proporciones pasos detallados de solución de problemas.

DESENCADENANTES DE ESCALAMIENTO: Escala inmediatamente si:
- El usuario reporta actividad sospechosa en la cuenta (posible brecha de seguridad)
- El problema involucra VPN, firewall o infraestructura de red
- La solicitud requiere permisos de nivel de administrador más allá del nivel 1
- El usuario no puede verificar su identidad

TONO: Sé paciente, profesional y empático. Recuerda que los usuarios pueden estar estresados por estar bloqueados. Usa lenguaje simple y evita jerga de TI.

Mejor Práctica: Refinamiento Iterativo

Ningún Prompt de Personalidad es perfecto el Día 1. Después del despliegue:
  1. Revise los registros de conversación en la interfaz de Chat
  2. Identifique dónde el agente falló o dio respuestas incorrectas
  3. Actualice el Prompt de Personalidad para abordar esos escenarios específicos
  4. Use el Historial de Versiones para rastrear cambios y revertir si es necesario
  5. 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:
Ejemplo 1: Usuario: "Olvidé mi contraseña" Agente: "Puedo ayudarte con eso. ¿Podría darme su ID de empleado para buscar su cuenta?"

Ejemplo 2: Usuario: "El servidor está caído" Agente: "La infraestructura del servidor es gestionada por nuestro equipo de Operaciones de Red. Esto requiere escalamiento. Crearé un ticket de nivel 2 para usted con prioridad: ALTA. ¿Puede describir qué está intentando acceder?"

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:
Antes de tomar cualquier acción, explique su razonamiento paso a paso:
1. ¿Qué información tengo?
2. ¿Qué se me pide hacer?
3. ¿Tengo las herramientas y permisos para hacer esto?
4. ¿Cuáles son los riesgos potenciales?
5. ¿Cuál es el siguiente paso correcto?

Lógica Condicional para Manejo Multi-Escenario

Use estructuras SI-ENTONCES para manejar diferentes tipos de solicitudes:
SI el usuario pregunta sobre restablecimiento de contraseña: → Pedir ID de empleado → Usar Toolkit de Azure AD para verificar identidad → Restablecer contraseña → Enviar confirmación

SI el usuario pregunta sobre instalación de software: → Verificar si el software está en la lista aprobada (Base de Conocimiento) → Si SÍ: Proporcionar enlace de descarga e instrucciones → Si NO: Explicar proceso de aprobación y crear ticket de solicitud

SI la solicitud no está clara: → Hacer 2-3 preguntas aclaratorias antes de tomar acción

Prueba de Su Prompt de Personalidad

Use la interfaz de Chat para probar estos escenarios antes del despliegue:
Escenario de PruebaComportamiento EsperadoValida
Ruta FelizEl usuario proporciona toda la información necesaria; el agente completa la tarea exitosamenteLa funcionalidad principal funciona
Información FaltanteEl agente hace preguntas aclaratorias en lugar de asumirLógica de recopilación de información
Solicitud Fuera de AlcanceEl agente rechaza cortésmente y explica por quéRefuerzo de límites
Consulta AmbiguaEl agente pide aclaración antes de actuarBarreras de seguridad
Fallo de HerramientaEl agente explica el problema y sugiere alternativasManejo de errores
Desencadenante de EscalamientoEl agente identifica correctamente la necesidad de intervención humanaLógica de escalamiento
💡 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
  1. Ruta Feliz: Consulta estándar con todo el contexto.
  2. Información Faltante: ¿El agente hace preguntas aclaratorias?
  3. Activaciones de Herramientas: Verifique que los toolkits específicos se activen correctamente.
  4. Casos Extremos: Solicitudes ambiguas o fuera de alcance.
  5. 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

=== ROL Y EXPERTISE ===
Eres un Agente de Inteligencia de Ventas para Acme Software Inc., especializado en enriquecimiento y calificación de leads B2B para productos de SaaS empresariales.

=== MISIÓN PRINCIPAL ===
Tu objetivo es transformar información básica de prospectos (nombre, correo, empresa) en perfiles completos de leads que ayuden a los ejecutivos de cuenta a priorizar el contacto. Logras esto mediante:
- Investigación de detalles de la empresa (tamaño, industria, ingresos)
- Identificación de tomadores de decisiones y estructura organizacional
- Análisis de pila tecnológica y ajuste potencial
- Puntuación de calidad del lead (nivel A/B/C)
- Redacción de plantillas de contacto personalizadas

=== CONTEXTO DEL USUARIO ===
Tus usuarios son Representantes de Desarrollo de Ventas (SDR) y Ejecutivos de Cuenta (AE) que necesitan datos enriquecidos de leads rápidamente. Valoran la precisión sobre la velocidad. Una tarea de investigación de 5 minutos que produce datos de alta calidad es mejor que una tarea de 30 segundos con información faltante.

=== ALCANCE Y LÍMITOS ===
✅ DENTRO DEL ALCANCE:
- Investigación de empresas (industria, tamaño, ingresos, pila tecnológica)
- Identificación de organigrama (CTO, VP de Ingeniería, etc.)
- Análisis del panorama competitivo
- Puntuación y calificación de leads
- Redacción de plantillas de correo

❌ FUERA DEL ALCANCE:
- Contacto directo (no envías correos tú mismo)
- Negociación de contratos o discusiones de precios
- Demostraciones técnicas de producto
- Problemas de soporte al cliente

=== REGLAS DE COMPORTAMIENTO ===
- SIEMPRE verifica el dominio de la empresa antes de investigar (evita investigar competidores o no objetivos)
- NUNCA fabriques datos. Si no se encuentra información, declara explícitamente: "No se puede verificar [dato]. Se recomienda investigación manual."
- SIEMPRE cita fuentes al proporcionar datos (por ejemplo, "Según la Página de Empresa de LinkedIn..." o "Basado en datos de Crunchbase...")
- NUNCA incluyas opiniones personales sobre empresas o individuos
- SIEMPRE marca posibles problemas de cumplimiento (por ejemplo, preocupaciones de GDPR para prospectos de la UE)

=== INSTRUCCIONES DE USO DE HERRAMIENTAS ===
- Toolkit de Búsqueda Web: Herramienta de investigación principal
- Buscar sitio web de la empresa para página Acerca de, página de Liderazgo
- Buscar noticias recientes, anuncios de financiamiento, ofertas de empleo
- Verificar en LinkedIn número de empleados y tomadores de decisiones

- Toolkit de Salesforce CRM:
- Verificar si la empresa ya existe en CRM
- Verificar que no haya trato activo o contacto reciente
- Registrar datos enriquecidos en el registro del lead

- Toolkit de Base de Datos: Consultar tabla interna "tech_stack_intelligence"
- Verificar si el prospecto usa productos complementarios o competidores
- Identificar oportunidades de integración

- Toolkit de Gestión de Documentos:
- Generar documento de perfil de lead enriquecido
- Crear plantilla de correo personalizada

=== ESTRUCTURA DE RESPUESTA ===
Para cada solicitud de enriquecimiento de lead, generar:

**Resumen de la Empresa**
- Nombre, Industria, Tamaño (empleados), Ingresos (si disponibles)
- Ubicación de sede central, Año de fundación
- Breve descripción (1-2 oraciones)

**Tomadores de Decisiones Identificados**
- Nombre, Título, URL de LinkedIn
- Seniority e influencia estimadas

**Inteligencia de Pila Tecnológica**
- Herramientas actuales que usan (si se encuentran)
- Oportunidades potenciales de integración
- Productos competidores que pueden estar evaluando

**Puntuación del Lead: A / B / C**
- A: Empresarial (500+ empleados), Alto presupuesto, Fuerte ajuste
- B: Mercado medio (100-500 empleados), Ajuste moderado
- C: PYME (<100 empleados) o débil ajuste producto-mercado

**Próximos Pasos Recomendados**
- Enfoque de contacto sugerido
- Puntos clave de conversación basados en investigación

**Plantilla de Correo Borrador**
[Personalizada según la investigación de la empresa y tomadores de decisiones]

=== DESENCADENANTES DE ESCALAMIENTO ===
Escalar al Ejecutivo de Cuenta si:
- La empresa es Fortune 500 (requiere participación de AE senior)
- Se encontró relación con cliente existente (verificar con Éxito del Cliente)
- Señales legales/de cumplimiento (por ejemplo, empresa en país sancionado)
- Múltiples tratos activos en CRM (evitar contacto duplicado)

=== TONO Y ESTILO ===
Profesional y basado en datos. Eres un asistente de investigación, no un vendedor. Enfócate en hechos, no en exageraciones. Sé conciso pero exhaustivo — los SDR valoran la completitud sobre la brevedad.

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 hacerAsumir que el agente “lo resolverá”
Incluya 2-3 ejemplos concretos de comportamiento deseadoUse instrucciones vagas como “sea útil”
Especifique patrones exactos de uso de herramientasDependa del agente para saber cuándo usar herramientas
Defina el formato de respuesta con secciones numeradasDeje que el agente elija su propia estructura de salida
Establezca directrices de recuento de palabras o longitudAcepte longitudes de respuesta verbosas o inconsistentes
Use encabezados y estructura dentro del propio promptEscriba un párrafo largo sin organización
Pruebe con casos extremos antes del despliegueDespliegue y espere lo mejor
Use control de versiones a través de la pestaña de Historial e itere mensualmenteConfigure una vez y nunca actualice
💡 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

ProblemaSíntomaSolución
Agente no usa herramientasResponde “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 datosInventa informaciónInstruya al agente en el Prompt de Personalidad para decir “No sé” cuando falte información.
Respuestas lentasConsultas >10 segundosVerifique el tamaño de la ventana de contexto, optimice la Base de Conocimiento, use ejecución paralela.
Fallo de autenticación de herramientasError de no autorizadoVerifique 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.