자체 리소스를 사용하여 Foundry 프로젝트를 설정하려면 이 문서를 사용합니다.
Limitations
Azure AI Foundry 에이전트 서비스에서 기존 리소스를 사용하려는 경우 알아야 할 몇 가지 제한 사항이 있습니다.
허브 기반 프로젝트 또는 Azure OpenAI Assistants를 사용하는 경우
현재는 기존 에이전트 또는 관련 데이터 자산(예: 파일, 스레드 또는 벡터 저장소)을 허브 기반 프로젝트에서 Azure AI Foundry 프로젝트로 마이그레이션하기 위한 직접 업그레이드 경로가 없습니다. 또한 기존 Azure OpenAI Assistants를 Foundry 에이전트로 변환하는 업그레이드 경로도 없으며 Assistants의 파일, 스레드 또는 벡터 저장소를 자동으로 마이그레이션하는 방법도 없습니다.
Foundry 프로젝트 내에서 Azure AI Services 또는 Azure OpenAI 리소스에서 기존 모델 배포 및 할당량을 다시 사용할 수 있습니다.
허브 기반 프로젝트의 SDK 사용량
Starting in May 2025, the Azure AI Agent Service uses an endpoint for Foundry projects instead of the connection string that was used for hub-based projects before this time. 연결 문자열은 현재 버전의 SDK 및 REST API에서 더 이상 지원되지 않습니다. 새 주조 프로젝트를 만드는 것이 좋습니다.
허브 기반 프로젝트 및 연결 문자열을 계속 사용하려면 다음을 수행해야 합니다.
Use the connection string for your project located under Connection string in the overview of your project.
이전 버전의 SDK 및 관련 샘플 코드 중 하나를 사용합니다.
스레드를 저장하는 NoSQL용 Azure Cosmos DB
- Your existing Azure Cosmos DB for NoSQL account used in a standard setup must have a total throughput limit of at least 3000 RU/s. 프로비전된 처리량과 서버리스 모두 지원됩니다.
- 3개의 컨테이너가 기존 Cosmos DB 계정에 프로비전되며 각각 1000RU/s가 필요합니다.
Note
- Azure OpenAI 리소스와 Azure AI Foundry 계정 및 프로젝트가 동일한 지역에 있는지 확인합니다.
Prerequisites
Azure 구독 – 무료로 만드세요.
계정 및 프로젝트를 만드는 개인에게 구독 범위에서 Azure AI 계정 소유자 역할이 있는지 확인합니다.
If configuring a standard setup, the same individual must also have permissions to assign roles to required resources (Cosmos DB, Search, Storage). Azure AI Foundry의 RBAC에 대한 자세한 내용은 Azure AI Foundry의 RBAC를 참조하세요.
- 필요한 기본 제공 역할은 역할 기반 액세스 관리자입니다.
- Alternatively, having the Owner role at the subscription level also satisfies this requirement.
- 필요한 키 권한은 다음과 같습니다.
Microsoft.Authorization/roleAssignments/write
Register providers. 다음 공급자를 등록해야 합니다.
Microsoft.KeyVaultMicrosoft.CognitiveServicesMicrosoft.StorageMicrosoft.MachineLearningServicesMicrosoft.SearchMicrosoft.AppMicrosoft.ContainerService-
Bing Search 도구로 그라운딩을 사용하려면:
Microsoft.Bing
az provider register --namespace 'Microsoft.KeyVault' az provider register --namespace 'Microsoft.CognitiveServices' az provider register --namespace 'Microsoft.Storage' az provider register --namespace 'Microsoft.MachineLearningServices' az provider register --namespace 'Microsoft.Search' az provider register --namespace 'Microsoft.App' az provider register --namespace 'Microsoft.ContainerService' # only to use Grounding with Bing Search tool az provider register --namespace 'Microsoft.Bing'
기본 또는 표준 에이전트 설정 선택
사용자 고유의 리소스를 사용하려면 제공된 배포 템플릿에서 매개 변수를 편집할 수 있습니다. 시작하려면 기본 에이전트 설정 템플릿 또는 표준 에이전트 설정 템플릿을 편집할지 확인합니다.
Basic Setup
이 설정은 OpenAI Assistants와 호환되며 플랫폼의 기본 제공 스토리지를 사용하여 에이전트 상태를 관리합니다. Azure AI Search 및 Bing과 같은 비 OpenAI 모델 및 도구에 대한 지원이 추가된 Assistants API와 동일한 도구와 기능이 포함되어 있습니다.
Standard Setup
사용자 고유의 Azure 리소스를 사용할 수 있도록 하여 기본 설정의 모든 항목과 데이터에 대한 세분화된 제어를 포함합니다. 파일, 스레드 및 벡터 저장소를 포함한 모든 고객 데이터는 사용자 고유의 Azure 리소스에 저장되어 완전한 소유권과 제어를 제공합니다.
기본 에이전트 설정: 기존 Azure OpenAI 리소스 사용
Replace the parameter value for existingAoaiResourceIdin the template with the full arm resource ID of the Azure OpenAI resource you want to use.
Azure OpenAI 계정 리소스 ID를 가져오려면 Azure CLI에 로그인하고 AI Services 계정으로 구독을 선택합니다.
az login<your-resource-group>리소스your-azure-openai-resource-name를 포함하는 리소스 그룹과 AI Service 리소스의 이름으로 바꾸고 다음을 실행합니다.az cognitiveservices account show --resource-group <your-resource-group> --name <your-ai-service-resource-name> --query "id" --output tsv반환되는 값은 템플릿에서 사용해야 하는 값입니다
existingAoaiResourceId.기본 에이전트 템플릿 파일에서 다음과 같은 자리 표시자를 바꾸세요.
existingAoaiResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
표준 에이전트 설정: 기존 서비스 리소스 및 스토리지 계정 사용
표준 에이전트 템플릿 파일에 전체 ARM 리소스 ID를 제공하여 기존 Azure OpenAI, Azure Storage 계정, NoSQL용 Azure Cosmos DB 계정 및/또는 Azure AI Search 리소스를 사용합니다.
기존 Azure OpenAI 리소스 사용
기본 에이전트 설정의 단계에 따라 AI Services 계정 리소스 ID를 가져옵니다.
표준 에이전트 템플릿 파일에서 다음 자리 표시자를 대체합니다.
existingAoaiResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
파일 스토리지에 기존 Azure Storage 계정 사용
스토리지 계정 리소스 ID를 가져오려면 Azure CLI에 로그인하고 스토리지 계정으로 구독을 선택합니다.
az login그런 다음, 명령을 실행합니다.
az storage account show --resource-group <your-resource-group> --name <your-storage-account> --query "id" --output tsv출력은
aiStorageAccountResourceID템플릿에서 사용해야 하는 출력입니다.표준 에이전트 템플릿 파일에서 다음 자리 표시자를 대체합니다.
aiStorageAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}
스레드 스토리지에 기존 Azure Cosmos DB for NoSQL 계정 사용
NoSQL용 Azure Cosmos DB
- 표준 설정에 사용되는 기존 Azure Cosmos DB for NoSQL 계정에는 최소 3,000RU/s의 총 처리량 제한이 있어야 합니다. 프로비전된 처리량과 서버리스가 모두 지원됩니다.
- 기존 Cosmos DB 계정에 3개의 컨테이너가 프로비전되고 각각 1000RU/s가 필요합니다.
Azure Cosmos DB 계정 리소스 ID를 가져오려면 Azure CLI에 로그인하고 계정으로 구독을 선택합니다.
az login그런 다음, 명령을 실행합니다.
az cosmosdb show --resource-group <your-resource-group> --name <your-comosdb-account> --query "id" --output tsv출력은
cosmosDBResourceId템플릿에서 사용해야 하는 출력입니다.표준 에이전트 템플릿 파일에서 다음 자리 표시자를 대체합니다.
cosmosDBResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{cosmosDbAccountName}
기존 Azure AI Search 리소스 사용
Azure AI Search 리소스 ID를 가져오려면 Azure CLI에 로그인하고 검색 리소스를 사용하여 구독을 선택합니다.
az login그런 다음, 명령을 실행합니다.
az search service show --resource-group <your-resource-group> --name <your-search-service> --query "id" --output tsv표준 에이전트 템플릿 파일에서 다음 자리 표시자를 대체합니다.
aiSearchServiceResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}
See also
- Learn about the different tools agents can use.