Microsoft Foundry용 프로젝트 만들기

이 문서에서는 Microsoft Foundry에서 Foundry 프로젝트를 만드는 방법을 설명합니다. 프로젝트를 사용하면 상태 유지 앱을 개발하고 새로운 아이디어를 탐색할 때 에이전트, 평가, 파일 등 작업을 구성할 수 있습니다.

조직에서 대체 이름, 보안 제어 또는 비용 태그와 같은 사용자 지정된 Azure 구성이 필요한 경우 Azure Portal 또는 템플릿 옵션을 사용하여 조직의 Azure Policy 요구 사항을 준수해야 할 수 있습니다.

필수 조건

• 활성 구독이 있는 Azure 계정. 계정이 없는 경우 평가판 구독을 포함하는 무료 Azure 계정을 만듭니다.

• Azure 계정 AI 소유자 또는 Azure AI 소유자와 같은 Foundry 리소스를 만들 수 있는 역할에 대한 액세스 권한을 구독 또는 리소스 그룹에서 얻습니다. 권한에 대한 자세한 내용은 Microsoft Foundry에 대한 역할 기반 액세스 제어를 참조하세요.

• 다음 탭을 사용하여 Foundry 프로젝트를 만드는 데 사용할 방법을 선택합니다.

  파운드리 포털

  • 활성 구독이 있는 Azure 계정. 계정이 없는 경우 평가판 구독을 포함하는 무료 Azure 계정을 만듭니다.

  Python SDK

  • 개발 환경을 설정하세요

  • 코드 실행 전에 사용자 환경에서 az login 또는 az login --use-device-code을(를) 실행하세요.

  • 빠른 유효성 검사: 프로젝트를 만들기 전에 클라이언트를 테스트하여 SDK 및 인증이 작동하는지 확인합니다.

    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.")
    

  • Python 스크립트를 시작하려면 다음 단계를 완료합니다.

    1. 패키지 설치: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. 전자 필기장 셀에 있는 경우 %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에 추가하세요.

       DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
       

  Azure CLI

  • Azure CLI를 설치합니다.

  • 에 대한 subscription기본값을 설정합니다.

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

Foundry 프로젝트 만들기

파운드리 포털

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

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

1. Microsoft Foundry에 로그인합니다. New Foundry 토글이 설정되었는지 확인합니다. 이러한 단계는 Foundry(신규)를 참조합니다.

   

2. 작업 중인 프로젝트가 왼쪽 위 모서리에 나타납니다.

3. 새 프로젝트를 만들려면 프로젝트 이름을 선택한 다음 새 프로젝트 만들기를 선택합니다.

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

고급 옵션

1. 리소스에 Foundry 프로젝트를 만듭니다 Foundry . 프로젝트를 만들 때 포털에서 이 리소스를 자동으로 만듭니다. 사용할 기존 리소스 그룹을 선택하거나 기본값을 그대로 두고 새 리소스 그룹을 만듭니다.

   팁 (조언)

   특히 시작하려면 프로젝트에 대한 새 리소스 그룹을 만듭니다. 리소스 그룹을 사용하면 프로젝트와 모든 리소스를 쉽게 관리할 수 있습니다.

2. 위치를 선택하거나 기본값을 사용합니다. 위치는 프로젝트 리소스가 호스트되는 지역입니다.

3. 선택하고생성합니다. 리소스 만들기의 진행률이 표시됩니다. 프로세스가 완료되면 프로젝트가 만들어집니다.

Python SDK

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

• 다음 코드를 추가하여 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": {}
      }
  )
  

  참조: CognitiveServicesManagementClient.

Azure CLI

1. 리소스 그룹을 만들거나 기존 리소스 그룹을 사용합니다. 예를 들어 my-foundry-rg를 eastus에 생성합니다.

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

2. Foundry 리소스를 만듭니다. 예를 들어, my-foundry-resource 리소스 그룹에서 my-foundry-rg을 생성하십시오.

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

   플래그를 --allow-project-management 사용하면 이 리소스 내에서 프로젝트를 만들 수 있습니다.

3. 리소스에 대한 사용자 지정 하위 도메인을 만듭니다. 사용자 지정 도메인 이름은 전역적으로 고유해야 합니다. my-foundry-resource이 사용 중이라면, 더 고유한 이름을 사용해 보세요.

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

4. 프로젝트를 만듭니다. 예를 들어 my-foundry-project에서 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. 프로젝트가 만들어졌는지 확인합니다.

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

   출력에는 해당 리소스 ID를 포함한 프로젝트 속성이 표시됩니다.

참조: az cognitiveservices 계정

동일한 리소스에 여러 프로젝트 만들기

기존 Foundry 리소스에 여러 Foundry 프로젝트를 만들어 보안, 배포 및 연결된 도구를 비롯한 팀 공동 작업 및 공유 리소스 액세스를 사용하도록 설정합니다. 이 설정은 개발자가 미리 구성된 환경 설정 내에서 셀프 서비스 탐색 기능이 필요한 제한된 Azure 구독에 이상적입니다.

Azure 자식 리소스인 Foundry 프로젝트는 자체 액세스 제어를 할당받을 수 있지만 부모 리소스에서 네트워크 보안, 배포 및 Azure 도구 통합과 같은 일반적인 설정을 공유합니다.

모든 Foundry 기능이 아직 프로젝트에서 작업 구성을 지원하지는 않지만 리소스의 첫 번째 "기본" 프로젝트는 더 강력합니다. UX 환경의 "기본값" 태그와 코드 옵션을 사용할 때 리소스 속성 "is_default"로 식별할 수 있습니다.

특징	기본 프로젝트	기타 프로젝트
모델 유추	✅	✅
플레이그라운드	✅	✅
Agents	✅	✅
평가	✅	✅
추적	✅	✅
데이터세트	✅	✅
인덱스	✅	✅
Foundry SDK 및 API	✅	✅
콘텐츠 이해	✅	✅
OpenAI SDK 및 API	✅	응답, 파일, 대화
OpenAI Batch, 미세 조정, 저장된 결과	✅	-
언어 미세 조정	✅	✅
음성 미세 조정	✅	-
관계망	✅	✅

• Foundry 리소스에 프로젝트를 추가하려면 다음을 수행합니다.

  파운드리 포털

  Foundry(새) 포털에는 각 Foundry 리소스에 대한 기본 프로젝트만 표시됩니다. 여러 프로젝트를 만들거나 Foundry(새) 포털에서 기본이 아닌 프로젝트를 볼 수 없습니다.

  Python SDK

  이 코드는 리소스에 추가 프로젝트를 추가할 수 있지만 Foundry(새) 포털에서 볼 수 없습니다. Foundry(신규) 포털에서는 리소스에 대한 기본 프로젝트만 사용할 수 있습니다.
  스크립트에 이 코드를 추가하여 기존 리소스에 새 프로젝트를 만듭니다.

  # 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

  이 코드는 리소스에 추가 프로젝트를 추가할 수 있지만 Foundry(새) 포털에서 볼 수 없습니다. Foundry(신규) 포털에서는 리소스에 대한 기본 프로젝트만 사용할 수 있습니다. 새 프로젝트를 my-foundry-resource추가하려면:

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

• Foundry 리소스의 기본 프로젝트를 삭제하면 생성된 다음 프로젝트가 기본 프로젝트가 됩니다.

프로젝트 설정 보기

파운드리 포털

홈 프로젝트 페이지에 프로젝트의 프로젝트 엔드포인트 및 API 키가 표시됩니다. Microsoft Entra ID 인증을 사용하는 경우 API 키가 필요하지 않습니다.

Python SDK

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

참조: CognitiveServicesManagementClient.

Azure CLI

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

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

프로젝트 삭제

파운드리 포털

1. Microsoft Foundry에 로그인합니다. New Foundry 토글이 설정되었는지 확인합니다. 이러한 단계는 Foundry(신규)를 참조합니다.
2. 오른쪽 위 탐색 창에서 [작동]을 선택합니다.
3. 왼쪽 창에서 관리자를 선택합니다.
4. 프로젝트를 선택합니다.
5. 오른쪽 위에서 휴지통 아이콘을 선택하여 프로젝트를 삭제합니다.

Python SDK

이 코드는 필수 구성 요소와 client connection 변수를 사용합니다. 먼저 클라이언트 연결을 만듭니다.

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

참조: CognitiveServicesManagementClient.

Foundry 리소스 및 모든 프로젝트를 삭제합니다.

# 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()

참조: CognitiveServicesManagementClient.

Azure CLI

다음 명령을 실행합니다.

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

참조: az cognitiveservices 계정 프로젝트 삭제.

중요합니다

주의해서 사용하세요. 프로젝트를 삭제한 후에는 복구할 수 없습니다.

관련 콘텐츠

• Microsoft Foundry 빠른 시작
• Foundry란?