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

Crie um agente personalizado usando a API do Supervisor (Beta)

info

Beta

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

Você pode criar um agente do Databricks Apps que usa a API Supervisor (Beta) para orquestração, em vez de gerenciar o loop do agente em seu próprio código. O resultado é o mesmo que criar um agente personalizado: um aplicativo implantado com uma interface de bate-papo, um endpoint /invocations e autenticação. A diferença é que Databricks executa o loop do agente para você. Seu agent.py faz uma única chamada de API e o Databricks lida com a seleção da ferramenta, execução e síntese da resposta.

A API do Supervisor funciona com qualquer um dos modelos básicos suportados. Altere o campo model para trocar de provedor sem alterar as definições da sua ferramenta ou a lógica do manipulador.

Quando usar a API do Supervisor​

A API Supervisor funciona bem quando seu agente usa apenas ferramentas hospedadas no Databricks e não precisa de lógica personalizada entre as chamadas de ferramentas. Utilize um loop de agente personalizado se o seu agente exigir alguma das seguintes funcionalidades:

  • Ferramentas de função do lado do cliente (a API do Supervisor não pode misturar ferramentas hospedadas e do lado do cliente em uma única solicitação)
  • Ponto de extremidade do agente diferente do ponto de extremidade do Assistente de Conhecimento do Agent Bricks
  • Recuperadores personalizados, entradas/saídas personalizadas ou controle de transmissão preciso.
  • Lógica personalizada em Python entre chamadas de ferramentas, como ramificação condicional ou gerenciamento de estado.
  • Controle sobre parâmetros de inferência como temperature

Para obter a referência completa da API e os parâmetros suportados, consulte a API do Supervisor (Beta).

Requisitos​

Crie um agente personalizado usando a API do Supervisor.​

O ponto de partida recomendado é criar um novo aplicativo a partir do padrão de aplicativo mais recenteDatabricks. O padrão mais recente inclui uma habilidade integrada use-supervisor-api para assistentes de codificação AI , bem como uma habilidade add-tools para adicionar ferramentas hospedadas.

Para criar um novo aplicativo a partir de um padrão, consulte Criar um agente AI e implantá-lo no Databricks Apps.

Após configurar seu aplicativo com base no padrão mais recente, abra o projeto em seu assistente de codificação AI e execute-o:

Use the Supervisor API skill to update this agent to use the Databricks Supervisor API.

A habilidade atualiza seu agent_server/agent.py para chamar DatabricksOpenAI().responses.create() com ferramentas hospedadas, substituindo o loop manual do agente. Também adiciona a dependência databricks-openai e observa as limitações beta.

O resultado é o mesmo aplicativo implantado, com uma interface de bate-papo, autenticação e um endpoint /invocations , mas com um código de agente mais simples. Para o fluxo de trabalho completo de implantação (implantado no Apps, adicionar ferramentas, avaliar), consulte Criar um agente AI e implantá-lo no Databricks Apps.

Ferramentas e parâmetros suportados​

Para obter a lista completa de tipos de ferramentas compatíveis, parâmetros de solicitação e exemplos de código, consulte a API do Supervisor (Beta).

Para cada ferramenta que você adicionar, conceda também a permissão de recurso correspondente em databricks.yml. Veja a habilidade add-tools em .claude/skills/ para exemplos.

Próximos passos​

Nesta página