Microsoft Foundry용 project 만들기

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

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

필수 조건

• 활성 구독이 있는 Azure 계정입니다. 계정이 없는 경우 무료 Azure 계정을 만드세요. 여기에는 무료 평가판 구독이 포함됩니다.

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

• 다음 탭을 사용하여 Foundry project 만드는 데 사용할 방법을 선택합니다.

  파운드리 포털

  • 활성 구독이 있는 Azure 계정입니다. 계정이 없는 경우 무료 Azure 계정을 만드세요. 여기에는 무료 평가판 구독이 포함됩니다.

  Python SDK

  • 개발 환경을 설정하세요

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

  • 유효성 검사: project 만들기 전에 클라이언트를 테스트하여 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. (선택 사항) 여러 계정이 있는 경우 DefaultAzureCredential에 사용하려는 Microsoft Entra ID의 테넌트 ID를 추가하십시오.

       DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
       

  Azure CLI

  • Azure CLI 설치합니다.

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

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

Foundry project 만들기

파운드리 포털

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

Foundry project 만들려면 다음 단계를 수행합니다.

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

   

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

3. 새 project 만들려면 project 이름을 선택한 다음 새 project 선택합니다.

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

고급 옵션

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

   팁 (조언)

   시작할 때 특히, 당신의 프로젝트를 위해 새로운 리소스 그룹을 만드세요. 리소스 그룹을 사용하면 project 모든 리소스를 쉽게 관리할 수 있습니다.

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

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

Python SDK

Foundry project 만들려면 다음을 수행합니다.

• 다음 코드를 추가하여 변수 및 client의 연결을 사용하여 Foundry project 만듭니다.

  # 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 플래그를 사용하면 이 리소스 내에서 project 만들 수 있습니다.

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

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

4. 프로젝트를 만드십시오. 예를 들어 my-foundry-resource에서 my-foundry-project을(를) 만듭니다.

   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를 포함하여 project 속성이 표시됩니다.

참조: az cognitiveservices 계정

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

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

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

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

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

• Foundry 리소스에 project 추가하려면 다음을 수행합니다.

  파운드리 포털

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

  Python SDK

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

  # 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(새) 포털에서 볼 수 없습니다. 리소스의 기본 프로젝트는 파운드리 새 포털에서만 사용할 수 있습니다. my-foundry-resource 새 project 추가하려면 다음을 수행합니다.

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

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

project 설정 보기

파운드리 포털

Home 프로젝트 페이지에서 프로젝트의 엔드포인트와 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

project 대한 설정을 보려면 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. 오른쪽 위에서 휴지통 아이콘을 선택하여 project 삭제합니다.

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 인지 서비스 계정 프로젝트 삭제.

중요합니다

주의해서 사용하세요. 삭제된 후에는 project 복구할 수 없습니다.

관련 콘텐츠

• Microsoft Foundry 빠른 시작
• Foundry란?