Saltar al contenido principal

Agentes Preconstruidos

El catálogo de Agentes se encuentra bajo el encabezado Hub · Catalog y se describe como "Agentes listos para usar en flujos de trabajo empresariales comunes — importación con un clic en Studio." Cada agente es un asistente de IA completamente configurado y listo para producción, empaquetado para un caso de uso empresarial específico. Los equipos navegan por el catálogo aquí, revisan las capacidades y la documentación del agente, y luego lo instalan desde el Marketplace en el Runtime que lo alojará.

Tres paneles de estadísticas sobre la cuadrícula de tarjetas resumen el estado actual del catálogo:

  • Agentes publicados — Recuento total de entradas de agentes en el catálogo.
  • Total de capacidades — Suma de todas las capacidades declaradas en todos los agentes publicados.
  • Categorías — Recuento de categorías distintas en uso en el catálogo.

Búsqueda y Filtrado​

Una barra de búsqueda y un filtro de categorías se encuentran sobre la cuadrícula de tarjetas:

  • Buscar en el catálogo — Filtra las tarjetas en tiempo real por nombre de agente o eslogan. La entrada coincide con cadenas parciales sin distinción de mayúsculas y minúsculas.
  • Filtro de categorías — Un conjunto de botones tipo pastilla, uno por cada categoría distinta presente en el catálogo. Al seleccionar una categoría, la cuadrícula se reduce a las entradas de esa categoría únicamente. Al seleccionar la misma categoría nuevamente, se muestran todas las entradas.

Cada agente está representado por una tarjeta en una cuadrícula adaptable (una columna en móvil, dos en tableta, tres en pantallas anchas). La superficie de la tarjeta muestra:

  • Encabezado de categoría — La etiqueta de categoría del agente, renderizada con el color de acento de la categoría.
  • Nombre del agente — El identificador principal del agente.
  • Eslogan — Una descripción en una línea del propósito del agente.
  • Insignias de modo de invocación — Una insignia por canal compatible. Valores posibles: Chat, API, A2A, Copilot, Teams, Studio.
  • Recuento de capacidades — Se muestra en la parte inferior de la tarjeta junto con la cadena de versión en el formato N capabilities · vX.Y.
  • Enlace View — Abre la página de detalle del agente.

Página de Detalle del Agente​

Al hacer clic en cualquier tarjeta se accede a la página de detalle del agente. El encabezado muestra el nombre del agente, el encabezado de categoría, el eslogan, la versión, el recuento de capacidades y las insignias de modo de invocación del agente. Un enlace Back to catalog regresa a la cuadrícula.

Pestañas de Detalle​

Tres pestañas organizan el contenido de detalle del agente:

  • Overview — Renderiza la descripción completa del agente en formato markdown.
  • Capabilities — Lista todas las capacidades declaradas por el agente. Cada fila de capacidad muestra el nombre de la capacidad y su descripción.
  • Docs — Renderiza la documentación extendida del agente en formato markdown.

Instalación de un Agente​

Beak Hub es el catálogo. La instalación ocurre desde el Runtime que alojará el agente, no desde aquí.

Para instalar un agente, abra Marketplace en el Beak AI Runtime del inquilino de destino, elija la pestaña Agents e instálelo allí. El agente se crea en ese Runtime y a partir de entonces se comporta como cualquier otro agente en él — aparece en la lista de agentes del Runtime, se configura allí y está regido por las políticas de aprobación de ese Runtime.

Nota: Las versiones anteriores de Hub incluían una acción Deploy to Runtime en esta página, con el Runtime de destino configurado en una pantalla de ajustes de Hub. Ese flujo ha sido reemplazado: ahora el Runtime extrae del catálogo de Hub en lugar de que Hub envíe a un Runtime. No existe ninguna acción de despliegue ni ninguna URL de Runtime para configurar en Hub actualmente.

Modos de Invocación​

Los agentes declaran los canales a través de los cuales pueden ser invocados. Las insignias en la tarjeta del catálogo y en el encabezado de detalle reflejan estos modos:

  • Chat — El agente es accesible a través de la interfaz de chat del Runtime.
  • API — El agente expone un endpoint de API directo.
  • A2A — El agente admite el protocolo Agente-a-Agente para llamadas de máquina a máquina.
  • Copilot — El agente puede publicarse como agente de Microsoft Copilot mediante el modo de paso a través en el Runtime.
  • Teams — El agente puede exponerse como un bot de Microsoft Teams.
  • Studio — El agente puede importarse en Beak AI Studio.

Buenas Prácticas​

  • Revise la pestaña Capabilities antes de instalar un agente para confirmar que cubre el caso de uso que necesita; las descripciones de capacidades explican qué hace cada función.
  • Instale en un Runtime de prueba antes de implementar en inquilinos de producción; un agente instalado está disponible de inmediato para todos los que puedan verlo.
  • Los agentes que admiten A2A pueden encadenarse con otros agentes en flujos de trabajo de Beak AI Studio sin requerir intervención humana.
  • La pestaña Docs a menudo contiene pasos de configuración previos para skills, fuentes de datos o servidores MCP de los que depende el agente — léala antes de instalar para evitar brechas de credenciales en el Runtime.
  • Los agentes se instalan desde el Marketplace del Runtime, no desde Hub. Si el Marketplace no es visible allí, el operador no tiene el permiso de instalación del marketplace.

Páginas Relacionadas​

  • Overview — Página de inicio de Beak Hub y resumen del catálogo.
  • MCP Servers — Servidores MCP preconstruidos que los agentes utilizan como herramientas.
  • Agent Suites — Paquetes seleccionados que incluyen múltiples agentes junto con skills y fuentes de datos.
  • Marketplace — Donde los agentes de este catálogo se instalan en un Runtime.