Agent Runtime
O Agent Runtime executa seu agente no compute serverless hospedado pelo Databricks. Ele executa o servidor do seu agente, como DurableAgentServer, no Databricks Apps, para que você implante o código em vez de fazer o provisionamento de servidores. Para saber como o Agent Runtime se encaixa com o seu framework e o servidor do agente, consulte Deploy agents on Databricks.
O que o Agent Runtime fornece
- A stable, authenticated endpoint : Each deployment is an app named
agent-bricks-<name>with its own URL. Clients authenticate with a Databricks OAuth tokens. See query agents implantado on Databricks. - Agent identity : o agente é executado como o service principal do aplicativo. Consulte Agent identity.
- Execução durável : para agentes que usam
DurableAgentServer, a implantação realiza o provisionamento de um Runtime Store para que o estado da execução sobreviva a reinicializações de workers 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 a Visão geral do rastreamento.
- Dimensionamento : Faça a execução de um agente em 1 a 5 instâncias. Consulte Dimensionamento horizontal para aplicativos do Databricks.
Identidade do agente
A identidade de um agente é o service principal do aplicativo no qual ele está implantado. O agente usa essa identidade para chamar as APIs do Databricks e para fazer execução de ferramentas que você adiciona com --auth app.
- Quando você faz o deploy, o
agentbricks deployconcede ao service principal acesso aos armazenamentos de estado de memória, sessão e execução usados pelo agente. - Para dar ao agente acesso a outros dados e recursos, conceda ao service principal do aplicativo as permissões de que ele precisa, como faria para qualquer aplicativo. Consulte Configurar a autorização em um aplicativo do Databricks.
- Ferramentas que usam
auth = "user"são executadas com as permissões do usuário que enviou a solicitação em vez do Service Principal. Consulte Autorização do usuário solicitante.
Implantar um agente
Deploy an agent project with the Agent Bricks CLI:
agentbricks --profile <profile> deploy my-agent
agentbricks deploy faz o seguinte:
- Cria ou reutiliza os armazenamentos de memória e sessão declarados em
agent.tomle concede ao Service Principal do aplicativo acesso a eles. - Para agentes que usam
DurableAgentServer, cria ou reutiliza o Runtime Store da implantação. - Configura o rastreamento.
- Implanta o aplicativo.
Para execução o agente em mais de uma instância, passe --instances:
agentbricks --profile <profile> deploy my-agent --instances 2
Quando um agente é executado em mais de uma instância, os clientes podem enviar o ID da sessão em um cabeçalho X-Routing-Key para encaminhar todas as solicitações de uma sessão para a mesma instância.
Gerenciar implantações
Comando | Descrição |
|---|---|
| Liste as implantações do seu agente. |
| Show a deployment's URL, status, and description. |
| Mostrar os Logs de um deployment. |
| Começar ou parar uma implantação. |
| Exclua uma implantação. |
Como cada implantação é um aplicativo, você também pode view e monitorá-lo no Databricks Apps. Consulte Registro e monitoramento para Databricks Apps.
Limitações
Não é possível alterar o servidor de agentes de uma implantação existente. Para alternar servidores, crie um novo projeto com a opção agentbricks init --server desejada e implante-o com um novo nome.