Agentes

Los agentes son asistentes de IA configurados para realizar tareas específicas. En AI Cockpit Lens, cada agente actúa como una unidad de procesamiento con su propio prompt de sistema, proveedor y modelo de IA, plantilla de mensaje de usuario, variables de contexto, herramientas y bases de conocimiento vinculadas. Los agentes pueden apoyar razonamiento, código, chat, documentación, pruebas, análisis de requisitos, revisión de arquitectura y workflows personalizados.

Cuándo usar

• Usa agentes para crear asistentes con un objetivo claro.
• Usa la lista de agentes para revisar asistentes existentes y abrir sus detalles.
• Usa el playground para probar un agente antes de agregarlo a workflows importantes.
• Usa agentes como bloques reutilizables que componen etapas de workflow.

Antes de empezar

• Confirma la organización activa.
• Define el propósito del agente antes de crearlo.
• Prepara las instrucciones que deben guiar su comportamiento.
• Confirma qué opciones de modelo de IA están disponibles para la organización.
• Prepara variables de contexto, herramientas o bases de conocimiento que el agente debe usar.

Paso a paso: navegar por agentes

1. Haz clic en Agentes en la navegación principal.
2. Usa la búsqueda para filtrar por nombre o descripción.
3. Ordena por nombre o fecha cuando sea necesario.
4. Abre un agente para revisar sus detalles.

Paso a paso: crear un agente

1. Haz clic en Crear Agente.
2. Completa la información básica: nombre, tipo y descripción.
3. Elige el proveedor y modelo de IA disponibles para tu organización.
4. Ingresa el prompt de sistema que define cómo debe comportarse el agente.
5. Agrega la plantilla de mensaje de usuario cuando el agente necesite un formato de entrada estructurado.
6. Configura variables de contexto, herramientas y bases de conocimiento vinculadas cuando estén disponibles.
7. Ajusta configuraciones como timeout, intentos de retry y streaming cuando estén disponibles.
8. Haz clic en Guardar Agente.

Entiende los campos principales

Campo	Qué significa
Nombre	Nombre mostrado en listas y detalles.
Tipo	Categoría que describe el propósito del agente.
Descripción	Explicación corta de lo que hace el agente.
Proveedor y modelo	Servicio y modelo de IA usados por el agente.
Prompt de sistema	Instrucción principal que guía el comportamiento del agente.
Plantilla de mensaje de usuario	Estructura usada para montar la solicitud enviada al agente.
Variables de contexto	Valores dinámicos incluidos cuando el agente recibe una solicitud.
Herramientas	Capacidades externas que el agente puede llamar cuando están habilitadas.
Bases de conocimiento	Fuentes RAG que el agente puede consultar para contexto de organización o proyecto.
Timeout	Tiempo máximo esperado de respuesta.
Streaming	Permite que la respuesta aparezca progresivamente cuando hay soporte.

Paso a paso: probar en el playground

1. Abre los detalles de un agente activo.
2. Haz clic en Abrir Playground.
3. Escribe un mensaje en el campo de entrada.
4. Haz clic en Ejecutar Agente.
5. Espera la respuesta.
6. Revisa estado, uso, costo y duración cuando esos detalles se muestren.

Paso a paso: editar o eliminar un agente

1. Abre los detalles del agente o usa la acción de la lista.
2. Haz clic en Editar para cambiar la configuración.
3. Para remover el agente, elige Eliminar y confirma la acción.

precaución

Eliminar un agente puede afectar workflows que dependen de él.

Resultado esperado

Deberías tener un agente con nombre claro, configurado con las instrucciones correctas y probado antes de reutilizarlo en workflows.

Consejos y problemas comunes

• Si la salida del agente no está alineada con la tarea, revisa el prompt de sistema y la plantilla de mensaje de usuario.
• Si la ejecución falla, verifica si el proveedor y el modelo seleccionados están disponibles para la organización.
• Si el agente es usado por workflows, revisa esos workflows antes de editar configuraciones críticas.