환경 설정

2025-06-19

Azure AI Foundry 에이전트 서비스를 사용하여 첫 번째 에이전트를 만드는 것은 2단계 프로세스입니다.

에이전트 환경을 설정합니다.
선택한 SDK 또는 Azure Foundry 포털을 사용하여 에이전트를 만들고 구성합니다.

이 문서를 사용하여 에이전트 환경 설정에 대해 자세히 알아보세요.

필요한 권한

조치	필수 역할
계정 및 프로젝트 만들기	Azure AI 계정 소유자
표준 설정 만: 필요한 리소스에 RBAC 할당(Cosmos DB, 검색, 스토리지 등)	역할 기반 액세스 제어 관리자
에이전트 만들기 및 편집	Azure AI 사용자

에이전트 환경 설정

시작하려면 Azure AI Foundry 리소스 및 Foundry 프로젝트가 필요합니다.
에이전트는 특정 프로젝트 내에서 만들어지고 각 프로젝트는 격리된 작업 영역 역할을 합니다. 즉, 다음을 의미합니다.

동일한 프로젝트의 모든 에이전트는 동일한 파일 스토리지, 스레드 스토리지(대화 기록) 및 검색 인덱스에 대한 액세스를 공유합니다.
데이터는 프로젝트 간에 격리됩니다. 한 프로젝트의 에이전트는 다른 프로젝트의 리소스에 액세스할 수 없습니다. 프로젝트는 현재 Foundry에서 공유 및 격리의 단위입니다. Foundry 프로젝트에 대한 자세한 내용은 AI 파운드리 문서를 참조하세요.

필수 조건

Azure 구독 – 무료로 만드세요.
계정 및 프로젝트를 만드는 개인에게 구독 범위에서 Azure AI 계정 소유자 역할이 있는지 확인합니다.
표준 설정을 구성하는 경우 동일한 개인이 필요한 리소스(Cosmos DB, Azure AI Search, Azure Blob Storage)에 역할을 할당할 수 있는 권한도 있어야 합니다. Azure AI Foundry 에이전트 서비스와 관련된 RBAC 역할에 대한 자세한 내용은 Azure AI Foundry 에이전트 서비스 RBAC 역할을 참조하세요.
- 필요한 기본 제공 역할은 역할 기반 액세스 관리자입니다.
- 또는 구독 수준에서 소유자 역할을 갖는 것도 이 요구 사항을 충족합니다.
- 필요한 키 권한은 다음과 같습니다. Microsoft.Authorization/roleAssignments/write

설정 선택

Azure AI Foundry 에이전트 서비스는 다양한 요구 사항에 맞게 세 가지 환경 구성 모드를 제공합니다.

기본 설정:

이 설정은 OpenAI Assistants와 호환되며 플랫폼의 기본 제공 스토리지를 사용하여 에이전트 상태를 관리합니다. Azure AI Search 및 Bing과 같은 비 OpenAI 모델 및 도구에 대한 지원이 추가된 Assistants API와 동일한 도구와 기능이 포함되어 있습니다.
표준 설정:

사용자 고유의 Azure 리소스를 사용할 수 있도록 하여 기본 설정의 모든 항목과 데이터에 대한 세분화된 제어를 포함합니다. 파일, 스레드 및 벡터 저장소를 포함한 모든 고객 데이터는 사용자 고유의 Azure 리소스에 저장되어 완전한 소유권과 제어를 제공합니다.
BYO(Bring Your Own) Virtual Network를 사용하는 표준 설정:

사용자 고유의 가상 네트워크 내에서 완전히 작동할 수 있는 기능이 추가된 표준 설정의 모든 항목이 포함됩니다. 이 설정은 BYO 가상 네트워크(Bring Your Own Virtual Network)를 지원하여 데이터 이동을 엄격하게 제어하고 트래픽을 네트워크 환경에 제한하여 데이터 반출을 방지할 수 있도록 지원합니다.

설정 옵션 비교

사용 사례	기본 설정	공용 네트워킹을 사용하여 표준 설정	프라이빗 네트워킹을 사용하여 표준 설정
리소스를 관리하지 않고 빠르게 시작	✅
모든 대화 기록, 파일 및 벡터 저장소는 사용자 고유의 리소스에 저장됩니다.		✅	✅
CMK(고객 관리형 키) 지원		✅	✅
프라이빗 네트워크 격리(사용자 고유의 가상 네트워크 가져오기)			✅

배포 옵션

이러한 템플릿을 사용자 지정하려면 사용자 고유의 리소스 사용을 참조하세요.

프라이빗 네트워크 격리를 지원하려면 사용자 고유의 가상 네트워크를 가져오는 방법에 대한 자세한 내용은 네트워크 보안 설정을 참조하세요.

설명 및 자동 배포	다이어그램(클릭하면 확대됨)
인증에 관리 ID 를 사용하는 기본 에이전트 설정을 배포합니다. 계정 및 프로젝트가 만들어집니다. GPT-4o 모델이 배포됩니다. Microsoft 관리형 Key Vault는 기본적으로 사용됩니다.
인증에 관리 ID 를 사용하는 표준 에이전트 설정을 배포합니다. 계정 및 프로젝트가 만들어집니다. GPT-4o 모델이 배포됩니다. 고객 데이터를 저장하기 위한 Azure 리소스( Azure Storage, Azure Cosmos DB 및 Azure AI Search )는 기존 리소스가 제공되지 않으면 자동으로 만들어집니다. 이러한 리소스는 파일, 스레드 및 벡터 데이터를 저장하기 위해 프로젝트에 연결됩니다. Microsoft 관리형 Key Vault는 기본적으로 사용됩니다.

설명 및 자동 배포

다이어그램(클릭하면 확대됨)

인증에 관리 ID 를 사용하는 기본 에이전트 설정을 배포합니다.
계정 및 프로젝트가 만들어집니다.
GPT-4o 모델이 배포됩니다.
Microsoft 관리형 Key Vault는 기본적으로 사용됩니다.

인증에 관리 ID 를 사용하는 표준 에이전트 설정을 배포합니다.
계정 및 프로젝트가 만들어집니다.
GPT-4o 모델이 배포됩니다.
고객 데이터를 저장하기 위한 Azure 리소스( Azure Storage, Azure Cosmos DB 및 Azure AI Search )는 기존 리소스가 제공되지 않으면 자동으로 만들어집니다.
이러한 리소스는 파일, 스레드 및 벡터 데이터를 저장하기 위해 프로젝트에 연결됩니다.
Microsoft 관리형 Key Vault는 기본적으로 사용됩니다.

[선택 사항] 자동 배포 템플릿에서 모델 선택

중요합니다

modelFormat 매개 변수를 변경하지 마세요.

템플릿은 Azure OpenAI 모델의 배포만 지원합니다. 모델 지원 문서에서 지원되는 Azure OpenAI 모델을 확인합니다.

자동 배포 템플릿에서 모델 매개 변수를 편집하여 에이전트에서 사용하는 모델을 사용자 지정할 수 있습니다. 다른 모델을 배포하려면 최소한 modelName 및 modelVersion 매개 변수를 업데이트해야 합니다.

기본적으로 배포 템플릿은 다음 값으로 구성됩니다.

모델 매개 변수	기본값
모델 이름	gpt-4o
모델 포맷	OpenAI(Azure OpenAI용)
모델 버전	2024년 11월 20일
모델 SKU 명칭	GlobalStandard
modelLocation	이스트유스

다음 단계는 무엇인가요?

첫 번째 에이전트 만들기
자세히 살펴보기:
- 기존 리소스 사용
- 네트워크 보안 에이전트 설정