Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Agent Runtime esegue il tuo agente su un ambiente di calcolo serverless ospitato in Azure Databricks. Esegue il tuo server agente, come DurableAgentServer, su Databricks Apps, quindi distribuisci codice invece di provisionare i server. Per capire come Agent Runtime si integra con il tuo framework e il server agente, consulta Deploy agents su Azure Databricks.
Cosa offre Agent Runtime
-
Un endpoint stabile e autenticato: ogni deployment è un'app con un proprio URL
agent-bricks-<name>. I clienti si autenticano con un token OAuth di Azure Databricks. Vedi agenti Query distribuiti su Azure Databricks. - Identità dell'agente: L'agente funziona come service principal dell'app. Vedi Identità dell'agente.
-
Esecuzione durevole: Per gli agenti che utilizzano
DurableAgentServer, la distribuzione prevede un Runtime Store in modo che lo stato di esecuzione sopravviva ai riavvii dei lavoratori e le run interrotte possano recuperare. - Tracciamento: Il deployment configura il tracciamento MLflow per l'esperimento a cui il progetto è associato. Consulta Panoramica del tracciamento.
- Scaling: Esegui un agente su larga scala su più istanze. Consulta Scalabilità orizzontale per le app Databricks.
Identità dell'agente
L'identità di un agente è l'entità servizio dell'app su cui è distribuito. L'agente usa questa identità per chiamare le API di Azure Databricks e per eseguire strumenti che aggiungi con --auth app.
- Quando si implementa,
agentbricks deployconcede al service principal l'accesso agli archivi di memoria, sessione e stato di esecuzione che l'agente utilizza. - Per dare all'agente accesso ad altri dati e risorse, concedi al service principal dell'app i permessi necessari, come faresti per qualsiasi app. Consultare Configurare l'autorizzazione nell'applicazione Databricks.
- Gli strumenti che usano
auth = "user"funzionano con i permessi dell'utente che ha inviato la richiesta invece che del service principal. Vedi Richiesta-autorizzazione utente.
Prerequisites
Installa la CLI di Databricks, Python 3.11 o superiore,
uv.Installa la CLI di Agent Bricks:
uv tool install databricks-agentbricksAccedi al tuo spazio di lavoro.
agentbricks loginsalva il profilo predefinito, così i comandi successivi possono omettere--profile:databricks auth login --host <workspace-url> --profile <profile> agentbricks login --profile <profile>Crea un progetto per l'agente e passa alla relativa directory:
agentbricks init my-agent cd my-agent
Distribuisci un agente
Distribuisci un progetto di agente con la CLI di Agent Bricks.
Distribuisci dalla directory del progetto
Per distribuire l'agente, esegui il seguente comando dalla directory del progetto:
agentbricks deploy my-agent
Per distribuire in un'area di lavoro diversa da quella predefinita, specifica --profile <profile>.
La directory del progetto contiene agent.toml e app.yaml. Se esegui agentbricks deploy da un'altra directory, carica quella directory invece. Per distribuire un progetto da un'altra directory, passa --source <dir>.
L'argomento di agentbricks deploy è il nome della distribuzione, fino a un massimo di 17 caratteri. L'app si chiama agent-bricks-<name>, quindi questo esempio crea agent-bricks-my-agent. Il primo deployment registra il nome in agent.toml, quindi i deployment successivi dal progetto possono ometterlo.
Una prima distribuzione richiede alcuni minuti. Il comando termina quando l'agente risponde alle richieste.
agentbricks deploy fa quanto segue:
- Crea o riutilizza gli archivi di memoria e sessione dichiarati in
agent.tomle concede all'entità servizio dell'app l'accesso a tali archivi. - Per gli agenti che utilizzano
DurableAgentServer, crea o riutilizza lo Runtime Store della distribuzione. - Configura il tracciamento.
- Installa l’app.
Per eseguire l'agente su più di una istanza, passa --instances:
agentbricks deploy my-agent --instances 2
Quando un agente viene eseguito su più di un'istanza, i client possono inviare l'ID della sessione in un'intestazione X-Routing-Key per instradare tutte le richieste di una sessione alla stessa istanza.
Distribuisci senza aspettare
Se uno script o un agente di codifica ha un breve timeout di comando, distribuisci senza attesa e poi attendi la distribuzione in un comando separato:
agentbricks deploy my-agent --no-wait
agentbricks deployments wait agent-bricks-my-agent
--no-wait esegue i controlli rapidi e poi completa il deployment in un processo in background.
agentbricks deployments wait attende fino a 100 secondi per impostazione predefinita. Per modificare il limite, passa --timeout. Il comando esce con uno dei seguenti codici:
-
0: L'agente viene distribuito e risponde alle richieste. -
1: La distribuzione non è riuscita. -
75: L'agent è ancora in distribuzione. Eseguire di nuovo il comando .
Esegui agentbricks deployments wait dalla directory del progetto, oppure passa --source <dir>.
Gestire le distribuzioni
| Comando | Description |
|---|---|
agentbricks deployments list |
Elenca le tue distribuzioni degli agenti. |
agentbricks deployments get <app-name> |
Mostra l'URL, lo stato e la descrizione di un deployment. |
agentbricks deployments wait [<app-name>] |
Attendi che un deployment finisca. Per impostazione predefinita, usa il deployment registrato in agent.toml. |
agentbricks deployments logs <app-name> |
Mostra i log di una distribuzione. |
agentbricks deployments start <app-name> |
Avvia un deployment. |
agentbricks deployments stop <app-name> |
Arresta una distribuzione. Chiede conferma a meno che non passi --yes. |
agentbricks deployments delete <app-name> |
Eliminare una distribuzione. Chiede conferma a meno che tu non passi --yes. |
Poiché ogni deployment è un'app, puoi anche visualizzarla e monitorarla nelle Apps Databricks. Vedere Registrazione e monitoraggio per le app di Databricks.
Limitations
Non puoi cambiare il server agente di un deployment esistente. Per cambiare server, crea un nuovo progetto con l'opzione agentbricks init --server che desideri e distribuiscilo con un nuovo nome.