Azure AI Foundry용 프로젝트 만들기(Foundry 프로젝트)

• 활성 구독이 있는 Azure 계정. 계정이 없는 경우 평가판 구독을 포함하는 무료 Azure 계정을 만듭니다.
• 프로젝트의 부모인 Azure AI Foundry 리소스를 만드는 데 필요한 적절한 액세스 제어를 갖기 위해서는 구독의 소유자 여야 합니다. 이 액세스 권한이 없는 경우 관리자가 사용할 AI Foundry 리소스를 만들 도록 합니다. 그런 다음 동일한 리소스에 여러 프로젝트 만들기로 건너뛰어 프로젝트를 만듭니다.

• 활성 구독이 있는 Azure 계정. 계정이 없는 경우 평가판 구독을 포함하는 무료 Azure 계정을 만듭니다.
• 프로젝트를 사용하는 데 필요한 적절한 액세스 제어를 받으려면 구독의 소유자 여야 합니다.
• 개발 환경을 설정하세요
• 코드를 실행하기 전에 az login 또는 az login --use-device-code으로 사용자 환경에서 인증하십시오.
• Python 스크립트를 시작하려면 다음 단계를 완료합니다.

  1. 패키지 설치: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1 . Notebook 셀에 있는 경우 `. 대신 %pip install을 사용합니다.

  2. pip show azure-mgmt-cognitiveservices를 사용하여 버전이 13.7 이상인지 확인하십시오.

  3. 다음 코드로 스크립트를 시작하여 이 문서 전체에서 client 사용되는 연결 및 변수를 만듭니다. 이 예제에서는 미국 동부에서 프로젝트를 만듭니다.

     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. (선택 사항) 계정이 여러 개인 경우 사용하려는 Microsoft Entra ID의 테넌트 ID를 DefaultAzureCredential에 추가합니다. Azure Portal의 Microsoft Entra ID, 외부 ID에서 테넌트 ID를 찾습니다.

     DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
     

  5. (선택 사항) 21Vianet 지역에서 운영하는Azure Government - 미국 또는 Azure에서 작업하는 경우 인증할 지역을 지정합니다. DefaultAzureCredential을 사용하여 지역을 지정할 수 있습니다. 다음 예제에서는 Azure Government - 미국 지역에 대해 인증합니다.

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

• 활성 구독이 있는 Azure 계정. 계정이 없는 경우 평가판 구독을 포함하는 무료 Azure 계정을 만듭니다.
• 프로젝트를 사용하는 데 필요한 적절한 액세스 제어를 받으려면 구독의 소유자 여야 합니다.
• Azure CLI

이러한 단계는 기본 설정으로 새 Azure 리소스를 만드는 방법을 제공합니다.

Azure AI Foundry에서 Foundry 프로젝트를 만들려면 다음 단계를 수행합니다.

1. Azure AI Foundry에 로그인합니다.

2. 다음에 수행할 작업은 현재 위치에 따라 달라집니다.

   • 기존 프로젝트가 없는 경우: 빠른 시작의 단계에 따라 Azure AI Foundry를 시작하여 첫 번째 프로젝트를 만듭니다.

   • 프로젝트에 있다면: 프로젝트 탐색 경로를 선택한 다음, 새 리소스 만들기를 선택합니다.

     

   • 프로젝트에 없는 경우: 오른쪽 위에서 새로 만들기 를 선택하여 새 Azure AI Foundry 프로젝트를 만듭니다.

     

3. Azure AI Foundry 리소스를 선택한 다음, 다음을 선택합니다.

4. 프로젝트의 이름을 입력하고 만들기를 선택합니다. 또는 고급 옵션에 대한 다음 섹션을 참조하세요.

고급 옵션

Foundry 프로젝트는 AI Foundry 리소스에서 만들어집니다. 이 리소스는 프로젝트를 만들 때 자동으로 만들어집니다.

프로젝트에 대한 설정을 사용자 지정하려면 다음 단계를 수행합니다.

1. 프로젝트 만들기 양식에서 고급 옵션을 선택합니다.

2. 사용할 기존 리소스 그룹을 선택하거나 기본값을 그대로 두고 새 리소스 그룹을 만듭니다.

   팁 (조언)

   특히 시작하기 위해 프로젝트에 대한 새 리소스 그룹을 만드는 것이 좋습니다. 리소스 그룹을 사용하면 프로젝트와 모든 리소스를 쉽게 함께 관리할 수 있습니다.

3. 위치를 선택하거나 기본값을 사용합니다. 위치는 허브가 호스트되는 지역입니다. Azure AI 서비스 가용성은 지역마다 다릅니다. 예를 들어, 특정 모델은 특정 지역에서 사용하지 못할 수도 있습니다.

4. 선택하고생성합니다. 리소스 만들기 진행률을 확인하고 프로세스가 완료되면 프로젝트가 만들어집니다.

Foundry 프로젝트를 만들려면 다음을 수행합니다.

1. client의 변수 및 연결을 사용하여 Foundry 프로젝트를 만들려면 이 코드를 추가합니다.

   # 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": {}
       }
   )
   

현재 Foundry 프로젝트를 만드는 데 사용할 수 없는 CLI 명령입니다.

프로젝트 홈 페이지에서 프로젝트에 대한 정보를 찾을 수 있습니다.

• 이름: 프로젝트 이름은 왼쪽 상단에 나타납니다.
• 구독: 프로젝트를 호스트하는 허브를 호스트하는 구독입니다.
• 리소스 그룹: 프로젝트를 호스트하는 허브를 호스트하는 리소스 그룹입니다.

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

프로젝트 설정을 보려면 az cognitiveservices account connection show 명령을 사용합니다. 다음은 그 예입니다.

az cognitiveservices account connection show --name {my_project_name} --resource-group {my_resource_group}