Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Ważna
Elementy oznaczone podglądem w tym artykule są obecnie w wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług, a Microsoft nie zaleca korzystania z niej w przypadku obciążeń produkcyjnych. Niektóre funkcje mogą nie być obsługiwane lub mogą mieć ograniczone możliwości. Aby uzyskać więcej informacji, zobacz Warunki dodatkowe korzystania z testowych wersji Microsoft Azure.
Rozszerzenia interfejsu wiersza poleceniaazd dla deweloperów () ai Azure umożliwiają tworzenie, wdrażanie, ocenianie i obsługę agentów sztucznej inteligencji na platformie Microsoft Foundry z poziomu terminalu. W tym artykule zainstalujesz rozszerzenia, zweryfikujesz instalację i uwierzytelnisz się w Azure.
Wymagania wstępne
- Subskrypcja platformy Azure. Utwórz je bezpłatnie.
- Azure Developer CLI (
azd) w wersji 1.37.0 lub nowszej. Zainstaluj azd. - Python wersji 3.10 lub nowszej lub .NET 8 lub nowszej, w zależności od struktury agenta, która ma być używana.
Uprawnienia platformy Azure
Uprawnienia zależą od zasobów tworzonych lub ponownie używanych przez przepływ pracy. Dla przepływów pracy prompt-agent:
| Scenario | Wymagane uprawnienia |
|---|---|
| Ponowne używanie istniejącego projektu i wdrożenia modelu | Foundry User w projekcie, aby utworzyć i wywołać agentów. |
| Utwórz zasoby i przypisz role projektu podczas aprowizacji | Uprawnienie do tworzenia zasobów i przypisywania ról w docelowym zakresie. Na przykład współautor i Administrator kontroli dostępu opartej na rolach razem zapewniają te uprawnienia. |
Tworzenie połączeń projektu, w tym połączenia przybornika utworzonego przez azd |
Foundry Project Manager w projekcie. Ponowne użycie istniejącego połączenia nie wymaga uprawnień do jej utworzenia. |
Ważna
Niedawno zmieniono nazwy ról RBAC w usłudze Foundry. Użytkownik Foundry, właściciel Foundry, właściciel konta Foundry i menedżer projektu Foundry były wcześniej nazywane odpowiednio użytkownikiem Azure AI, właścicielem Azure AI, właścicielem konta Azure AI i menedżerem projektu Azure AI. Poprzednie nazwy mogą być nadal widoczne w niektórych miejscach, podczas gdy zmiana nazwy jest wdrażana. Identyfikatory ról i uprawnienia podstawowe są niezmienione przez zmianę nazwy.
Ogranicz role do zasobów używanych przez przepływ pracy. Aby uzyskać szczegółowe informacje, zobacz Zadania z podwyższonym poziomem uprawnień w narzędziu Foundry. Wdrożenie hostowanego agenta ma dodatkowe wymagania; zobacz Uprawnienia hostowanego agenta.
Dowiedz się, jak są pakowane rozszerzenia
azd ai przestrzeń nazw składa się z wielu niezależnych azd rozszerzeń. Każdy dodaje grupę poleceń najwyższego poziomu pod azd ai.
| Identyfikator rozszerzenia | Grupa poleceń | Do czego służy |
|---|---|---|
microsoft.foundry |
metapakiet | Obejmuje siedem podstawowych rozszerzeń Foundry wymienionych poniżej. |
azure.ai.agents |
azd ai agent |
Wysyłaj agentów za pomocą Foundry z poziomu terminala. |
azure.ai.connections |
azd ai connection |
Zarządzanie połączeniami projektu Foundry. |
azure.ai.inspector |
azd ai inspector |
Interfejs użytkownika inspektora opartego na przeglądarce dla agentów działających lokalnie. |
azure.ai.projects |
azd ai project |
Konfigurowanie zasobów projektu i wdrożeń modelu oraz zarządzanie kontekstem punktu końcowego. |
azure.ai.routines |
azd ai routine |
Zarządzaj procedurami rozwiązania Foundry (czasomierze, harmonogramy, wyzwalacze zdarzeń). |
azure.ai.skills |
azd ai skill |
Zarządzaj umiejętnościami Foundry (wytycznymi dotyczącymi zachowania agenta, których można używać wielokrotnie). |
azure.ai.toolboxes |
azd ai toolbox |
Zarządzaj zestawami narzędzi Foundry (wersjonowane kolekcje narzędzi). |
Pakiet microsoft.foundry nie udostępnia własnych poleceń. Instaluje siedem podstawowych rozszerzeń wymienionych powyżej, a nie każde rozszerzenie w ai przestrzeni nazw. Instalacja azure.ai.agents instaluje również jego zależności, w tym obsługę inspektora, projektu, połączenia i przybornika.
Zainstaluj je niezależnie, gdy są potrzebne w Twoim przepływie pracy:
| Identyfikator rozszerzenia | Grupa poleceń | Job |
|---|---|---|
azure.ai.content-understanding |
azd ai cu |
Analizowanie dokumentów, obrazów, audio i wideo za pomocą usługi Azure Content Understanding (wersja zapoznawcza). |
azure.ai.evaluations |
azd ai eval |
Oceniaj projekty szkieletowe, zarządzaj oceniającymi, sprawdzaj wyniki i blokuj kompilacje. |
azure.ai.dataset |
azd ai dataset |
Rejestruj, wersjonuj, pobieraj i usuwaj zestawy danych. |
azure.ai.finetune |
azd ai finetuning |
Przesyłaj zadania dostrajania, zarządzaj nimi i wdrażaj ich modele. |
azure.ai.models |
azd ai models |
Przesyłaj, rejestruj, kontroluj i utrzymuj niestandardowe wagi modelu. |
azd ext install azure.ai.content-understanding
azd ext install azure.ai.evaluations
azd ext install azure.ai.dataset
azd ext install azure.ai.finetune
azd ext install azure.ai.models
Instalowanie pełnego pakietu
Zainstaluj podstawowe rozszerzenia foundry w jednym kroku za pomocą meta-pakietu:
azd ext install microsoft.foundry
Zaktualizuj później:
azd ext upgrade microsoft.foundry
Instalowanie lub uaktualnianie pojedynczego rozszerzenia
Można również zarządzać poszczególnymi rozszerzeniami samodzielnie:
# 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
Poszczególne rozszerzenia są niezależnie wersjonowane, więc można je przypiąć lub uaktualnić pojedynczo.
Weryfikowanie instalacji
Wyświetl zainstalowane rozszerzenia:
azd ext list
Powinny być widoczne microsoft.foundry oraz jego podstawowe rozszerzenia. Opcjonalne rozszerzenia są wyświetlane tylko wtedy, gdy są zainstalowane oddzielnie. Każde rozszerzenie z przestrzenią nazw poleceń również udostępnia podpolecenie version:
azd ai agent version
azd ai connection version
azd ai cu version
azd ai inspector version
azd ai project version
azd ai routine version
azd ai skill version
azd ai toolbox version
Użyj azd ai --help, aby wyświetlić przestrzenie nazw dodane przez zainstalowane rozszerzenia, i dołącz --help do polecenia w celu sprawdzenia jego bieżących flag. Rozszerzenia są niezależnie wersjonowane; nowsze pobranie kopii źródeł nie oznacza, że funkcja znajduje się w opublikowanym rozszerzeniu.
Włącz podgląd harness dla Copilot
Aby użyć narzędzia Microsoft Copilot z agentami promptów, zainstaluj azure.ai.agents wersję 1.0.0-beta.22 lub nowszą i włącz jego wersję zapoznawczą w powłoce, w której uruchamiasz polecenie azd.
Dla Bash:
export AZD_ALPHA_ENABLE_AGENTS_MANAGED_HARNESS=true
Dla PowerShell:
$env:AZD_ALPHA_ENABLE_AGENTS_MANAGED_HARNESS = "true"
Ustaw zmienną w każdej nowej powłoce lub zadaniu ciągłej integracji. Ta zgoda typu opt-in w interfejsie wiersza polecenia nie udziela dostępu do usługi ani nie zmienia uprawnień Azure.
Authenticate
Zaloguj się do Azure, aby interfejs wiersza polecenia mógł aprowizować zasoby i zarządzać nimi w Twoim imieniu:
azd auth login
To polecenie otwiera okno przeglądarki na potrzeby uwierzytelniania interakcyjnego. Po zalogowaniu CLI przechowuje Twoje poświadczenia lokalnie w pamięci podręcznej na potrzeby kolejnych poleceń.