Zainstaluj rozszerzenia Foundry dla interfejsu wiersza polecenia Azure Developer CLI

Ważna

Elementy oznaczone jako (wersja zapoznawcza) w tym artykule są aktualnie dostępne w publicznej wersji zapoznawczej. Ta wersja zapoznawcza jest udostępniana bez umowy dotyczącej poziomu usług i nie zalecamy 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.25.2 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

Potrzebne są następujące role w ramach subskrypcji Azure.

roli Purpose
Contributor Aprowizuj zasoby Azure i zarządzaj nimi.
Właściciel Foundry Wymagane tylko w przypadku utworzenia nowych projektów Foundry.

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.

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 Pakietuje wszystkie rozszerzenia Foundry dla pojedynczej instalacji.
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 Zarządzaj kontekstem projektu foundry (set, unset, show).
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 jest cienkim meta-pakietem, który nie współtworzy własnych poleceń. Zainstalowanie go powoduje zainstalowanie wszystkich poszczególnych rozszerzeń, co jest zalecanym punktem wyjścia. Samo zainstalowanie azure.ai.agents powoduje również automatyczne zainstalowanie azure.ai.inspector, ponieważ rozszerzenie agenta jest od niego zależne.

Instalowanie pełnego pakietu

Zainstaluj każde rozszerzenie 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 zostać wyświetlone microsoft.foundry plus poszczególne rozszerzenia. Każde rozszerzenie udostępnia również podpolecenie version:

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

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ń.

Treści powiązane

  • Last updated on