Compartir vía

Usa Agent Bricks: Supervisor multiagente para crear un sistema multiagente coordinado

Important

Esta característica se encuentra en su versión beta. Los administradores del área de trabajo pueden controlar el acceso a esta característica desde la página Vistas previas . Consulte Administración de versiones preliminares de Azure Databricks.

En esta página se describe cómo usar Agent Bricks: Multi-Agent Supervisor para crear un sistema de supervisor de varios agentes que organice los agentes de IA y las herramientas para trabajar juntos en tareas complejas. Puede mejorar su coordinación basándose en los comentarios de lenguaje natural realizados por sus expertos en la materia.

Agent Bricks proporciona un enfoque sencillo para crear y optimizar sistemas de agentes de inteligencia artificial comunes específicos de un dominio y de alta calidad para casos de uso comunes de inteligencia artificial.

¿Qué es Agent Bricks: Supervisor multiagente?

Use Agent Bricks: Supervisor multiagente para crear un sistema supervisor que coordine Genie Spaces, puntos de conexión de agentes, funciones del Catálogo de Unity y servidores MCP para que trabajen juntos y completen tareas complejas a través de diferentes dominios especializados. El Supervisor de varios agentes usa patrones avanzados de orquestación de IA para administrar interacciones del agente, delegación de tareas y síntesis de resultados para ofrecer soluciones completas.

Agent Bricks: El Supervisor multiagente construye el sistema para usted y permite mejorarlo con el tiempo con comentarios humanos. Es ideal para soportar los siguientes casos de uso:

  • Proporcione análisis de mercado e información mediante la búsqueda en informes de investigación y datos de uso.
  • Responda a preguntas sobre los procesos internos y automatice una reserva de tickets.
  • Acelere el servicio al cliente contestando a las políticas, las preguntas frecuentes, las cuestiones de cuenta y otras consultas.

El Supervisor multiagente le permite mejorar la calidad de coordinación del supervisor y ajustar el comportamiento del agente en función de los comentarios del lenguaje natural de los expertos en la materia. Proporcione ejemplos e instrucciones para optimizar el rendimiento del sistema.

El Supervisor de Varios Agentes crea un punto de conexión completo que puede usar posteriormente para sus aplicaciones. Por ejemplo, puede interactuar con el endpoint enviando mensajes en Playground o creando una aplicación de chat usando las aplicaciones de Databricks. El supervisor tiene controles de acceso integrados, de modo que sus usuarios finales solo accedan a los subagentes y los datos a los que tienen acceso.

Agent Bricks usa el almacenamiento predeterminado para almacenar transformaciones de datos temporales, puntos de control de modelo y metadatos internos que potencian a cada agente. En la eliminación del agente, todos los datos asociados al agente se quitan del almacenamiento predeterminado.

Requirements

Creación de un sistema de supervisor de varios agentes

Vaya al icono Agentes.Agentes en el panel de navegación izquierdo del área de trabajo. En el mosaico Multi-Agent Supervisor, haga clic en Build.

Paso 1: Crear subagentes y conceder permisos

Advertencia

La ejecución de código arbitrario en una herramienta de agente puede exponer información confidencial o privada a la que el agente tiene acceso. Los clientes son responsables de ejecutar solo código de confianza e implementar límites de protección y permisos adecuados para evitar el acceso no deseado a los datos.

Como Agent Bricks: Multi-Agent Supervisor crea un sistema de supervisores que coordina los subagentes para trabajar juntos para completar tareas complejas, primero debe proporcionar subagentes para que se coordinen. Estos subagentes pueden ser Genie Spaces, puntos de conexión del agente de Knowledge Assistant, funciones de Catálogo de Unity o servidores MCP. También debe conceder a los usuarios finales acceso explícito a cada subagente para que el supervisor devuelva respuestas útiles de ese subagente.

Espacio de Genie

  1. Para crear un espacio de Genie, siga los pasos descritos en Configuración y administración de un espacio de AI/BI Genie.
  2. Conceda a los usuarios finales acceso tanto al espacio de Genie como a sus objetos subyacentes del catálogo de Unity. Siga los pasos descritos en Compartir un espacio de Genie.

Punto de conexión del agente

  1. Para crear un agente de Knowledge Assistant, siga los pasos descritos en Use Agent Bricks: Knowledge Assistant para crear un bot de chat de alta calidad a través de los documentos.
  2. Conceda a los usuarios finales el CAN QUERY permiso en el punto de conexión del agente de Knowledge Assistant.

La función de catálogo de Unity

  1. Para crear funciones de Catálogo de Unity como herramientas del agente de IA, siga los pasos descritos en Creación de herramientas de agente de IA mediante funciones del catálogo de Unity (heredadas).
  2. Conceda a los usuarios finales el EXECUTE permiso en la función de Unity Catalog.

Servidor MCP externo

  1. Para instalar un servidor MCP desde Databricks Marketplace, consulte Obtener acceso a servidores MCP externos. Para configurar servidores MCP externos, siga los pasos descritos en Uso de servidores MCP externos. La conexión debe usar la autenticación de token de portador o la autenticación de máquina a máquina de OAuth. Consulte Métodos de autenticación para servicios externos.
  2. Conceda a los usuarios finales el USE CONNECTION permiso en la conexión del catálogo de Unity.

Paso 2: Configurar el supervisor

En la pestaña Compilar, configure el supervisor y agregue los agentes que coordinará.

Note

El supervisor tiene controles de acceso integrados, de modo que sus usuarios finales solo accedan a los subagentes y los datos a los que tienen acceso.

  • Para los puntos de conexión del agente, los usuarios finales requieren el CAN QUERY permiso en el punto de conexión.
  • En el caso de los espacios de Genie, los usuarios finales requieren acceso tanto al espacio de Genie como a los datos de sus objetos del Catálogo Unity subyacente. Consulte Compartir un espacio de Genie.
  • En el caso de las funciones del catálogo de Unity, los usuarios finales requieren el EXECUTE permiso para la función.
  • En el caso de los servidores MCP externos, los usuarios finales requieren el USE CONNECTION permiso para la conexión del catálogo de Unity.

Si el usuario final no tiene acceso a ningún subagente, el supervisor finalizará la conversación. Si el usuario final tiene acceso a algunos, pero no a todos los subagentes, el supervisor redirigirá la conversación fuera de los subagentes al que el usuario no puede acceder.

  1. En el campo Nombre , escriba un nombre para el agente de supervisor.

  2. En el campo Descripción , describa lo que puede hacer el sistema supervisor.

  3. En Configurar agentes, seleccione hasta 10 agentes o herramientas.

    Espacio de Genie

    Para proporcionar un espacio de Genie:

    1. En el campo Tipo, seleccione Genie Space.

    2. Seleccione el espacio de Genie en el menú desplegable Espacio de Genie .

    3. El nombre del agente y Describe los campos de contenido se rellenan automáticamente cuando sea posible. Si lo desea, puede editar el nombre y la descripción.

      El supervisor usa la información de la descripción para ayudar a coordinar agentes. Proporcione tantos detalles como sea posible para ayudar a mejorar su delegación de tareas.

    Para obtener más información sobre los espacios de Genie, consulte ¿Qué es un espacio de AI/BI Genie? Para configurar un espacio de Genie, consulte Configuración y administración de un espacio de AI/BI Genie.

    Punto de conexión del agente

    Para proporcionar un endpoint de agente:

    1. En el campo Tipo , seleccione Punto de conexión del agente.
    2. Seleccione el punto de conexión del Agent Endpoint en el menú desplegable. Solo son compatibles los puntos de conexión de agente que han sido creados a través de Agent Bricks: Knowledge Assistant.
    3. El campo Nombre del agente se rellena automáticamente. Si lo desea, puede editarlo.
    4. En Describir el contenido, describa lo que puede hacer este agente para ayudar al supervisor a comprender cuándo delegar tareas a este agente.

    La función de catálogo de Unity

    Para proporcionar una función de catálogo de Unity:

    1. En el campo Tipo , seleccione Función de catálogo de Unity.
    2. Seleccione la función en el menú desplegable Función de catálogo de Unity .
    3. En el campo Nombre del agente , proporcione un nombre para esta herramienta.
    4. En Describir el contenido, describa lo que hace esta función y cuándo se debe usar. Esto ayuda al supervisor a comprender cuándo usar esta herramienta.

    Para obtener más información sobre cómo crear funciones de catálogo de Unity como herramientas de agente, consulte Creación de herramientas de agente de IA mediante funciones del catálogo de Unity (heredadas).

    Servidor MCP externo

    Para proporcionar un servidor MCP externo:

    1. En el campo Tipo , seleccione Servidor MCP externo.
    2. Seleccione la conexión en el menú desplegable Conexión del catálogo de Unity .
    3. En el campo Nombre del agente , proporcione un nombre para este servidor MCP.
    4. En Describir el contenido, describa lo que proporciona este servidor MCP y cuándo se debe usar. Esto ayuda al supervisor a comprender cuándo delegar en este servidor.

    Para obtener más información sobre los servidores MCP externos, consulte Uso de servidores MCP externos.

  4. (Opcional) Para agregar más agentes, haga clic en + Agregar. Puede suministrar hasta 10 agentes.

  5. (Opcional) En el campo Instrucciones , especifique las directrices para cómo debe responder el supervisor de varios agentes.

  6. Haga clic en Crear agente.

Se le redirigirá a la pestaña Configurar. La creación de su sistema multiagente y el agente supervisor puede tardar desde unos minutos hasta unas horas.

Paso 3: Probar el agente de supervisor

Una vez que el supervisor haya terminado de compilarse, pruébelo para ver si el supervisor coordina varios agentes para controlar tareas complejas. En Probar tu agente en el panel derecho, chatea con el agente para evaluar sus respuestas.

  1. (Opcional) También puede probar el agente en AI Playground. Haga clic en Abrir en área de juegos. Esto abre AI Playground con el punto de conexión del supervisor conectado. Si tiene habilitadas las características de asistencia de IA, puede habilitar la generación de tareas de ai Judge y Synthetic para ayudarle a evaluar el supervisor.
  2. En Probar el agente o en AI Playground, escriba una tarea compleja para el supervisor.
  3. Evalúe su respuesta. Asegúrese de que el supervisor delega correctamente las tareas a los agentes adecuados.
  4. En función de las respuestas del agente, ajuste los campos Descripción e Instrucciones del panel izquierdo para mejorar su configuración.
  5. Haga clic en Actualizar agente.

Si está satisfecho con el rendimiento del supervisor, siga usando el supervisor as-is.

Paso 4: Mejorar el supervisor

Agente Bricks: El supervisor multi-agente puede ajustar su comportamiento en función de los comentarios basados en lenguaje natural. Recopile comentarios de expertos a través de la página de configuración para mejorar la calidad de coordinación del supervisor. Recopilar datos etiquetados para el supervisor puede mejorar su rendimiento. Agent Bricks reentrenará y optimizará el supervisor a partir de los nuevos datos.

En la pestaña Ejemplos , agregue preguntas y escenarios de tareas para el supervisor.

  1. Añadir preguntas a la etiqueta:

    1. Haga clic en + Agregar para agregar una pregunta.
    2. En el modal Agregar una pregunta , escriba su pregunta.
    3. Haga clic en Agregar. La pregunta debe aparecer en la interfaz de usuario.
    4. Repita hasta que haya agregado todas las preguntas que desea evaluar.
    5. Para eliminar una pregunta, haga clic en el menú kebab y, a continuación, en Eliminar.

  2. Una vez que haya terminado de agregar sus preguntas, puede compartir el agente con otros usuarios para revisar para ayudarle a crear un conjunto de datos etiquetado de alta calidad. Comparta un vínculo a la página de configuración de Agent Bricks: Multi-Agent Supervisor para recopilar comentarios de expertos.

  3. Asegúrese de que los expertos tengan acceso al agente supervisor y a los subagentes adecuados:

    1. En la esquina superior derecha, haga clic en el icono del menú kebab. para administrar los permisos. Conceda a los expertos CAN_MANAGE permisos para que puedan acceder al agente y proporcionar comentarios.
    2. Asegúrese de que el SME tiene acceso a los subagentes adecuados:
      • Para cada espacio de Genie, conceda al SME todos los permisos adecuados para interactuar con el espacio. Consulte Compartir un espacio de Genie.
      • Para cada punto de conexión del agente, conceda al SME el CAN QUERY permiso.
      • Para cada función de Unity Catalog, otorgue al SME el permiso EXECUTE sobre la función.
      • Para cada servidor MCP externo, conceda al SME el USE CONNECTION permiso en la conexión del Unity Catalog.

    Si el SME no tiene acceso a ningún subagente, el supervisor finalizará la conversación. Si el usuario final tiene acceso a algunos, pero no a todos los subagentes, el supervisor redirigirá la conversación fuera de los subagentes al que el usuario no puede acceder.

  4. Para etiquetar los datos, haga clic en una pregunta y agregue Directrices en el panel que aparece. Las directrices se aplican justo después de guardarlas.

  5. Vuelva a probar el agente en la página de configuración o ai Playground para ver su rendimiento mejorado. Si es necesario, agregue más preguntas e instrucciones para seguir mejorando el comportamiento.

Administración de permisos

De forma predeterminada, solo los autores de Agent Bricks y los administradores del área de trabajo tienen permisos para el agente. Para permitir que otros usuarios editen o consulten el agente, debe concederles explícitamente permiso.

Para administrar permisos de tu agente:

  1. Abra su agente en Agent Bricks.
  2. En la parte superior, haga clic en el icono de menú Kebab. Menú kebab.
  3. Haga clic en Administrar permisos.
  4. En la ventana Configuración de permisos , seleccione el usuario, el grupo o la entidad de servicio.
  5. Seleccione el permiso para conceder:
    • Puede administrar: permite gestionar los Agent Bricks, incluida la configuración de permisos, la edición de la configuración del agente y la mejora de su calidad.
    • Can Query: permite consultar el punto de conexión de Agent Bricks en AI Playground y a través de la API. Los usuarios con solo este permiso no pueden ver ni editar el agente en Agent Bricks.
  6. Haga clic en Agregar.
  7. Haz clic en Guardar.

Note

En el caso de los puntos de conexión del agente creados antes del 16 de septiembre de 2025, puede conceder permisos can Query al punto de conexión desde la página Puntos de conexión de servicio.

Consulta el punto de conexión del agente

En la página del agente, haga clic en el icono Modelo de servicio. Consulte Estado del agente en la esquina superior derecha para obtener el punto de conexión del agente implementado y ver los detalles del punto de conexión.

Hay varias maneras de consultar el punto de conexión del supervisor multiagente creado. Use los ejemplos de código proporcionados en AI Playground como punto de partida.

  1. En la pestaña Compilar, haga clic en Abrir en el entorno de prueba.
  2. En Parque infantil, haga clic en Obtener código.
  3. Elija cómo desea usar el punto de conexión:
    • Seleccione Curl API para ver un ejemplo de código para consultar el punto de conexión mediante curl.
    • Seleccione API de Python para ver un ejemplo de código para interactuar con el punto de conexión mediante Python.

Limitations

  • Last updated on