Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Agent Runtime roda seu agente em computação serverless hospedada pelo Azure Databricks. Ele roda seu servidor de agente, como DurableAgentServer, nos aplicativos Databricks, então você implanta código em vez de provisionar servidores. Para entender 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 implantação é um aplicativo nomeado
agent-bricks-<name>com sua própria URL. Os clientes se autenticam com um token OAuth do Azure Databricks. Consulte Agentes de consulta implantados no Azure Databricks. - Identidade do agente: o agente é executado como a entidade de serviço do aplicativo. Veja Identidade do Agente.
-
Execução duradoura: Para agentes que usam
DurableAgentServer, a implantação prevê um Runtime Store para que o estado da execução sobreviva a reinícios de trabalhadores e execuções interrompidas possam ser recuperadas. - Rastreamento: A implantação configura o rastreamento do MLflow para o experimento ao qual o projeto está vinculado. Veja visão geral do rastreamento.
- Escalonamento: Execute um agente em 1 a 5 instâncias. Veja Escalonamento horizontal para aplicativos Databricks.
Identidade do agente
A identidade de um agente é a entidade de serviço do aplicativo para a qual ele foi implantado. O agente usa essa identidade para chamar APIs do Azure Databricks e executar ferramentas que você adiciona com --auth app.
- Quando você implanta,
agentbricks deployconcede ao principal do serviço acesso aos armazenamentos de memória, sessão e estado de execução que o agente usa. - Para dar acesso ao agente a outros dados e recursos, conceda ao principal de serviço do app as permissões necessárias, como você faria para qualquer app. Consulte Configurar a autorização em um aplicativo do Databricks.
- Ferramentas que usam
auth = "user"rodam com as permissões do usuário que enviou a requisição, em vez do service principal. Consulte Autorização do usuário da solicitação.
Implante um agente
Implante um projeto agente com a CLI Agent Bricks:
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.toml, e concede à entidade de serviço do aplicativo acesso a eles. - Para agentes que usam
DurableAgentServer, cria ou reusa um Repositório de Runtime da implantação. - Configura o rastreamento.
- Implante o aplicativo.
Para rodar o agente em mais de uma instância, passe --instances:
agentbricks --profile <profile> deploy my-agent --instances 2
Quando um agente roda em mais de uma instância, os clientes podem enviar o ID da sessão em um cabeçalho X-Routing-Key para rotear todas as solicitações de uma sessão para a mesma instância.
Gerenciar implantações
| Command | Description |
|---|---|
agentbricks deployments list |
Liste as implantações dos seus agentes. |
agentbricks deployments get <app-name> |
Mostre a URL, o status e a descrição de uma implantação. |
agentbricks deployments logs <app-name> |
Mostre os registros de uma implantação. |
agentbricks deployments start <app-name> e agentbricks deployments stop <app-name> |
Inicie ou pare uma implantação. |
agentbricks deployments delete <app-name> |
Excluir uma implantação. |
Como cada implantação é um aplicativo, você também pode visualizá-lo e monitorá-lo nos Apps Databricks. Consulte Registro em Log e monitoramento para aplicativos do Databricks.
Limitações
Você não pode mudar o servidor do agente de uma implantação existente. Para trocar de servidor, crie um novo projeto com a opção agentbricks init --server que você quiser e implante-o sob um novo nome.