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 som har markerats som förhandsversioner i den här artikeln är för närvarande i förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och Microsoft 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.37.0 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
Behörigheter beror på vilka resurser arbetsflödet skapar eller återanvänder. För prompt-agent-arbetsflöden:
| Scenario | Behörigheter som krävs |
|---|---|
| Återanvända ett befintligt projekt och en distribution av modell | Foundry-användare i projektet för att skapa och anropa agenter. |
| Skapa resurser och tilldela projektroller under etablering | Behörighet att skapa resurserna och tilldela roller på målomfattningen. Till exempel ger Deltagare och Administratör för rollbaserad åtkomstkontroll tillsammans dessa behörigheter. |
Skapa projektanslutningar, inklusive en Toolbox-anslutning som skapats av azd |
Foundry Project Manager på projektet. Återanvändning av en befintlig anslutning kräver inte tillstånd att skapa en. |
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.
Begränsa roller till de resurser som ditt arbetsflöde använder. Mer information finns i Uppgifter för roller med utökade behörigheter i Foundry. Distribution av en värdbaserad agent har ytterligare krav; se Behörigheter för värdbaserad agent.
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 | Innehåller de sju kärn-Foundry-tilläggen som anges nedan. |
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 |
Konfigurera projektresurser och modelldriftsättningar och hantera endpointkontext. |
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 bidrar inte med sina egna kommandon. Den installerar de sju kärntillägg som anges ovan, inte alla tillägg i ai namnområdet. Installationen av azure.ai.agents installerar även dess beroenden, inklusive inspektorn samt stöd för Project, Connection och Toolbox.
Installera dessa oberoende när arbetsflödet behöver dem:
| Tilläggs-ID | Kommandogrupp | Job |
|---|---|---|
azure.ai.evaluations |
azd ai eval |
Skapa ramverk för projektutvärderingar, hantera utvärderare, inspektera resultat och styr byggen. |
azure.ai.dataset |
azd ai dataset |
Registrera, versionshantera, ladda ned och ta bort datauppsättningar. |
azure.ai.finetune |
azd ai finetuning |
Skicka och hantera finjusteringsjobb och driftsätta deras modeller. |
azure.ai.models |
azd ai models |
Ladda upp, registrera, inspektera och underhåll anpassade modellparametrar. |
azd ext install azure.ai.evaluations
azd ext install azure.ai.dataset
azd ext install azure.ai.finetune
azd ext install azure.ai.models
Installera hela paketet
Installera core Foundry-tilläggen 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 plus dess kärntillägg. Valfria tillägg visas bara om de installeras separat. Varje tillägg med ett kommandonamnområde exponerar också ett 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
Använd azd ai --help om du vill se de namnområden som dina installerade tillägg bidrar med och lägga till --help i ett kommando för att inspektera dess aktuella flaggor. Tilläggen har oberoende versionshantering; en nyare källutcheckning betyder inte att en funktion finns i det publicerade tillägget.
Aktivera förhandsversionen av Copilot harness
Om du vill använda Microsoft Copilot-selen med promptagenter installerar du azure.ai.agents version 1.0.0-beta.22 eller senare och aktiverar dess förhandsgranskning i skalet där du kör azd.
För Bash:
export AZD_ALPHA_ENABLE_AGENTS_MANAGED_HARNESS=true
För PowerShell:
$env:AZD_ALPHA_ENABLE_AGENTS_MANAGED_HARNESS = "true"
Ange variabeln i varje ny shell eller CI-jobb. Den här CLI-opt-in beviljar inte åtkomst till tjänsten eller ändrar dina Azure behörigheter.
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.