Tworzenie projektu dla rozwiązania Microsoft Foundry

W tym artykule opisano sposób tworzenia projektu Foundry w rozwiązaniu Microsoft Foundry. Projekty umożliwiają organizowanie pracy — na przykład agentów, ocen i plików — podczas tworzenia aplikacji stanowych i eksplorowania nowych pomysłów.

Jeśli Twoja organizacja wymaga dostosowanych konfiguracji platformy Azure, takich jak alternatywne nazwy, mechanizmy kontroli zabezpieczeń lub tagi kosztów, może być konieczne użycie portalu Azure lub opcji szablonów, aby spełnić wymagania polityki Azure w Twojej organizacji.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Jeśli go nie masz, utwórz bezpłatne konto platformy Azure, które obejmuje subskrypcję bezpłatnej wersji próbnej.

• Dostęp do roli, która umożliwia utworzenie zasobu usługi Foundry, takiego jak właściciel konta platformy Azure lub właściciel usługi Azure AI w subskrypcji lub grupie zasobów. Aby uzyskać więcej informacji na temat uprawnień, zobacz Kontrola dostępu oparta na rolach dla usługi Microsoft Foundry.

• Użyj następujących kart, aby wybrać metodę, której chcesz użyć do utworzenia projektu Foundry:

  Portal usługi Foundry

  • Konto platformy Azure z aktywną subskrypcją. Jeśli go nie masz, utwórz bezpłatne konto platformy Azure, które obejmuje subskrypcję bezpłatnej wersji próbnej.

  Zestaw SDK dla języka Python

  • Konfigurowanie środowiska projektowego

  • Uruchom az login lub az login --use-device-code w swoim środowisku przed uruchomieniem kodu.

  • Szybka walidacja: przed utworzeniem projektu sprawdź, czy zestaw SDK i uwierzytelnianie działają, testując klienta:

    from azure.identity import DefaultAzureCredential
    from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
    
    # Test authentication by instantiating the client
    credential = DefaultAzureCredential()
    subscription_id = "<your-subscription-id>"  # Replace with your subscription ID
    client = CognitiveServicesManagementClient(credential, subscription_id)
    print("✓ Authentication successful! Ready to create a project.")
    

  • Wykonaj następujące kroki, aby uruchomić skrypt języka Python:

    1. Zainstaluj pakiety: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. Jeśli jesteś w komórce notatnika, użyj %pip install zamiast tego.

    2. Użyj polecenia pip show azure-mgmt-cognitiveservices , aby sprawdzić, czy wersja ma wartość 13.7 lub nowszą.

    3. Uruchom skrypt przy użyciu następującego kodu, aby utworzyć client połączenie i zmienne używane w tym artykule. W tym przykładzie tworzony jest projekt w regionie Wschodnie USA:

       from azure.identity import DefaultAzureCredential
       from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
       
       subscription_id = 'your-subscription-id'
       resource_group_name = 'your-resource-group-name'
       foundry_resource_name = 'your-foundry-resource-name'
       foundry_project_name = 'your-foundry-project-name'
       location = 'eastus'
       
       client = CognitiveServicesManagementClient(
           credential=DefaultAzureCredential(), 
           subscription_id=subscription_id,
           api_version="2025-04-01-preview"
       )
       

    4. (Optional) Jeśli masz wiele kont, dodaj identyfikator dzierżawy Microsoft Entra ID, którego chcesz użyć w DefaultAzureCredential.

       DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
       

  Azure CLI

  • Zainstaluj interfejs wiersza polecenia platformy Azure.

  • Ustaw wartości domyślne dla elementu subscription.

      # Set your default subscription
      az account set --subscription "{subscription-name}"
    

Tworzenie projektu Foundry

Portal usługi Foundry

Te kroki umożliwiają utworzenie nowego zasobu platformy Azure z podstawowymi, domyślnymi ustawieniami.

Aby utworzyć projekt Foundry, wykonaj następujące kroki:

1. Zaloguj się do usługi Microsoft Foundry. Upewnij się, że przełącznik New Foundry jest włączony. Te czynności dotyczą Foundry (new).

   

2. Projekt, nad którym pracujesz, jest wyświetlany w lewym górnym rogu.

3. Aby utworzyć nowy projekt, wybierz nazwę projektu, a następnie wybierz pozycję Utwórz nowy projekt.

4. Nadaj projektowi nazwę i wybierz pozycję Utwórz projekt. Możesz też zapoznać się z następną sekcją dotyczącą opcji zaawansowanych.

Opcje zaawansowane

1. Tworzysz projekt Foundry na zasobie Foundry. Portal automatycznie tworzy ten zasób podczas tworzenia projektu. Wybierz istniejącą grupę zasobów do użycia lub pozostaw wartość domyślną, aby utworzyć nową grupę zasobów.

   Wskazówka

   Szczególnie w przypadku rozpoczynania pracy utwórz nową grupę zasobów dla projektu. Grupa zasobów ułatwia zarządzanie projektem i wszystkimi jej zasobami.

2. Wybierz lokalizację lub użyj wartości domyślnej. Lokalizacja to region, w którym są hostowane zasoby projektu.

3. Wybierz Utwórz. Zobaczysz postęp tworzenia zasobów. Projekt jest tworzony po zakończeniu procesu.

Zestaw SDK dla języka Python

Aby utworzyć projekt Foundry:

• Dodaj następujący kod, aby utworzyć projekt Foundry przy użyciu zmiennych oraz połączenia client z sekcji Wymagania wstępne.

  # Create resource
  resource = client.accounts.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      account={
          "location": location,
          "kind": "AIServices",
          "sku": {"name": "S0",},
          "identity": {"type": "SystemAssigned"},
          "properties": {
              "allowProjectManagement": True,
              "customSubDomainName": foundry_resource_name
          }
      }
  )
  
  # Wait for the resource creation to complete
  resource_result = resource.result()
  
  # Create default project
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=foundry_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  Odwołania: CognitiveServicesManagementClient.

Azure CLI

1. Utwórz grupę zasobów lub użyj istniejącej. Na przykład utwórz my-foundry-rg w eastus:

   az group create --name my-foundry-rg --location eastus
   

2. Utwórz zasób Foundry. Na przykład utwórz my-foundry-resource w my-foundry-rg grupie zasobów:

   az cognitiveservices account create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --kind AIServices \
       --sku s0 \
       --location eastus \
      --allow-project-management
   

   Flaga --allow-project-management umożliwia tworzenie projektu w ramach tego zasobu.

3. Utwórz niestandardową poddomenę dla zasobu. Nazwa domeny niestandardowej musi być globalnie unikatowa. Jeśli my-foundry-resource jest zajęta, spróbuj użyć bardziej unikatowej nazwy.

   az cognitiveservices account update \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --custom-domain my-foundry-resource
   

4. Utwórz projekt. Na przykład utwórz my-foundry-project w my-foundry-resource:

   az cognitiveservices account project create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --location eastus
   

5. Sprawdź, czy projekt został utworzony:

   az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project
   

   Dane wyjściowe wyświetlają właściwości projektu, w tym jego identyfikator zasobu.

Odniesienie: az cognitiveservices account

Tworzenie wielu projektów w tym samym zasobie

Utwórz wiele projektów Foundry na istniejącym Foundry zasobie, aby umożliwić współpracę zespołową i dostęp do wspólnych zasobów, w tym zabezpieczeń, wdrożeń i narzędzi połączonych. Ta konfiguracja jest idealna w ograniczonych subskrypcjach platformy Azure, w których deweloperzy potrzebują możliwości samodzielnej eksploracji w ramach konfiguracji wstępnie skonfigurowanego środowiska.

Projekty Foundry jako zasoby podrzędne Azure mogą mieć przypisane własne mechanizmy kontroli dostępu, ale dzielą wspólne ustawienia, takie jak zabezpieczenia sieciowe, wdrożenia i integracja z narzędziami Azure z zasobem nadrzędnym.

Chociaż nie wszystkie funkcje usługi Foundry jeszcze nie obsługują organizowania pracy w projektach, pierwszy „domyślny” projekt zasobu jest wydajniejszy. Można go zidentyfikować za pomocą tagu "default" w interfejsie użytkownika (UX) oraz właściwości zasobu "is_default" w przypadku opcji kodu.

Funkcja	Projekt domyślny	Inne projekty
Wnioskowanie modelu	✅	✅
Place zabaw	✅	✅
Agents	✅	✅
Evaluations	✅	✅
Śledzenie	✅	✅
Zbiory danych	✅	✅
Indexes	✅	✅
Zestaw SDK i interfejs API usługi Foundry	✅	✅
Zrozumienie treści	✅	✅
Zestaw OPENAI SDK i interfejs API	✅	Odpowiedzi, pliki, konwersacje
OpenAI Batch, dostrajanie, przechowywane rezultaty	✅	-
Dostrajanie języka	✅	✅
Dostrajanie mowy	✅	-
Connections	✅	✅

• Aby dodać projekt do zasobu Foundry:

  Portal usługi Foundry

  Portal Foundry (nowy) wyświetla tylko domyślny projekt dla każdego zasobu Foundry. Nie można utworzyć wielu projektów ani wyświetlić żadnego z projektów niezdefinicyjnych w portalu Foundry (nowy).

  Zestaw SDK dla języka Python

  Chociaż ten kod może dodawać dodatkowe projekty do zasobu, nie będzie można ich wyświetlić w portalu Foundry (nowy). Tylko domyślny projekt zasobu jest dostępny w portalu Foundry (nowy).
  Dodaj ten kod do skryptu, aby utworzyć nowy projekt w istniejącym zasobie:

  # Create additional project
  new_project_name = 'your-new-project-name'
  
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=new_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  Azure CLI

  Chociaż ten kod może dodawać dodatkowe projekty do zasobu, nie będzie można ich wyświetlić w portalu Foundry (nowy). Tylko domyślny projekt zasobu jest dostępny w portalu Foundry (nowy). Aby dodać nowy projekt do programu my-foundry-resource:

   az cognitiveservices account project create \
   --name my-foundry-resource \
   --project-name {new_project_name} \
   --location eastus
  

• Jeśli usuniesz domyślny projekt zasobu Foundry, następny utworzony projekt stanie się domyślnym projektem.

Wyświetlanie ustawień projektu

Portal usługi Foundry

Na stronie Projekt główny zobaczysz punkt końcowy projektu i klucz interfejsu API dla projektu. Nie potrzebujesz klucza interfejsu API, jeśli używasz uwierzytelniania Microsoft Entra ID.

Zestaw SDK dla języka Python

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

Odwołania: CognitiveServicesManagementClient.

Azure CLI

Aby wyświetlić ustawienia projektu, użyj az cognitiveservices account connection show polecenia . Przykład:

az cognitiveservices account connection show \
--name my-foundry-project \
--resource-group my-foundry-rg

Usuwanie projektów

Portal usługi Foundry

1. Zaloguj się do usługi Microsoft Foundry. Upewnij się, że przełącznik New Foundry jest włączony. Te kroki dotyczą rozwiązania Foundry (nowy).
2. W prawym górnym rogu nawigacji wybierz pozycję Obsługa.
3. W okienku po lewej stronie wybierz pozycję Administrator.
4. Wybierz projekt.
5. W prawym górnym rogu wybierz ikonę kosza, aby usunąć projekt.

Zestaw SDK dla języka Python

Ten kod używa zmiennych i client connection z wymagań wstępnych. Najpierw utwórz połączenie klienta:

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

Odwołania: CognitiveServicesManagementClient.

Usuń zasób foundry i wszystkie jego projekty:

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

Odwołania: CognitiveServicesManagementClient.

Azure CLI

Uruchom następujące polecenie:

az cognitiveservices account project delete \
--name my-foundry-rg \
--project-name my-foundry-project

Odwołania: az cognitiveservices account project delete.

Ważna

Używaj ostrożnie. Nie można odzyskać projektu po jego usunięciu.

Treści powiązane

• Przewodnik Szybki start dotyczący rozwiązania Microsoft Foundry
• Co to jest foundry?