Tworzenie projektu dla usługi Microsoft Foundry (wersja klasyczna)

• W przypadku korzystania z portalu nie są wymagane żadne inne wymagania wstępne.

• Konfigurowanie środowiska projektowego.

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

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

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

• Szybka walidacja: przed utworzeniem projektu zweryfikuj zestaw SDK i uwierzytelnianie, 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.")
  

• 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 projekt tworzony jest 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"
  )
  

• (Opcjonalnie) Jeśli masz wiele kont, dodaj identyfikator dzierżawcę Microsoft Entra ID, którego chcesz użyć, do DefaultAzureCredential.

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

• (Opcjonalnie) Jeśli pracujesz w Azure Government — USA lub Azure obsługiwane przez 21Vianet regiony, określ region, do którego chcesz się uwierzytelnić. W tym przykładzie uwierzytelnia się w regionie Azure Government — Stany Zjednoczone:

  from azure.identity import AzureAuthorityHosts
  DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
  

• Zainstaluj Azure CLI.
• Ustaw wartość domyślną dla .subscription

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

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

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

1. Zaloguj się do Microsoft Foundry. Upewnij się, że przełącznik New Foundry jest wyłączony. Te kroki odnoszą się do rozwiązania Foundry (wersja klasyczna).

   

2. To, co robisz dalej, zależy od tego, gdzie jesteś:

   • Jeśli nie jesteś w projekcie lub nie masz jeszcze żadnych projektów: wybierz pozycję Utwórz nowy w prawym górnym rogu, aby utworzyć nowy projekt Foundry

     

   • Jeśli jesteś w projekcie: wybierz ścieżkę nawigacyjną projektu, a następnie wybierz Utwórz nowy zasób.

     

3. Wybierz pozycję Zasób foundry, a następnie wybierz pozycję Dalej.

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

Opcje zaawansowane

1. Utworzysz 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 pozycję Utwórz. Zobaczysz postęp tworzenia zasobów. Projekt jest tworzony po zakończeniu procesu.

Aby utworzyć projekt Foundry:

• Dodaj następujący kod, aby utworzyć projekt Foundry przy użyciu zmiennych i client połączenia z sekcji wymagań wstępnych.

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

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
   

   Sprawdź, czy grupa zasobów istnieje:

   az group show --name my-foundry-rg --query properties.provisioningState --output tsv
   

   Dane wyjściowe zawierają wartość Succeeded.

2. Utwórz zasób Foundry z włączonym zarządzaniem projektami. 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 \
       --custom-domain my-foundry-resource \
       --assign-identity \
       --allow-project-management true
   

   Użyj następujących wartości:

   Parametr	Purpose
   --assign-identity	Tworzy tożsamość zarządzaną wymaganą przez zarządzanie projektami. Bez niego tworzenie projektu kończy się niepowodzeniem z powodu błędu, że tożsamość zarządzana musi być włączona w zasobie.
   --allow-project-management	Umożliwia zarządzanie projektami. Nie można zmienić tego ustawienia po utworzeniu zasobu.
   --custom-domain	Musi ona być unikatowa w skali globalnej. Jeśli my-foundry-resource jest zajęte, polecenie zakończy się niepowodzeniem z komunikatem CustomDomainInUse. Wybierz inną nazwę i ponownie uruchom polecenie.

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

4. Sprawdź, czy zasób jest aprowizowany:

   az cognitiveservices account show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --query properties.provisioningState --output tsv
   

   Dane wyjściowe powinny wskazywać wartość Succeeded. Jeśli dane wyjściowe zawierają inny stan, sprawdź uprawnienia, dostępność regionu i limity przydziału zasobów. Aby uzyskać więcej pomocy, zobacz Tworzenie zasobu z wieloma usługami.

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 \
       --query properties.provisioningState --output tsv
   

   Dane wyjściowe powinny wskazywać wartość Succeeded. Jeśli polecenie zakończy się niepowodzeniem z komunikatem informującym, że należy włączyć tożsamość zarządzaną, upewnij się, że utworzono zasób za pomocą --assign-identity.

Dokumentacja referencyjna: az cognitiveservices account project

Na stronie Projekt główny znajdują się informacje o projekcie.

• Nazwa: nazwa projektu jest wyświetlana w lewym górnym rogu.
• Subskrypcja: subskrypcja, która hostuje zasób hostujący projekt.
• Grupa zasobów: grupa zasobów, która hostuje zasób hostujący projekt.

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

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

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

1. Zaloguj się do Microsoft Foundry. Upewnij się, że przełącznik New Foundry jest wyłączony. Te kroki odnoszą się do rozwiązania Foundry (wersja klasyczna).
2. Otwórz projekt.
3. Wybierz pozycję Centrum zarządzania.
4. W obszarze Zasób wybierz pozycję Przegląd.
5. Wybierz wszystkie projekty, które nie chcesz już zachować.
6. Wybierz pozycję Usuń projekt.

Aby usunąć zasób Foundry i wszystkie jego projekty:

1. W centrum zarządzania wybierz nazwę zasobu z sekcji Przegląd, aby przejść do portalu Azure.
2. W portalu Azure wybierz pozycję Delete aby usunąć zasób i wszystkie skojarzone z nim projekty.

Ten kod używa zmiennych i client połączenia z wymagań wstępnych. Aby usunąć pojedynczy projekt:

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.

Uruchom następujące polecenie:

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

Aby zweryfikować usunięcie, uruchom polecenie az cognitiveservices account project show z tymi samymi nazwami zasobów i projektów. Polecenie zwraca błąd „nie znaleziono zasobu”.

Odwołania: az cognitiveservices account project delete.