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 indiqués comme (aperçu) dans cet article sont en aperçu public. Cette version préliminaire est fournie sans contrat de niveau de service, et nous la déconseillons pour les charges de travail en 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.25.2 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
Vous avez besoin des rôles suivants sur votre abonnement Azure.
| Rôle | Purpose |
|---|---|
| Contributeur | Provisionnez et gérez les ressources Azure. |
| Propriétaire de la fonderie | Obligatoire uniquement si vous créez des projets Foundry. |
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.
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 toutes les extensions Foundry pour une seule installation. |
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 |
Gérer le contexte du projet Foundry (set, unset, show). |
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 est un méta-package mince qui ne contribue pas à ses propres commandes. Son installation ajoute automatiquement toutes les extensions individuelles, ce qui constitue le point de départ recommandé. L’installation de azure.ai.agents à lui seul installe également automatiquement azure.ai.inspector, car l’extension de l’agent en dépend.
Installer l’offre groupée complète
Installez chaque extension Foundry en une seule é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 devriez voir microsoft.foundry ainsi que chaque extension individuellement. Chaque extension 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
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.