Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Important
Les éléments marqués comme préversion dans cet article sont actuellement en préversion. Cette préversion est fournie sans contrat de niveau de service et Microsoft ne le recommande pas pour les charges de travail de production. Certaines fonctionnalités peuvent ne pas être prises en charge ou avoir des fonctionnalités contraintes. Pour plus d’informations, consultez Conditions d'utilisation supplémentaires pour les versions préliminaires de Microsoft Azure.
Les extensions AZURE Developer CLI (azd) ai vous permettent de générer, déployer, évaluer et exploiter des agents IA sur Microsoft Foundry à partir de votre terminal. Dans cet article, vous installez les extensions, vérifiez l’installation et vous authentifiez-vous auprès de Azure.
Prerequisites
- Un abonnement Azure. Créez-en un gratuitement.
- Azure Developer CLI (
azd) version 1.37.0 ou ultérieure. Installez azd. - Python 3.10 ou version ultérieure, ou .NET 8 ou version ultérieure, selon l’infrastructure de l’agent que vous envisagez d’utiliser.
autorisations de Azure
Les autorisations dépendent des ressources que votre flux de travail crée ou réutilise. Pour les workflows prompt-agent :
| Scenario | Autorisations requises |
|---|---|
| Réutiliser un projet et un déploiement de modèle existants | Foundry User dans le projet pour créer et appeler des agents. |
| Créer des ressources et attribuer des rôles de projet lors du provisionnement | Autorisation de créer les ressources et d’attribuer des rôles à la portée cible. Par exemple, Contributeur et Administrateur du contrôle d’accès en fonction du rôle fournissent ces autorisations. |
Créer des connexions de projet, y compris une connexion Toolbox créée par azd |
Foundry Project Manager dans le projet. La réutilisation d’une connexion existante ne nécessite pas l’autorisation de en créer une. |
Important
Les rôles Foundry RBAC ont été récemment renommés. Foundry User, Foundry Owner, Propriétaire du compteFoundry et Foundry Project Manager ont été précédemment nommés Azure utilisateur IA, Azure propriétaire d’IA, propriétaire Azure compte IA et Azure gestionnaire Project IA. Il se peut que vous voyiez encore les anciens noms à certains endroits pendant le déploiement de ce changement de nom. Les ID de rôle et les autorisations de base ne sont pas modifiés par ce changement de nom.
Limiter les rôles aux ressources utilisées par votre flux de travail. Pour plus d’informations, consultez Tâches liées aux rôles privilégiés dans Foundry. Le déploiement d’agent hébergé a des exigences supplémentaires ; Consultez les autorisations de l’agent hébergé.
Comprendre comment les extensions sont empaquetées
L’espace de noms azd ai se compose de plusieurs extensions indépendantes azd. Chacun d’eux contribue à un groupe de commandes de niveau supérieur sous azd ai.
| ID d’extension | Groupe de commandes | Qu’est-ce que cela fait ? |
|---|---|---|
microsoft.foundry |
méta-package | Regroupe les sept extensions Foundry principales répertoriées ci-dessous. |
azure.ai.agents |
azd ai agent |
Expédier des agents avec Foundry à partir de votre terminal. |
azure.ai.connections |
azd ai connection |
Gérer les connexions de projet Foundry. |
azure.ai.inspector |
azd ai inspector |
Interface d’inspection dans le navigateur pour les agents exécutés localement. |
azure.ai.projects |
azd ai project |
Configurez les ressources de projet et les déploiements de modèles, et gérez le contexte de l’endpoint. |
azure.ai.routines |
azd ai routine |
Gérer les routines Foundry (minuteurs, planifications, déclencheurs d’événements). |
azure.ai.skills |
azd ai skill |
Gérer les compétences Foundry (directives comportementales réutilisables pour l’agent). |
azure.ai.toolboxes |
azd ai toolbox |
Gérer les boîtes à outils Foundry (collections d’outils versionnées). |
Le microsoft.foundry package n’ajoute pas ses propres commandes. Il installe les sept extensions principales répertoriées ci-dessus, pas toutes les extensions de l’espace de noms ai. L’installation de azure.ai.agents installe également ses dépendances, notamment la prise en charge de l’inspecteur, du projet, de la connexion et de la boîte à outils.
Installez ces éléments indépendamment lorsque votre flux de travail en a besoin :
| ID d’extension | Groupe de commandes | Job |
|---|---|---|
azure.ai.evaluations |
azd ai eval |
Évaluer les projets Scaffold, gérer les évaluateurs, inspecter les résultats et contrôler les builds. |
azure.ai.dataset |
azd ai dataset |
Inscrivez, versionnez, téléchargez et supprimez des jeux de données. |
azure.ai.finetune |
azd ai finetuning |
Soumettez et gérez des tâches de fine-tuning et déployez leurs modèles. |
azure.ai.models |
azd ai models |
Téléchargez, enregistrez, inspectez et conservez des pondérations de modèle personnalisées. |
azd ext install azure.ai.evaluations
azd ext install azure.ai.dataset
azd ext install azure.ai.finetune
azd ext install azure.ai.models
Installer l’offre groupée complète
Installez les extensions Foundry principales en une étape dans le méta-package :
azd ext install microsoft.foundry
Pour effectuer la mise à jour ultérieurement :
azd ext upgrade microsoft.foundry
Installer ou mettre à niveau une extension individuelle
Vous pouvez également gérer chaque extension par elle-même :
# Just the agent surface
azd ext install azure.ai.agents
# Just the routine surface
azd ext install azure.ai.routines
# Upgrade one extension without touching the others
azd ext upgrade azure.ai.connections
Les extensions sont gérées indépendamment les unes des autres au niveau des versions ; vous pouvez donc verrouiller ou mettre à jour chacune séparément.
Vérifier l’installation
Listez les extensions installées :
azd ext list
Vous devez voir microsoft.foundry plus ses extensions de base. Les extensions facultatives s’affichent uniquement si elles sont installées séparément. Chaque extension avec un espace de noms de commande expose également une version sous-commande :
azd ai agent version
azd ai connection version
azd ai inspector version
azd ai project version
azd ai routine version
azd ai skill version
azd ai toolbox version
Utilisez cette option azd ai --help pour afficher les espaces de noms fournis par vos extensions installées et ajouter --help à une commande pour inspecter ses indicateurs actuels. Les extensions sont versionnées indépendamment ; une récupération du code source plus récente ne signifie pas qu’une fonctionnalité se trouve dans l’extension publiée.
Activer la version préliminaire de Copilot harness
Pour utiliser le Microsoft Copilot harness avec des agents de prompt, installez azure.ai.agents la version 1.0.0-beta.22 ou ultérieure et activez sa préversion dans l’interpréteur de commandes où vous exécutez azd.
Pour Bash :
export AZD_ALPHA_ENABLE_AGENTS_MANAGED_HARNESS=true
Pour PowerShell :
$env:AZD_ALPHA_ENABLE_AGENTS_MANAGED_HARNESS = "true"
Définissez la variable dans chaque nouvel interpréteur de commandes ou job CI. Cette option CLI n'accorde pas l'accès au service ni ne modifie vos autorisations de Azure.
Authenticate
Connectez-vous à Azure afin que l’interface CLI puisse approvisionner et gérer des ressources en votre nom :
azd auth login
Cette commande ouvre une fenêtre de navigateur pour l’authentification interactive. Une fois connecté, l’interface CLI met en cache vos informations d’identification localement pour les commandes suivantes.