Udostępnij przez


Konfigurowanie środowiska

Uwaga / Notatka

Ten dokument odnosi się do portalu Microsoft Foundry (klasycznego).

🔄 Przejdź do dokumentacji Microsoft Foundry (nowej), jeśli korzystasz z nowego portalu.

Uwaga / Notatka

Ten dokument odnosi się do portalu Microsoft Foundry (nowy).

Tworzenie pierwszego agenta za pomocą usługi agenta foundry jest procesem dwuetapowym:

  1. Skonfiguruj środowisko agenta.
  2. Utwórz i skonfiguruj agenta przy użyciu wybranego zestawu SDK lub witryny Azure Foundry Portal.

Skorzystaj z tego artykułu, aby dowiedzieć się więcej na temat konfigurowania środowiska agenta.

Wymagane uprawnienia

Akcja Wymagana rola
Tworzenie konta i projektu Właściciel konta usługi Azure AI
konfiguracja standardowa Tylko: przypisz kontroli dostępu opartej na rolach dla wymaganych zasobów (Cosmos DB, Search, Storage itp.) Administrator kontroli dostępu opartej na rolach
Tworzenie i edytowanie agentów Użytkownik sztucznej inteligencji platformy Azure

Konfigurowanie środowiska agenta

Do rozpoczęcia pracy potrzebny jest zasób rozwiązania Microsoft Foundry i projekt Foundry.
Agenci są tworzeni w ramach określonego projektu, a każdy projekt działa jako izolowany obszar roboczy. Oznacza to:

  • Wszyscy agenci w tym samym projekcie mają dostęp do tego samego magazynu plików, magazynu wątków (historii konwersacji) i indeksów wyszukiwania.
  • Dane są izolowane między projektami. Agenci w jednym projekcie nie mogą uzyskać dostępu do zasobów z innego. Projekty są obecnie jednostką udostępniania i izolacji na platformie Foundry. Aby uzyskać więcej informacji na temat projektów Foundry, zobacz artykuł czym jest AI Foundry.

Wymagania wstępne

  • Subskrypcja platformy Azure — utwórz bezpłatnie.
  • Upewnij się, że osoba tworząca konto i projekt ma rolę właściciela konta usługi Azure AI w zakresie subskrypcji
  • W przypadku konfigurowania standardowej konfiguracji ta sama osoba musi mieć również uprawnienia do przypisywania ról do wymaganych zasobów (Cosmos DB, Azure AI Search, Azure Blob Storage). Aby uzyskać więcej informacji na temat ról RBAC, specyficznych dla usługi agenta, zobacz Role RBAC usługi agenta.
    • Wymagana rola wbudowana to Administrator dostępu opartego na rolach.
    • Alternatywnie posiadanie roli Właściciel na poziomie subskrypcji spełnia również to wymaganie.
    • Wymagane jest główne uprawnienie: Microsoft.Authorization/roleAssignments/write

Wybierz konfigurację

Usługa agenta oferuje trzy tryby konfiguracji środowiska, które odpowiadają różnym potrzebom:

  • Konfiguracja podstawowa:

    Ta konfiguracja jest zgodna z asystentami OpenAI i zarządza stanami agentów przy użyciu wbudowanego magazynu platformy. Zawiera on te same narzędzia i możliwości, co interfejs API Asystentów, z dodatkową obsługą modeli i narzędzi innych niż OpenAI, takich jak usługa Azure AI Search i usługa Bing.

  • Konfiguracja Standardowa:

    Obejmuje wszystko w podstawowej konfiguracji i szczegółowej kontroli nad danymi, umożliwiając korzystanie z własnych zasobów platformy Azure. Wszystkie dane klienta — w tym pliki, wątki i magazyny wektorowe — są przechowywane we własnych zasobach platformy Azure, co zapewnia pełną własność i kontrolę.

  • Standardowa konfiguracja z siecią wirtualną Bring Your Own (BYO):

    Obejmuje wszystko w konfiguracji standardowej, z dodatkową możliwością działania w całości w ramach własnej sieci wirtualnej. Ta konfiguracja obsługuje sieć wirtualną Bring Your Own Virtual Network (BYO), umożliwiając ścisłą kontrolę nad przenoszeniem danych i pomaga zapobiegać eksfiltracji danych przez ograniczenie ruchu do środowiska sieciowego.

Porównanie opcji konfiguracji

Przypadki użycia Konfiguracja podstawowa Standardowa konfiguracja z siecią publiczną Standardowa konfiguracja z siecią prywatną
Szybkie rozpoczynanie pracy bez zarządzania zasobami
Wszystkie zapisy historii konwersacji, plików i wektorów są przechowywane we własnych zasobach
Obsługa kluczy zarządzanych przez klienta (CMK)
Izolacja sieci prywatnej (przynieś własną wirtualną sieć)

Opcje wdrożenia

Aby dostosować te szablony, zobacz Korzystanie z własnych zasobów.

Jeśli chcesz uzyskać obsługę izolacji sieci prywatnej, zobacz Konfiguracja zabezpieczona przez sieć aby uzyskać więcej informacji na temat tego, jak skonfigurować własną sieć wirtualną.

Opis i automatyczne wdrażanie Diagram (kliknij, aby powiększyć)
Wdróż podstawową konfigurację agenta, która używa tożsamości zarządzanej do uwierzytelniania.
Tworzone jest konto i projekt.
Wdrożono model GPT-4o.
Magazyn kluczy zarządzany przez firmę Microsoft jest domyślnie używany.
Wdrażanie na platformie Azure
Diagram architektury dla podstawowej konfiguracji agenta.
Wdróż standardową konfigurację agenta, która używa tożsamości zarządzanej do uwierzytelniania.
Tworzone jest konto i projekt.
Wdrożono model GPT-4o.
Zasoby platformy Azure do przechowywania danych klientów — Azure Storage, Azure Cosmos DB i Azure AI Search — są tworzone automatycznie, jeśli nie podano istniejących zasobów.
Te zasoby są połączone z projektem w celu przechowywania plików, wątków i danych wektorowych.
Magazyn kluczy zarządzany przez firmę Microsoft jest domyślnie używany.
Wdrażanie na platformie Azure
Diagram architektury dla standardowej konfiguracji agenta.

[Opcjonalnie] Wybór modelu w szablonie automatycznego wdrażania

Ważne

Nie zmieniaj parametru modelFormat.

Szablony obsługują tylko wdrażanie modeli usługi Azure OpenAI. Zobacz, które modele usługi Azure OpenAI są obsługiwane w artykule obsługi modeli.

Model używany przez agenta można dostosować, edytując parametry modelu w szablonie automatycznego wdrażania. Aby wdrożyć inny model, należy zaktualizować co najmniej parametry modelName i modelVersion.

Domyślnie szablon wdrożenia jest skonfigurowany z następującymi wartościami:

Parametr modelu Wartość domyślna
nazwa_modelu gpt-4o
modelFormat OpenAI (dla usługi Azure OpenAI)
wersja modelu 20.11.2024
nazwaModeluSKU GlobalStandard
lokalizacja modelu eastus

Co dalej?