Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Viktigt
Objekt markerade (förhandsversion) i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.
Med cli-tilläggen Azure Developer (azd) ai kan du skapa, distribuera, utvärdera och använda AI-agenter på Microsoft Foundry från terminalen. I den här artikeln installerar du tilläggen, verifierar installationen och autentiserar för att Azure.
Förutsättningar
- Ett Azure-abonnemang. Skapa en kostnadsfritt.
- Azure Developer CLI (
azd) version 1.25.2 eller senare. Installera azd. - Python 3.10 eller senare, eller .NET 8 eller senare, beroende på vilket agentramverk du planerar att använda.
Azure-behörigheter
Du behöver följande roller i din Azure-prenumeration.
| Befattning | Purpose |
|---|---|
| Deltagare | Etablera och hantera Azure resurser. |
| ägare till Foundry | Krävs endast om du skapar nya Foundry-projekt. |
Viktigt
Foundrys RBAC-roller har nyligen namnändrats. Foundry User, Foundry Owner, Foundry Account Owner och Foundry Project Manager hette tidigare Azure AI-användare, Azure AI-ägare, Azure AI-kontoägare och Azure AI Project Manager. Du kanske fortfarande ser de tidigare namnen på vissa platser medan namnbytet distribueras. Roll-ID:na och kärnbehörigheterna ändras inte av namnbytet.
Förstå hur tilläggen paketeras
Namnområdet azd ai består av flera oberoende azd tillägg. Var och en bidrar med en kommandogrupp på den översta nivån under azd ai.
| Tilläggs-ID | Kommandogrupp | Vad det gör |
|---|---|---|
microsoft.foundry |
meta-paket | Paketera alla Foundry-tillägg för en enda installation. |
azure.ai.agents |
azd ai agent |
Skicka agenter med Foundry från terminalen. |
azure.ai.connections |
azd ai connection |
Hantera Foundry-projektanslutningar. |
azure.ai.inspector |
azd ai inspector |
Webbläsarbaserat kontrollgränssnitt för lokalt aktiva agenter. |
azure.ai.projects |
azd ai project |
Hantera projektkontexten i Foundry (set, unset, show). |
azure.ai.routines |
azd ai routine |
Hantera Foundry-rutiner (timers, scheman, händelseutlösare). |
azure.ai.skills |
azd ai skill |
Hantera Foundry-kunskaper (riktlinjer för återanvändbara agentbeteenden). |
azure.ai.toolboxes |
azd ai toolbox |
Hantera Foundry-verktygslådor (versionshanterade verktygssamlingar). |
Paketet microsoft.foundry är ett tunt metapaket som inte bidrar med sina egna kommandon. När du installerar det hämtas varje enskilt tillägg, vilket är den rekommenderade startpunkten. Om du installerar azure.ai.agents separat installeras även azure.ai.inspector automatiskt, eftersom agenttillägget är beroende av det.
Installera hela paketet
Installera varje Foundry-tillägg i ett steg genom metapaketet:
azd ext install microsoft.foundry
Så här uppdaterar du senare:
azd ext upgrade microsoft.foundry
Installera eller uppgradera ett enskilt tillägg
Du kan också hantera varje tillägg på egen hand:
# 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 enskilda tilläggen är fristående versioner, så du kan fästa eller uppgradera ett i taget.
Kontrollera installationen
Lista installerade tillägg:
azd ext list
Du bör se microsoft.foundry samt varje enskilt tillägg. Varje tillägg exponerar också en version underkommando:
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
Logga in på Azure så att CLI kan etablera och hantera resurser åt dig:
azd auth login
Det här kommandot öppnar ett webbläsarfönster för interaktiv autentisering. När du har loggat in cachelagrar CLI dina autentiseringsuppgifter lokalt för efterföljande kommandon.