Lo que aprenderás: Esta página explica qué es Agent Cortex, los tres modos operativos (passive,advisory,active), cómo configurar el modo para cada empleado de IA y cómo interactúa con el sistema Agent Skills.
🔢 Tabla de contenidos
- Overview
- How the Cortex Works
- Cortex Modes
- Configure the Cortex Mode
- Cortex + Skills Integration
- Endpoint Reference
- Response Format
- Best Practices
- Troubleshooting
1. Descripción general
¿Qué es el Agente Cortex?
Agent Cortex es una capa de razonamiento inteligente integrada en cada empleado de IA de ZappWay. En esencia, responde una pregunta antes de cada respuesta de la IA:“Dado el contexto de conversación actual, ¿qué habilidad debería aplicar la IA en este momento?”Sin Cortex, su IA responde utilizando solo su base de indicaciones y conocimientos básicos. Con Cortex activo, la IA selecciona dinámicamente la Habilidad del agente más relevante para cada mensaje entrante e inyecta sus instrucciones en el contexto de respuesta.
Por qué es importante
En las conversaciones del mundo real, los usuarios no siempre hacen el mismo tipo de preguntas. Una conversación de soporte puede pasar de una consulta de facturación a un problema técnico en cuestión de minutos. Cortex le permite a su IA:- Adaptarse automáticamente a cambios de tema dentro de una conversación
- Aplicar conocimientos especializados solo cuando sea necesario
- Reduzca la duración del mensaje cargando habilidades específicas a pedido en lugar de poner todo en el mensaje base
- Mejorar la precisión de la respuesta proporcionando instrucciones enfocadas y específicas de la situación
2. Cómo funciona la corteza
Lo que lee la corteza
La Corteza considera:- El mensaje actual del usuario
- Historial de conversaciones recientes (ventana contextual)
- Todas las habilidades activas para el agente (y las habilidades del ámbito de la organización)
- Descripciones de habilidades: se utiliza como señal de coincidencia semántica
El campo description de cada habilidad es la señal principal que utiliza Cortex para seleccionar la habilidad correcta. Escriba siempre descripciones claras y específicas.
3. Modos de corteza
Cortex tiene tres modos de funcionamiento que controlan con qué autonomía selecciona y aplica habilidades.passive — Corteza desactivada
Cortex no evalúa ni aplica habilidades. La IA responde utilizando únicamente su base de indicaciones y conocimientos básicos.
Usar cuando:
- Su IA tiene un propósito único y enfocado sin necesidad de un comportamiento dinámico
- Estás configurando el agente y aún no has creado una biblioteca de habilidades.
- Quieres un control manual total sobre el comportamiento de la IA.
advisory — Cortex observa
Cortex evalúa las habilidades activas y sugiere cuál es la más relevante, pero no la inyecta automáticamente. Este modo es ideal para probar tu biblioteca de habilidades antes de pasar a producción.
Usar cuando:
- Quieres observar qué habilidades selecciona Cortex sin afectar las conversaciones en vivo.
- Estás revisando la cobertura y la calidad de las habilidades.
- Estás ganando confianza antes de activar completamente el Cortex.
active — Corteza activada
Cortex evalúa automáticamente las habilidades activas e inyecta la más relevante en el contexto de la IA antes de cada generación de respuesta.
Usar cuando:
- Tienes una biblioteca de habilidades bien probada con al menos 3 a 5 habilidades activas
- Tus conversaciones cubren diversos temas o requieren comportamientos específicos de cada situación.
- Quieres que la IA se adapte automáticamente sin intervención manual
4. Configurar el modo Cortex
Obtener modo actual
Establecer modo
"passive", "advisory", "active"
rizo:
CÓDIGO_BLOQUE_5
Mecanografiado:
CÓDIGO_BLOQUE_6
5. Integración de habilidades Cortex +
Cortex funciona exclusivamente con el sistema Agent Skills. Para utilizar Cortex de forma eficaz:Paso 1: Crear habilidades
Cree al menos de 3 a 5 habilidades activas para su agente. Cada habilidad debe cubrir un escenario distinto que su IA podría encontrar. → Consulte Habilidades del agente para saber cómo crear habilidades.Paso 2: Activar habilidades
Asegúrese de que cada habilidad tengastatus: "active". Cortex ignora las habilidades en estado draft o archived.
Paso 3: escriba descripciones claras
El campodescription es la señal de coincidencia principal para Cortex. Escribe descripciones que respondan claramente: “¿Cuándo debería activarse esta habilidad?”
Buena descripción:
“Cuando el cliente menciona un error de facturación, un cargo inesperado, una solicitud de reembolso o una disputa de pago”.Mala descripción:
“Para facturar cosas.”
Paso 4: Establezca el modo en advisory primero
Pruebe en modo de aviso antes de activarlo. Observe qué habilidades se seleccionan en sus análisis/registros.
Paso 5: Promocionar a active
Una vez satisfecho con la cobertura de habilidades y la precisión de la selección, configure el modo en active.
6. Referencia de punto final
7. Formato de respuesta
Respuesta exitosa
Respuestas de error
8. Mejores prácticas
Guía de selección de modo
Cobertura de habilidades para el modo activo
Para que Cortex funcione bien en el modoactive:
- Mínimo: 3 habilidades activas que cubran los tipos de conversación más comunes
- Recomendado: 5 a 15 habilidades con descripciones distintas y que no se superpongan
- Evitar: Descripciones extremadamente similares (Cortex puede seleccionar de manera inconsistente)
Pruebas con modo de asesoramiento
Utilice el modo de asesoramiento para responder:- ¿Cortex selecciona la habilidad adecuada para cada tipo de conversación?
- ¿Hay temas de conversación en los que no coinciden ninguna habilidad?
- ¿Hay descripciones de habilidades demasiado similares, lo que hace que se seleccione la habilidad incorrecta?