Execução do Agente

O Agent Runtime executa o seu agente em capacidade de computação sem servidor alojada pelo Azure Databricks. Executa o teu servidor agente, como DurableAgentServer, nas aplicações Databricks, por isso implementas código em vez de provisionar servidores. Para saber como o Agent Runtime se encaixa no seu framework e servidor de agentes, veja Deploy agents no Azure Databricks.

O que o Agent Runtime oferece

  • Um endpoint estável e autenticado: Cada implementação é uma aplicação chamada agent-bricks-<name> com o seu próprio URL. Os clientes autenticam-se com um token OAuth do Azure Databricks. Consulte Agentes de consulta implementados no Azure Databricks.
  • Identidade do agente: O agente funciona como service principal da aplicação. Ver Identidade do agente.
  • Execução duradoura: Para agentes que utilizam DurableAgentServer, a implantação prevê um Runtime Store para que o estado da execução sobreviva aos reinícios dos trabalhadores e as execuções interrompidas possam ser recuperadas.
  • Rastreamento: A implantação configura o rastreamento do MLflow para o experimento ao qual o projeto se vincula. Consulte Descrição geral do rastreio.
  • Dimensionamento: Execute um agente em 1 a 5 instâncias. Veja Escalonamento horizontal para aplicações Databricks.

Identidade do agente

A identidade de um agente é o service principal da aplicação onde está implementado. O agente usa esta identidade para chamar APIs do Azure Databricks e para executar ferramentas que o utilizador adiciona com --auth app.

  • Quando implementas, agentbricks deploy concede ao service principal acesso aos armazenamentos de memória, sessão e estado de execução que o agente utiliza.
  • Para dar ao agente acesso a outros dados e recursos, conceda ao service principal da aplicação as permissões necessárias, tal como faria com qualquer aplicação. Consulte Configurar autorização em um aplicativo Databricks.
  • As ferramentas que usam auth = "user" funcionam com as permissões do utilizador que enviou o pedido em vez do service principal. Consulte autorização de utilizador do pedido.

Implementar um agente

Implemente um projeto de agente com a CLI Agent Bricks:

agentbricks --profile <profile> deploy my-agent

agentbricks deploy faz o seguinte:

  1. Cria ou reutiliza os armazenamentos de memória e de sessão declarados em agent.toml, e concede ao principal de serviço da aplicação acesso aos mesmos.
  2. Para agentes que utilizam DurableAgentServer, cria ou reutiliza o Runtime Store da implantação.
  3. Configura o rastreio.
  4. Implementa a aplicação.

Para executar o agente em mais do que uma instância, passe --instances:

agentbricks --profile <profile> deploy my-agent --instances 2

Quando um agente é executado em mais do que uma instância, os clientes podem enviar o ID da sessão num X-Routing-Key cabeçalho para encaminhar todos os pedidos de uma sessão para a mesma instância.

Gerir implantações

Comando Description
agentbricks deployments list Liste as implantações dos teus agentes.
agentbricks deployments get <app-name> Mostrar o URL, o estado e a descrição de uma implementação em produção.
agentbricks deployments logs <app-name> Mostra os registos de uma implementação.
agentbricks deployments start <app-name> e agentbricks deployments stop <app-name> Inicie ou pare uma implementação.
agentbricks deployments delete <app-name> Exclua uma implementação.

Como cada implementação é uma aplicação, também pode visualizá-la e monitorizá-la no Databricks Apps. Consulte Registro e monitoramento de aplicativos Databricks.

Limitations

Não podes alterar o servidor agente de uma implantação existente. Para mudar de servidor, cria um novo projeto com a agentbricks init --server opção que queres e publica-o com um novo nome.

Recursos adicionais

  • Última atualização a