Migracja z projektów opartych na hubach do projektów Foundry (klasycznych)

Dotyczy tylko:Portal Foundry (klasyczny). Ten artykuł nie jest dostępny w nowym portalu Foundry. Dowiedz się więcej o nowym portalu.

Uwaga

Linki w tym artykule mogą otwierać zawartość w nowej dokumentacji Microsoft Foundry, w przeciwieństwie do dokumentacji Foundry (klasycznej), którą przeglądasz obecnie.

Co zrobisz: Utwórz nowy projekt Foundry i opcjonalnie zmigruj agentów i połączenia z projektów opartych na hubie.

Szacowanie czasu: 5–10 minut.

Wymagania wstępne:

• Istniejący projekt oparty na centrum
• Rola Azure: rola Właściciel w subskrypcji lub grupie zasobów pozwala na tworzenie zasobów i projektów oraz przypisywanie ról do nowego projektu.

Ten przewodnik ułatwia istniejącym klientom migrowanie projektów opartych na centrum do nowych projektów Foundry w celu uzyskania dostępu do najnowszych możliwości platformy.

Microsoft Foundry przechodzi do ujednoliconej platformy jako usługi, zastępując poprzedni model zasobów, który wymagał zarządzania wieloma usługami Azure. W miarę zwiększania się złożoności obciążeń sztucznej inteligencji projekt Foundry:

• Upraszcza konfigurowanie i zarządzanie platformą
• Ulepsza przepływy pracy obejmujące wiele modeli i narzędzi Foundry.
• Wzmacnia możliwości zapewniania ładu

Dowiedz się więcej.

Ważne

Nowe funkcje generatywnej sztucznej inteligencji i skoncentrowane na modelu są dostępne tylko za pośrednictwem zasobu Foundry i jego projektów Foundry. Obecnie niektóre funkcje nadal wymagają hubu obok zasobu Foundry. Aby zapoznać się z porównaniem możliwości, zobacz Jakiego typu projekt potrzebuję?

Omówienie nowych projektów odlewniczych

Projekty foundry ujednolicają i upraszczają kompozycję przepływów pracy deweloperów oraz zarządzanie podstawowymi blokami konstrukcyjnymi aplikacji sztucznej inteligencji. Te bloki konstrukcyjne obejmują:

• Modele
• Agenci i ich narzędzia
• Możliwość obserwowania, bezpieczeństwo i zaufanie

Wcześniej możliwości projektu Foundry wymagały zarządzania wieloma zasobami Azure i zestawami SDK dla przepływów pracy w zapleczu, aby utworzyć te składniki.

Nowe możliwości obejmują:

• Dostęp do interfejsu API usługi Foundry , który jest przeznaczony do tworzenia i oceniania aplikacji agentów opartych na interfejsie API, które tworzą agentów, oceny, indeksy modeli, dane w ujednoliconym środowisku oraz spójną umowę między dostawcami modeli.

• Microsoft Foundry SDK opakowuje interfejs API rozwiązania Foundry, co ułatwia integrowanie funkcji z kodem, niezależnie od tego, czy aplikacja jest wbudowana w Python, C#, JavaScript/TypeScript, czy Java.

• Agenci, modele i połączenia narzędzi są zarządzane razem w narzędziu Foundry na potrzeby zarządzania uprawnieniami, sieci, analizy kosztów i konfiguracji zasad. Wcześniej niektóre narzędzia i modele były dostępne za pośrednictwem huba Azure Machine Learning, co wymagało również aprowizacji dodatkowych zasobów magazynowych i Key Vault.

• Projects są teraz zasobami podrzędnymi; mogą mieć przypisane własne kontrolki administratora, takie jak Azure RBAC, ale domyślnie współużytkują typowe ustawienia z zasobu nadrzędnego. Ta zasada ma na celu wyprowadzenie administratorów IT z pętli codziennych. Po ustanowieniu zabezpieczeń łączności zasobów i ładu na poziomie zasobów jako deweloper możesz utworzyć własny projekt jako folder w celu organizowania pracy.

Ważne

Zestaw funkcji projektów foundry nie jest jeszcze w pełnej zgodności z projektami opartymi na hubie. Aby uzyskać aktualny widok obsługiwanych funkcji, zobacz tabelę wsparcia.

Jak przełączyć się do projektu Foundry

Utwórz nowe projekty Foundry w zasobie modeli Foundry z projektu opartego na centrali. Ten proces umożliwia nowym projektom dostęp do pracy pierwotnie wykonanej w projekcie opartym na centrum

Co jest przenoszone do projektów Foundry

• Wdrożenia modelu
• Pliki danych
• Dostrojone modele
• Magazyny wektorów

Czego się nie przenosi

• Stan agenta w wersji zapoznawczej (komunikaty, wątki, pliki) — możesz ponownie utworzyć agenta przy użyciu kodu w nowym projekcie
• Wdrożenia modeli open-source — projekty Foundry obecnie ich nie obsługują
• Dostęp do projektów hubowych — projekty oparte na hubach nie mają dostępu do żadnych nowych projektów utworzonych w zasobie modeli Foundry.

W poniższych sekcjach dowiesz się, jak przejść z projektów opartych na centrum do projektów Foundry:

1. Lokalizowanie istniejącego zasobu usługi Foundry
2. Utwórz nowy projekt Foundry w zasobie sztucznej inteligencji.

Po utworzeniu nowego projektu możesz chcieć wykonać następujące czynności:

• (Opcjonalnie) Ponowne tworzenie połączeń
• (Opcjonalnie) Migrowanie agentów

1. Znajdź istniejący zasób Foundry

Większość użytkowników rozwiązania Foundry ma już zasób usługi Foundry (wcześniej nazywanych usługami AI), który został wcześniej utworzony wraz z projektem opartym na centrum w celu uzyskania dostępu do wdrożeń modelu.

Uwaga

Jeśli nie masz istniejącego zasobu Foundry, najczęściej, ponieważ centrum używało Azure OpenAI do uzyskiwania dostępu do wdrożeń modeli, musisz najpierw utwórz nowy zasób Foundry. Możesz połączyć istniejący zasób Azure OpenAI, aby kontynuować dostęp do istniejących wdrożeń modelu. Inne kroki konfiguracji mają zastosowanie dla usługi Agent. Zobacz szczegóły w Utwórz projekt do kompilowania przy użyciu agentów (Bicep) i Agent standard setup.

Portal usługi Foundry

1. W portalu Foundry otwórz projekt oparty na centrum.

2. W okienku po lewej stronie wybierz pozycję Centrum zarządzania.

3. Wybierz Połączone zasoby w sekcji Centrum.

4. Znajdź połączenie Modeli Foundry i wybierz link, aby wyświetlić jego szczegóły.

   

   Wskazówka

   Jeśli nie widzisz kolumny Typ , wybierz pozycję Kolumny w prawym górnym rogu, aby dostosować widoczne kolumny.

5. Postępuj zgodnie z linkiem w szczegółach połączenia, aby otworzyć stronę przeglądu zasobu usługi Foundry.

   

Azure

1. W portalu Azure wybierz grupę zasobów zawierającą projekt oparty na centrum.

2. Zlokalizuj swój zasób, korzystając z typu zasobu „Foundry”.

   

3. Postępuj zgodnie z linkiem, aby otworzyć stronę przeglądu zasobu usługi Foundry.

Bicep

1. Jeśli używasz szablonów infrastruktury jako kodu, takich jak Bicep (lub szablon Azure Resource Manager lub Terraform), szablon zazwyczaj zawiera wiele zasobów Azure.

2. Znajdź zasób typu CognitiveServices/account/kind=AIServices. Ten zasób to zasób "Foundry", który jest wyświetlany w portalu Foundry lub w portalu Azure.

2. Tworzenie nowego projektu

Nowe funkcje, w tym usługa agenta, są dostępne tylko za pośrednictwem projektów. Każdy projekt organizuje pracę programową jako folder dla każdego przypadku użycia. Możesz utworzyć wiele projektów, aby zorganizować pracę dla przypadków użycia z podobnymi wymaganiami dotyczącymi konfiguracji i łączności.

Portal usługi Foundry

Nowy projekt można utworzyć na jeden z dwóch sposobów:

• W centrum zarządzania:

  1. W okienku po lewej stronie wybierz pozycję Centrum zarządzania , aby zarządzać zasobem Foundry.

  2. Wybierz pozycję Przegląd w sekcji Zasób .

  3. Wybierz pozycję Nowy projekt , aby utworzyć projekt w tym zasobie. Ta akcja powoduje utworzenie projektu Foundry.

     

  4. Po utworzeniu projektu w okienku po lewej stronie wybierz pozycję Przejdź do projektu.

• W sekcji Agenci zasobu:

  1. W okienku po lewej stronie wybierz pozycję Agenci.

  2. Ponieważ zasób nie ma jeszcze projektu, zostanie wyświetlony monit o jego utworzenie.

     

Azure

1. W okienku po lewej stronie wybierz pozycję Projekty w sekcji Zarządzanie zasobami .
2. Wybierz pozycję Nowy , aby utworzyć nowy projekt.
3. Wprowadź nazwę i wybierz pozycję Utwórz.

Bicep

1. W szablonie projekt jest zasobem podrzędnym w ramach zasobu Foundry, jak pokazano w tym przykładzie.

2. Domyślnie, w podstawowej konfiguracji, usługa agenta używa wdrożeń i funkcji magazynowania dostarczanych przez zasób platformy Foundry.

3. Opcjonalnie, usługa Agenta obsługuje możliwość wykorzystania istniejących zasobów Azure OpenAI do wdrożeń modeli oraz użycia własnych zasobów magazynowych do przechowywania wątków, wiadomości i plików. Ta konfiguracja jest również określana jako "Standardowa". Zobacz ten przykład w celu zapoznania się z szablonami referencyjnymi Bicep.

Teraz możesz rozpocząć tworzenie agentów w ogólnej dostępności i z najnowszymi możliwościami. Rozpocznij korzystanie z zestawu SDK lub placu zabaw dla agentów.

(Opcjonalnie) Ponowne tworzenie połączeń

Jeśli projekt oparty na koncentratorze używał połączeń w celu uzyskiwania dostępu do narzędzi, źródeł danych lub modeli, możesz odtworzyć te połączenia w zasobie usługi Foundry bez użycia koncentratora.

Portal usługi Foundry

W centrum zarządzaniadodaj wszystkie połączenia z narzędziami i danymi użytymi wcześniej w początkowym projekcie opartym na centrum.

Azure

Nie można dodawać połączeń w portalu Azure. Użyj portalu Foundry lub szablonu Bicep, aby dodać połączenia.

Bicep

Jeśli wolisz używać szablonów Bicep, zobacz to repozytorium z przykładami.

Połączenia są definiowane jako wystąpienia typu CognitiveServices/account/connections i CognitiveServices/account/project/connections. Wybierz połączenia na poziomie konta na potrzeby dostępu współdzielonego między projektami.

Opcjonalne migrowanie agentów kodu

Aby przejść z wersji zapoznawczej usługi Agent do usługi Agent w ogólnej dostępności w projektach Foundry, uaktualnij agentów kodu, wprowadzając następujące zmiany:

1. Zainstaluj najnowszą wersję preferowanego klienta zestawu SDK.

2. Zaktualizuj klienta projektu, aby używał interfejsu API rozwiązania Foundry. Zamiast ciągu połączenia teraz używasz punktu końcowego projektu Foundry. Na przykład w Python:

   from azure.identity import DefaultAzureCredential
   from azure.ai.projects import AIProjectClient
   
   project = AIProjectClient(
     endpoint="your_project_endpoint",  # Replace with your endpoint
     credential=DefaultAzureCredential())
   

   Ten kod uwierzytelnia się w projekcie Foundry za pomocą biblioteki Azure Identity i tworzy instancję klienta projektu. endpoint jest punktem końcowym projektu Foundry; DefaultAzureCredential używa poświadczeń Azure do uwierzytelniania.

   Dokumentacja: AIProjectClient, DefaultAzureCredential, SDK migration guide

3. Zaktualizuj skrypt, aby odzwierciedlał wszelkie zmiany struktury klas między pakietami wersji zapoznawczej i stabilnymi pakietami zestawu SDK.

Aby uzyskać więcej informacji, zobacz przewodnik migracji SDK.

(Opcjonalnie) Czyszczenie projektów opartych na centrum

Jeśli nie potrzebujesz już dostępu do projektów opartych na centrum, usuń je z subskrypcji Azure.

Warto zachować centra i projekty oparte na centrum w ramach subskrypcji z kilku powodów:

• Dostęp do wybranych funkcji, które nie są jeszcze obsługiwane w projektach foundry. Zobacz tę macierz obsługi.

• Przypadki użycia, które koncentrują się na szkoleniu niestandardowych modeli uczenia maszynowego. Projekt oparty na centrum jest oparty na stosie Azure Machine Learning i pozostaje dostępny za pośrednictwem usługi Azure Machine Learning Studio, interfejsu wiersza polecenia lub zestawu SDK.

Portal usługi Foundry

1. W portalu Foundry otwórz projekt oparty na centrum.

2. Wybierz pozycję Centrum zarządzania.

3. Wybierz pozycję Przegląd w sekcji Centrum.

4. Wybierz wszystkie projekty, które nie chcesz już zachować.

5. Wybierz pozycję Usuń projekt.

6. Usuń wszystkie projekty, które nie chcesz już przechowywać.

7. W sekcji Właściwości centrum po prawej stronie wybierz pozycję Usuń centrum , jeśli chcesz usunąć centrum i wszystkie jego projekty. Ta opcja spowoduje otwarcie portalu Azure w celu usunięcia centrum.

Azure

1. W portalu Azure wybierz grupę zasobów zawierającą projekt oparty na centrum.
2. Wybierz link dla zasobu centrum Azure AI.
3. Wybierz pozycję Usuń , aby usunąć centrum i wszystkie skojarzone z nim projekty.

Ostrożność

Upewnij się, że nie usuniesz zasobu Foundry, ponieważ ten zasób zawiera Twoje istniejące wdrożenia, pliki, zadania dostrajania i będzie również zarządzać projektami Foundry w przyszłości.

Bicep

1. Zachowaj typ zasobu CognitiveServices/account/kind=AIServices . Ten rodzaj zasobu reprezentuje zasób Foundry.

2. Usuń Microsoft. MachineLearningServices/workspace/kind=project i Microsoft. MachineLearningServices/workspace/kind=hub z definicji szablonu.

3. Użyj alternatywnych metod usuwania zasobów, ponieważ Bicep nie obsługuje tej akcji.

Dowiedz się więcej

• Wdrażanie aplikacji Foundry w całej organizacji

• Przykładowe szablony Bicep

• Przykładowe szablony narzędzia Terraform

• przewodnik migracji zestawu SDK