Pular para o conteúdo principal
Última atualização em

Use Agent Bricks: Supervisor de vários agentes para criar um sistema multiagente coordenado

info

Beta

Este recurso está em versão Beta. Os administradores do espaço de trabalho podem controlar o acesso a este recurso na página de Pré-visualizações . Veja as prévias do Gerenciador Databricks.

Esta página descreve como utilizar o Agent Bricks: Multi-Agent Supervisor para criar um sistema supervisor multiagente que coordena agentes e ferramentas de AI para trabalharem em conjunto em tarefas complexas. Você pode melhorar a coordenação deles com base no feedback em linguagem natural de seus especialistas no assunto.

O Agent Bricks oferece uma abordagem simples para construir e otimizar sistemas de agentes de inteligência artificial ( AI ) específicos para cada domínio e de alta qualidade para casos de uso comuns de inteligência artificial ( AI ).

O que é Agent Bricks: Multi-Agent Supervisor?​

Use o Agent Bricks: Multi-Agent Supervisor para criar um sistema supervisor que coordene Genie Spaces, endpoints de agentes, funções Unity Catalog e servidores MCP para trabalharem juntos na conclusão de tarefas complexas em diferentes domínios especializados. O Supervisor Multiagente usa padrões avançados de orquestração AI para gerenciar interações de agentes, delegação de tarefas e síntese de resultados para fornecer soluções abrangentes.

Agent Bricks: O Multi-Agent Supervisor cria o sistema para você e permite que você o aprimore ao longo do tempo com feedback humano. É ideal para dar suporte aos seguintes casos de uso:

  • Forneça análises e percepções de mercado pesquisando relatórios de pesquisa e dados de uso.
  • Responda perguntas sobre processos internos e automatize a lista de pendências de tickets.
  • Acelere o atendimento ao cliente respondendo a perguntas sobre políticas, perguntas frequentes, account e outras questões.

O Supervisor Multiagente permite que você melhore a qualidade da coordenação do supervisor e ajuste o comportamento do agente com base no feedback em linguagem natural de seus especialistas no assunto. Forneça exemplos e diretrizes para otimizar o desempenho do sistema.

O Multi-Agent Supervisor cria uma infraestrutura de agentes ( endpoint ) abrangente que pode ser utilizada posteriormente para suas aplicações. Por exemplo, é possível interagir com o endpoint enviando prompts no Playground ou criar um aplicativo de chat usando o Databricks Apps. O supervisor possui controles de acesso integrados, de modo que seus usuários finais acessam apenas os subagentes e os dados aos quais têm acesso.

O Agent Bricks utiliza o armazenamentodefault para guardar transformações de dados temporárias, pontos de verificação do modelo e metadados internos que alimentam cada agente. Ao excluir um agente, todos os dados associados a ele são removidos do armazenamento default .

Requisitos​

Crie um sistema supervisor multiagente​

Vá para Ícone de agentes. Agentes no painel de navegação à esquerda do seu workspace. No bloco Supervisor Multiagente , clique em Construir .

Etapa 1: criar subagentes e conceder permissões​

atenção

Executar código arbitrário em uma ferramenta de agente pode expor informações confidenciais ou privadas às quais o agente tem acesso. Os clientes são responsáveis por executar apenas código confiável e implementar proteções e permissões adequadas para evitar acesso não intencional aos dados.

Como o Agent Bricks: Multi-Agent Supervisor cria um sistema de supervisão que coordena subagentes para trabalharem juntos na conclusão de tarefas complexas, você precisa primeiro fornecer os subagentes para que ele possa coordená-los. Esses subagentes podem ser Genie Spaces, endpoints de agentes do Knowledge Assistant, funções Unity Catalog ou servidores MCP. Você também precisa conceder aos usuários finais acesso explícito a cada subagente para que o supervisor retorne respostas úteis desse subagente.

  1. Para criar um espaço Genie, siga as etapas em Configurar e gerenciar um espaço AI/BI Genie.
  2. Conceda aos usuários finais acesso tanto ao espaço Genie quanto aos objetos Unity Catalog subjacentes. Siga as etapas em Compartilhar um espaço Genie.

Etapa 2: configurar seu supervisor​

Na tab "Construir" , configure seu supervisor e adicione os agentes que ele coordenará.

nota

O supervisor possui controles de acesso integrados, de forma que seus usuários finais acessem apenas os subagentes e os dados aos quais têm permissão.

  • Para o endpoint do agente, os usuários finais precisam da permissão CAN QUERY no endpoint.
  • Para Genie spaces, os usuários finais precisam ter acesso tanto ao espaço Genie quanto aos dados dos objetos Unity Catalog subjacentes. Veja Compartilhe um espaço Genie.
  • Para funções Unity Catalog , os usuários finais precisam da permissão EXECUTE na função.
  • Para servidores MCP externos, os usuários finais precisam da permissão USE CONNECTION na conexão Unity Catalog .

Caso o usuário final não tenha acesso a nenhum subagente, o supervisor encerrará a conversa. Se o usuário final tiver acesso a alguns, mas não a todos os subagentes, o supervisor redirecionará a conversa para longe dos subagentes aos quais o usuário não tem acesso.

  1. No campo Nome , insira um nome para seu agente supervisor.

  2. No campo Descrição , descreva o que seu sistema supervisor pode fazer.

  3. Em Configurar Agentes , selecione até 10 agentes e/ou ferramentas.

Para disponibilizar um espaço Genie:

  1. No campo Tipo , selecione Genie Space .

  2. Selecione o seu espaço Genie no menu suspenso Espaço Genie .

  3. Os campos Nome do agente e Descreva o conteúdo são preenchidos automaticamente quando possível. Você pode editar o nome e a descrição, se desejar.

    O supervisor utiliza as informações contidas na descrição para auxiliar na coordenação dos agentes. Forneça o máximo de detalhes possível para ajudar a melhorar a delegação da tarefa.

Para saber mais sobre o Genie spaces, consulte O que é um AI/BI Genie. Para configurar um Genie espaço, consulte Configurar e gerenciar um AI/BI Genie espaço.

  1. (Opcional) Para adicionar mais agentes, clique em + Adicionar . Você pode fornecer até 10 agentes.

  2. (Opcional) No campo Instruções , especifique as diretrizes de como o supervisor multiagente deve responder.

  3. Clique em Criar agente .

Você será redirecionado para a página Configurar o tab. A criação do sistema multiagente e do agente supervisor pode levar de alguns minutos a algumas horas.

Etapa 3: teste seu agente supervisor​

Após o supervisor terminar a construção, teste-o para verificar o quão bem ele coordena vários agentes para lidar com tarefas complexas. Na seção "Testar seu agente", no painel lateral direito, converse com o agente para avaliar suas respostas.

  1. (Opcional) Você também pode testar o agente no AI Playground. Clique em Abrir no Playground . Isso permite o acesso ao AI Playground com o seu endpoint de supervisão conectado. Se você tiver o recurso de assistência AI ativado, poderá habilitar o JuizAI e a geração de tarefas sintéticas para ajudá-lo a avaliar seu supervisor.
  2. Em Testar seu agente ou no AI Playground, insira uma tarefa complexa para seu supervisor.
  3. Avalie sua resposta. Certifique-se de que o supervisor delegou a tarefa aos agentes adequados.
  4. Com base nas respostas do seu agente, ajuste os campos Descrição e Instruções no painel lateral esquerdo para melhorar a configuração.
  5. Clique em Atualizar agente .

Se estiver satisfeito com o desempenho do seu supervisor, continue a utilizá-lo como está.

Etapa 4: melhorar o supervisor​

Agent Bricks: O supervisor multiagente pode ajustar o comportamento do supervisor com base no feedback em linguagem natural. Obtenha feedback de especialistas através da página de configuração para melhorar a qualidade da coordenação do seu supervisor. A coleta de dados de rótulos para seu supervisor pode melhorar seu desempenho. O Agent Bricks irá treinar e otimizar o supervisor com base nos novos dados.

Na tab Exemplos , adicione perguntas e cenários de tarefas para o supervisor.

  1. Adicionar perguntas ao rótulo:

    1. Clique em + Adicionar para adicionar uma pergunta.
    2. Na janela "Adicionar uma pergunta" , insira sua pergunta.
    3. Clique em Adicionar . A pergunta deve aparecer na interface do usuário.
    4. Repita o processo até adicionar todas as perguntas que deseja avaliar.
    5. Para excluir uma pergunta, clique no menu kebab e depois em Excluir.

  2. Depois de adicionar suas perguntas, você pode compartilhar o agente com outras pessoas para que elas revisem e ajudem a criar um dataset de rótulos de alta qualidade. Compartilhe o link da sua página de configuração do Agent Bricks: Multi-Agent Supervisor para coletar feedback de especialistas.

  3. Garantir que os especialistas tenham acesso ao agente supervisor e aos subagentes apropriados:

    1. No canto superior direito, clique no menu de kebabs.Ícone do menu Kebab. para gerenciar permissões. Conceda aos especialistas permissões CAN_MANAGE para que eles possam acessar o agente e fornecer feedback.
    2. Garanta que o SME tenha acesso aos subagentes apropriados:
      • Para cada espaço Genie, conceda à PME todas as permissões necessárias para interagir com o espaço. Consulte o espaço Compartilhar um Genie.
      • Para cada agente endpoint, conceda à PME a permissão CAN QUERY.
      • Para cada função Unity Catalog , conceda ao especialista no assunto a permissão EXECUTE na função.
      • Para cada servidor MCP externo, conceda ao SME a permissão USE CONNECTION na conexão Unity Catalog .

    Se o SME não tiver acesso a nenhum subagente, o supervisor encerrará a conversa. Se o usuário final tiver acesso a alguns subagentes, mas não a todos, o supervisor redirecionará a conversa para fora dos subagentes que o usuário não pode acessar.

  4. Para etiquetar os dados, clique em uma pergunta e adicione as diretrizes no painel que aparece. As diretrizes entram em vigor imediatamente após serem salvas.

  5. Teste o agente novamente na página de configuração ou no AI Playground para verificar seu desempenho aprimorado. Se necessário, adicione mais perguntas e orientações para continuar a melhorar o comportamento.

gerenciar permissões​

Por default, somente os autores do Agent Bricks e os administradores workspace têm permissões para acessar o agente. Para permitir que outros usuários editem ou consultem seu agente, você precisa conceder-lhes permissão explicitamente.

Para gerenciar as permissões do seu agente:

  1. Abra sua agência no Agent Bricks.

  2. Na parte superior, clique em Ícone do menu Kebab. Cardápio de kebabs.

  3. Clique em gerenciar permissões .

  4. Na janela Configurações de Permissão , selecione o usuário, grupo ou entidade de serviço.

  5. Selecione a permissão que deseja conceder:

    • Gerenciar : Permite gerenciar os Agent Bricks, incluindo definir permissões, editar a configuração do agente e melhorar sua qualidade.
    • Permissão para consulta : Permite consultar o endpoint do Agent Bricks no AI Playground e por meio da API. Usuários com apenas essa permissão não podem view ou editar o agente no Agent Bricks.

  6. Clique em Adicionar .

  7. Clique em Salvar .

nota

Para endpoints de agente criados antes de 16 de setembro de 2025 , você pode conceder permissões de "Pode consultar" ao endpoint na página "Endpoint de serviço" .

Consultar o agente endpoint​

Na página do agente, clique servindo modelo ícone. Consulte o status do agente no canto superior direito para obter o endpoint do agente implantado e visualizar os detalhes do endpoint.

Existem várias maneiras de consultar o endpoint do supervisor multiagente criado. Utilize os exemplos de código fornecidos no AI Playground como ponto de partida.

  1. Na tab Construir , clique em Abrir no playground .
  2. No Playground, clique em Obter código .
  3. Escolha como o senhor deseja usar o endpoint:
    • Selecione Curl API para obter um exemplo de código para consultar o endpoint usando curl.
    • Selecione Python API para obter um exemplo de código para interagir com o endpoint usando Python.

Limitações​