Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
Agent Runtime exécute votre agent sur des ressources de calcul serverless hébergées sur Azure Databricks. Il fait tourner votre serveur agent, comme DurableAgentServer, sur Databricks Apps, donc vous déployez du code au lieu de provisionner des serveurs. Pour savoir comment Agent Runtime s’intègre à votre framework et à votre agent serveur, voir Déployer agents sur Azure Databricks.
Ce que fournit l’Agent Runtime
-
Un point de terminaison stable et authentifié : chaque déploiement est une application nommée
agent-bricks-<name>avec sa propre URL. Les clients s’authentifient avec un token Azure Databricks OAuth. Voir les agents de requête déployés sur Azure Databricks. - Identité de l’agent : L’agent fonctionne en tant que principal du service de l’application. Voir Identité de l’agent.
-
Exécution durable : Pour les agents qui utilisent
DurableAgentServer, le déploiement prévoit un magasin d’exécution afin que l’état d’exécution survive aux redémarrages des travailleurs et que les exécutions interrompues puissent reprendre. - Traçage : Le déploiement configure le traçage MLflow pour l’expérience à laquelle le projet est associé. Voir aperçu du traçage.
- Scaling : Exécutez un agent à grande échelle sur plusieurs instances. Voir Mise à l’échelle horizontale pour les applications Databricks.
Identité de l’agent
L’identité d’un agent correspond à l’entité de service de l’application sur laquelle il est déployé. L’agent utilise cette identité pour appeler les API Azure Databricks et exécuter les outils que vous ajoutez avec --auth app.
- Lorsque vous déployez,
agentbricks deploycela accorde au principal de service l’accès au magasin de mémoire, aux magasins de session et d’état d’exécution utilisés par l’agent. - Pour donner à l’agent accès à d’autres données et ressources, accordez au principal du service de l’application les autorisations nécessaires, comme vous le feriez pour n’importe quelle application. Consultez Configurer l’autorisation dans une application Databricks.
- Les outils qui utilisent
auth = "user"s’exécutent avec les permissions de l’utilisateur qui a envoyé la requête au lieu du principal du service. Voir la demande d’autorisation de l’utilisateur.
Prerequisites
Installez l’interface de navigation de code de Databricks, Python 3.11 ou supérieur, et
uv.Installer la CLI Agent Bricks :
uv tool install databricks-agentbricksConnectez-vous à votre espace de travail.
agentbricks loginenregistre le profil comme valeur par défaut, afin que les commandes ultérieures puissent omettre--profile:databricks auth login --host <workspace-url> --profile <profile> agentbricks login --profile <profile>Créez un projet d’agent et changez-le dans son répertoire :
agentbricks init my-agent cd my-agent
Déployer un agent
Déployez un projet d’agent avec Agent Bricks CLI.
Déployer depuis le répertoire du projet
Pour déployer l’agent, exécutez la commande suivante depuis le répertoire du projet :
agentbricks deploy my-agent
Pour déployer vers un espace de travail autre que le modèle par défaut, passez --profile <profile>.
Le répertoire des projets contient agent.toml et app.yaml. Si vous exécutez agentbricks deploy depuis un autre répertoire, celui-ci télécharge ce répertoire à la place. Pour déployer un projet depuis un autre répertoire, passez --source <dir>.
L’argument de agentbricks deploy est le nom du déploiement, jusqu’à 17 caractères. L’application s’appelle agent-bricks-<name>, donc cet exemple crée agent-bricks-my-agent. Le premier déploiement enregistre le nom dans agent.toml, de sorte que les déploiements ultérieurs depuis le projet peuvent l’omettre.
Un premier déploiement prend quelques minutes. La commande se termine lorsque l’agent répond aux demandes.
agentbricks deploy fait ce qui suit :
- Crée ou réutilise les magasins de mémoire et de session déclarés dans
agent.toml, et accorde au principal du service de l’application l’accès à ceux-ci. - Pour les agents qui utilisent
DurableAgentServer, crée ou réutilise le magasin de runtime du déploiement. - Configure le traçage.
- Déploie l’application.
Pour exécuter l’agent sur plusieurs instances, passez --instances:
agentbricks deploy my-agent --instances 2
Lorsqu’un agent s’exécute sur plus d’une instance, les clients peuvent envoyer l’ID de session dans un en-tête X-Routing-Key pour acheminer toutes les requêtes d’une session vers la même instance.
Déployer sans attendre
Si un script ou un agent de codage dispose d’un délai d’attente de commande court, déployez sans attendre, puis attendez le déploiement dans une commande distincte :
agentbricks deploy my-agent --no-wait
agentbricks deployments wait agent-bricks-my-agent
--no-wait exécute les vérifications rapides, puis termine le déploiement dans un processus en arrière-plan.
agentbricks deployments wait patiente jusqu’à 100 secondes par défaut. Pour modifier la limite, passez --timeout. La commande se termine avec l’un des codes suivants :
-
0: L’agent est déployé et répond aux demandes. -
1: Le déploiement a échoué. -
75: L’agent est toujours en cours de déploiement. Exécutez de nouveau la commande .
Exécutez agentbricks deployments wait depuis le répertoire du projet, ou passez --source <dir>.
Gérer les déploiements
| Command | Description |
|---|---|
agentbricks deployments list |
Listez vos déploiements d’agents. |
agentbricks deployments get <app-name> |
Affichez l’URL, le statut et la description d’un déploiement. |
agentbricks deployments wait [<app-name>] |
Attendez la fin d’un déploiement. Utilise par défaut le déploiement enregistré dans agent.toml. |
agentbricks deployments logs <app-name> |
Affichez les journaux d’un déploiement. |
agentbricks deployments start <app-name> |
Lancer un déploiement. |
agentbricks deployments stop <app-name> |
Arrêter un déploiement. Demande une confirmation à moins que vous ne passiez --yes. |
agentbricks deployments delete <app-name> |
Supprime un déploiement. Demande une confirmation à moins que vous ne passiez --yes. |
Comme chaque déploiement est une application, vous pouvez aussi la consulter et la surveiller dans Databricks Apps. Consultez la journalisation et la surveillance des applications Databricks.
Limitations
Vous ne pouvez pas changer le serveur agent d’un déploiement existant. Pour changer de serveur, créez un nouveau projet avec l’option agentbricks init --server que vous souhaitez, et déployez-le sous un nouveau nom.