Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Important
Items die in dit artikel zijn gemarkeerd (preview) zijn momenteel beschikbaar als openbare preview. Deze preview wordt aangeboden zonder een service level agreement en we raden deze niet aan voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews voor meer informatie.
Met de Azure Developer CLI-extensies kuntazdai u AI-agents bouwen, implementeren, evalueren en gebruiken op Microsoft Foundry vanuit uw terminal. In dit artikel installeert u de extensies, controleert u de installatie en verifieert u zich bij Azure.
Prerequisites
- Een Azure-abonnement. Maak er gratis een.
- Azure Developer CLI (
azd) versie 1.25.2 of hoger. Installeer azd. - Python 3.10 of hoger of .NET 8 of hoger, afhankelijk van het agentframework dat u wilt gebruiken.
Azure-machtigingen
U hebt de volgende rollen nodig voor uw Azure-abonnement.
| Role | Purpose |
|---|---|
| Contributor | Azure resources inrichten en beheren. |
| Eigenaar van gieterij | Alleen vereist als u nieuwe Foundry-projecten maakt. |
Important
De rollen Foundry RBAC zijn onlangs hernoemd. Foundry User, Foundry Owner, Foundry Account Owner en Foundry Project Manager zijn eerder benoemd Azure AI-gebruiker, Azure AI-eigenaar Azure AI-accounteigenaar en Azure AI Project Manager. Het kan zijn dat u op sommige plekken nog steeds de vorige namen ziet terwijl de naamswijziging wordt doorgevoerd. De rol-id's en basismachtigingen worden niet gewijzigd door de naamswijziging.
Begrijpen hoe de extensies worden verpakt
De azd ai naamruimte bestaat uit meerdere onafhankelijke azd extensies. Elk voegt onder azd ai een commandogroep op hoofdniveau toe.
| Extensie-ID | Opdrachtgroep | Wat het doet |
|---|---|---|
microsoft.foundry |
meta-package | Bundelt alle Foundry-extensies voor één installatie. |
azure.ai.agents |
azd ai agent |
Verzend agenten met Foundry vanaf uw terminal. |
azure.ai.connections |
azd ai connection |
Projectverbindingen van Foundry beheren. |
azure.ai.inspector |
azd ai inspector |
Op browsers gebaseerde inspector-gebruikersinterface voor lokaal actieve agents. |
azure.ai.projects |
azd ai project |
Context van Foundry-project beheren (set, unset, show). |
azure.ai.routines |
azd ai routine |
Foundry-routines beheren (timers, schema’s, eventtriggers). |
azure.ai.skills |
azd ai skill |
Manage Foundry skills (herbruikbare richtlijnen voor agentgedrag). |
azure.ai.toolboxes |
azd ai toolbox |
Foundry-werksets beheren (verzamelingen met versies van hulpprogramma's). |
Het microsoft.foundry pakket is een thin meta-pakket dat geen eigen opdrachten bijdraagt. Als u deze installeert, wordt elke afzonderlijke extensie opgehaald. Dit is het aanbevolen startpunt. Als u azure.ai.agents op zichzelf installeert, wordt azure.ai.inspector ook automatisch meegeïnstalleerd, omdat de agentextensie daarvan afhankelijk is.
De volledige bundel installeren
Installeer elke Foundry-extensie in één stap door het metapakket:
azd ext install microsoft.foundry
Later bijwerken:
azd ext upgrade microsoft.foundry
Een afzonderlijke extensie installeren of upgraden
U kunt elke extensie ook afzonderlijk beheren:
# 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
De afzonderlijke extensies hebben elk een eigen versiebeheer, zodat u ze afzonderlijk kunt vastzetten of upgraden.
De installatie controleren
Geef de geïnstalleerde extensies weer:
azd ext list
U zou microsoft.foundry en elke afzonderlijke extensie moeten zien. Elke extensie bevat ook een version subopdracht:
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
Meld u aan bij Azure zodat de CLI namens u resources kan inrichten en beheren:
azd auth login
Met deze opdracht opent u een browservenster voor interactieve verificatie. Nadat u zich hebt aangemeld, slaat de CLI uw referenties lokaal op in de cache voor volgende opdrachten.