Saltar al contenido principal

Agentes

La sección Agents cubre dos rutas que funcionan conjuntamente: la cuadrícula /agents, donde los usuarios eligen un agente con el que conversar, y la vista /chat/:agentId (y /chat/:agentId/:threadId), donde tiene lugar la conversación. Ambas rutas son accesibles para todos los usuarios autenticados; el botón Configure de cada tarjeta es visible únicamente para los administradores.

Cuadrícula de Agentes (/agents)​

La página de agentes se abre con el título de página Agents y el subtítulo "Select an AI agent to start a conversation." Una barra de búsqueda filtra la lista de tarjetas en tiempo real por nombre de agente. Todo el filtrado ocurre en el lado del cliente: no se realiza ninguna llamada adicional a la API mientras se escribe.

Cada agente se muestra como una tarjeta que contiene la siguiente información:

  • Icono del agente — el icono propio del agente: una imagen personalizada si se cargó una, o de lo contrario el icono elegido en Studio. Cuando el agente no tiene ninguno de los dos, recurre a un glifo derivado de agent_type y agent_arch, que distingue visualmente las arquitecturas de chat, tarea y multiagente. Consulte Agent Icon
  • Insignia de proveedor — indica el proveedor de LLM de respaldo (p. ej., OpenAI, Azure OpenAI, Anthropic)
  • Insignia de estado — Active (verde) cuando is_active es verdadero; Draft (atenuado) en caso contrario
  • Nombre del agente — mostrado de forma destacada; hacer clic en cualquier parte de la tarjeta navega a /chat/:agentId
  • Insignia de tipo — el valor de agent_type (p. ej., chat, task)
  • Insignia de modelo — el nombre del primer modelo configurado para el agente
  • Descripción — hasta dos líneas de texto; truncada con puntos suspensivos si es más larga
  • Botón Configure — visible solo para administradores; navega a /configure/:agentId sin salir de la cuadrícula al hacer clic (el evento de clic se detiene para que no se propague a la tarjeta)
  • Insignia Locked — reemplaza el botón Configure para los agentes gestionados por suite; indica que la orquestación está controlada por la suite instalada y no puede modificarse directamente

Nota: La cuadrícula consulta airuntime/agent/ con type=assistant, published=true e is_active=true. Los agentes que no han sido publicados o que han sido desactivados en el constructor de agentes no aparecen aquí.

Vista de Chat (/chat/:agentId)​

Al hacer clic en cualquier tarjeta de agente — o en una fila de Recent Agents en el panel de control — se abre la vista de chat. El diseño de la página se divide en dos áreas: el área principal de chat a la izquierda y una barra lateral derecha.

Área Principal de Chat​

El área de chat ocupa el ancho restante. Los mensajes se muestran en una lista desplazable. Los mensajes del usuario aparecen alineados a la derecha; los mensajes del agente aparecen alineados a la izquierda. Las llamadas a herramientas realizadas por el agente durante una respuesta se muestran en línea como entradas ToolCallCard — cada tarjeta es expandible y muestra el nombre de la herramienta, los argumentos de entrada y la salida. Los componentes de interfaz generativa (gráficos, tablas de datos, tarjetas KPI, mapas, formularios, acciones de aprobación, bloques de código) se renderizan en línea dentro de los mensajes del agente cuando este los emite.

Cuando una respuesta está en streaming, se muestra un indicador de carga. El envío de un mensaje mientras una respuesta está en curso está bloqueado hasta que el stream se complete. Un botón Stop está disponible durante el streaming para cancelar la respuesta. Los archivos adjuntos son compatibles con agentes que tienen upload_files habilitado; los archivos adjuntos se referencian en la visualización del mensaje por su nombre.

Si el hilo está bloqueado debido a una infracción de la política de contenido, el área de entrada se reemplaza con un banner de conversación bloqueada que muestra el motivo del bloqueo e indica al usuario que inicie un nuevo chat.

Para los agentes passthrough que requieren SSO de Microsoft, se muestra un AuthRequiredBanner cuando la sesión actual no se autenticó mediante inicio de sesión de Microsoft, y la entrada está deshabilitada hasta que el usuario vuelva a autenticarse.

Barra Lateral Derecha​

La barra lateral derecha tiene un ancho fijo de 272 px y contiene tres regiones:

Resumen del Agente — secciones colapsables para las Skills, Knowledge (fuentes de datos) y MCP Servers del agente. Cada sección muestra una insignia con el recuento y, cuando se expande, insignias en forma de pastilla que listan los nombres de los recursos individuales. Este panel está oculto para los agentes passthrough, que en su lugar muestran la descripción del agente en un bloque About.

Botón New Chat — un botón principal New Chat restablece el estado de conversación en memoria y navega a /chat/:agentId con un nuevo chatKey. Para los agentes passthrough, al hacer clic en New Chat también se restablece la sesión remota de CopilotKit.

Conversaciones Recientes — una lista desplazable de hilos anteriores para este agente, ordenados por actualización más reciente. Al hacer clic en un elemento de hilo se navega a /chat/:agentId/:threadId, que carga el historial de mensajes del hilo desde el backend y reanuda la conversación. Este panel está oculto para los agentes passthrough, que no conservan el historial de hilos local.

Persistencia de Hilos​

Después de la primera respuesta del agente en una nueva conversación, el runtime crea automáticamente un registro de hilo en el backend. El nombre del hilo se deriva del primer mensaje del usuario (hasta 80 caracteres). La URL se actualiza silenciosamente para incluir el ID del hilo mediante window.history.replaceState — esto evita volver a montar el proveedor de chat y perder los mensajes en memoria, al tiempo que hace que la URL sea marcable como favorito.

Buenas Prácticas​

  • Use la barra de búsqueda de la cuadrícula de Agentes para localizar agentes rápidamente en inquilinos con muchos agentes desplegados; el filtro es instantáneo y no distingue entre mayúsculas y minúsculas.
  • Si las llamadas a herramientas de un agente aparecen en el flujo de mensajes pero la respuesta final tarda, el agente está esperando una herramienta externa de larga duración — compruebe la conexión subyacente en Connections.
  • Abra un hilo existente desde Recent Conversations en lugar de iniciar un nuevo chat cuando continúe una tarea de múltiples turnos; el agente tiene acceso completo al historial de mensajes del hilo.
  • Los administradores deben usar el botón Configure directamente desde la cuadrícula en lugar de navegar a través de la barra lateral — evita una transición de página innecesaria.
  • Los archivos adjuntos solo están disponibles para agentes donde upload_files está habilitado en el constructor de agentes; si el botón de adjuntar no es visible, la función debe habilitarse en la configuración del agente.

Páginas Relacionadas​

  • Overview — panel de control del runtime con actividad reciente y tendencias de uso
  • Configure — habilidades, conocimiento, servidores MCP, canales y notificaciones por agente
  • Approvals — solicitudes de aprobación con intervención humana generadas durante las ejecuciones del agente
  • Notifications — fuente de notificaciones para eventos de actividad del agente
  • Connections — credenciales almacenadas vinculadas a habilidades y fuentes de datos