Mejores prácticas para publicar e implementar agentes

Para garantizar que tu agente sea sólido, listo para la producción y se alinea con los estándares empresariales, sigue estas prácticas recomendadas antes de publicar e implementar en Orchestrator. Estos pasos cubren la validación, la gobernanza y la preparación a lo largo de todo el ciclo de vida del agente.

Puertas esenciales de inicio rápido

Antes de publicar, confirma que estas comprobaciones fundamentales están completas:

Tabla 1. Puertas de validación de publicación de agente

Puerta esencial	Qué comprobar	Dónde hacer esto
Solicitudes y ejemplos finalizados	La solicitud de sistema/usuario incluye rol, restricciones, 3-5 ejemplos asignados por entrada	Agent Builder → Solicitud de sistema y usuario
Herramientas descritas y vinculadas	Todas las herramientas tienen nombre, descripción y esquema de entrada/salida	Agent Builder → Herramientas
Registro de barrera de seguridad activado (opcional)	Se registran las llamadas a herramientas para auditoría/depuración (activado en la configuración de barrera de seguridad)	Herramientas → Constructor de barreras de seguridad
Fuentes de contexto conectadas	Al menos una base de conocimientos relevante está vinculada	Contextualización → Fuentes
Se han realizado ≥30 pruebas interactivas	Las pruebas manuales cubren entradas típicas, límite y mal formuladas	Agent Builder → Ejecuciones de pruebas
Conjuntos de evaluación creados	≥30 casos de prueba seleccionados, que abarcan el uso en el mundo real	Agent Builder → Pestaña Evaluaciones
Rendimiento de evaluación validado	Puntuación de conjuntos de evaluación ≥70 % sin regresiones	Agent Builder → Pestaña Evaluaciones

Consejo: puedes utilizar estas puertas como lista de verificación antes de la implementación e incorporarlas a tu propio proceso de lanzamiento.

Finaliza tu definición de agente

Antes de publicar, asegúrate de que tu agente esté completamente delimitado, alineado con las solicitudes y consciente del contexto.

• Definir ámbito y límites: enumera las intenciones dentro y fuera de ámbito en la solicitud del sistema. Asegúrate de que las herramientas y las rutas de escalado coinciden con estos límites para evitar desplazamientos en el ámbito.
• Refinar solicitudes y argumentos: escribe solicitudes de sistema y de usuario estructuradas. Usa ejemplos realistas vinculados a argumentos de entrada. Valida las entradas para protegerte contra datos mal formados o contradictorios.
• Aplica el principio de menor contexto: pasa solo el contexto esencial al LLM. Usa Contextualización para evitar cargas útiles infladas.
• Descripciones completas de herramientas y barreras de seguridad: para cada herramienta, define el nombre, el propósito, el esquema y los efectos secundarios. Añade registro, filtros, reintentos y comportamiento de escalada.
• Normalizar la salida de la herramienta: asegúrate de que todas las herramientas devuelvan respuestas estructuradas de forma coherente para evitar incidencias de runtime.
• Conectar fuentes de contexto relevantes: añade los índices necesarios y ajusta los umbrales para la relevancia y la actualidad.

Validar mediante pruebas y evaluación

Debes validar el rendimiento, la resiliencia y la calidad del razonamiento.

• Ejecutar pruebas interactivas: prueba al menos 30 escenarios variados, incluyendo casos límite, entradas mal formadas y ejemplos multilingües.
• Evaluar con conjuntos de pruebas seleccionados: crea ≥30 casos de prueba con evaluadores asertivos. Usa métodos como LLM como juez, coincidencia exacta o puntuación de trayectoria.
• Garantiza la estabilidad del rendimiento: realiza un seguimiento de las puntuaciones en todos los cambios de solicitud o herramienta. Apunta a lograr una puntuación de evaluación coherente de al menos ≥70 % antes de implementar.

Prepárate para implementar en producción.

Valida las integraciones posteriores y la preparación de la infraestructura.

• Ejecutar pruebas de humo desde flujos de trabajo: desencadena el agente desde Studio o Maestro para verificar el flujo de datos de extremo a extremo y su correcto manejo.

• Verificar la disponibilidad de la plataforma: confirma las credenciales, las carpetas, el RBAC y la configuración del tenant en Orchestrator.

• Inspeccionar seguimientos y registros: revisa los seguimientos de ejecución para detectar solicitudes largas, uso de herramientas ineficiente o contexto recuperado en exceso.

• Habilitar escalada con intervención humana: configura aplicaciones de escalada y verifica la gestión de resultados. Pasa transcripciones relevantes y actualizaciones de memoria.

Implementar controles de gobernanza y liberación

Trata a tus agentes como software empresarial: con versiones, revisadas y propias.

• Mantén registros de versiones y cambios: utiliza versiones semánticas y realiza un seguimiento de los cambios para auditorías de comportamiento y reversión.
• Registra flujos de trabajo de aprobación: obtén la aprobación de los equipos de seguridad, operaciones y producto antes de la implementación en producción.
• Elabora documentación operativa: crea un manual de operaciones y una guía de inicio rápido. Incluye entradas/salidas, rotación de credenciales y pasos de recuperación.
• Entrena a equipos de soporte: revisa la lógica del agente, la gestión de escaladas y los procedimientos alternativos.

Supervisa e itera después de la implementación.

La calidad del agente no se detiene en el lanzamiento. Incorpora mejora continua.

• Planificar una implementación gradual: utiliza implementaciones canarias o división de tráfico para validar el comportamiento con bajo volumen.
• Programar evaluación continua: ejecuta nuevamente conjuntos de evaluación de forma periódica. Supervisar los seguimientos para detectar deriva y rendimiento degradado.
• Revisa con regularidad: revisa las solicitudes, herramientas y contexto trimestralmente para reflejar cambios en las reglas empresariales o en las fuentes de datos.