SDK로 프로젝트 시작하기

Azure AI Foundry를 코드에서 다루는 방법은 Azure AI Projects 클라이언트 라이브러리를 쓰는 거예요. 이 라이브러리는 하나의 프로젝트 엔드포인트에 연결해서 여러 클라이언트를 함께 쓰게 해 주는 통합 라이브러리예요.

출처: https://learn.microsoft.com/azure/ai-foundry

설치

최신 Foundry 프로젝트 환경에서는 파이썬 2.x 안정판을 권장해요. 파이썬 기준으로 핵심 패키지는 이렇게 설치해요.

pip install openai azure-identity azure-ai-projects==1.0.0

자바스크립트 기준은 이렇게요.

npm install @azure/[email protected] @azure/identity

가상 환경에서 openai(OpenAI 호환 클라이언트), azure-identity(인증), azure-ai-projects(프로젝트용 통합 클라이언트)가 함께 쓰이는 구조예요.

Foundry SDK는 Foundry와 OpenAI가 API 형태가 다르기 때문에 클라이언트를 두 종류로 나눠 제공해요.

Project client: Foundry 고유 작업에 써요. 연결(connection) 목록 조회, 프로젝트 속성 읽기, 트레이싱 활성화 같은, OpenAI에 대응이 없는 작업이에요.
OpenAI 호환 클라이언트: Responses API, 에이전트(Agents), 평가(Evaluations), 파인튜닝(fine-tuning)은 OpenAI 스타일의 요청·응답 패턴을 쓰는데, 이 트래픽을 처리해요. Foundry에 직접 호스팅된 비 Azure OpenAI 모델도 이 클라이언트로 접근할 수 있어요.

대부분의 앱은 두 클라이언트를 함께 사용해요. 프로젝트 엔드포인트가 /openai 라우트로 OpenAI 호환 트래픽을 서빙하기 때문이에요.

모든 프로젝트 API는 단일 프로젝트 엔드포인트를 통해 노출돼요. 이 엔드포인트에 연결하면 모델, 도구, 프로젝트 설정을 한곳에서 접근할 수 있어서, 여러 라이브러리를 개별 설정 없이 묶을 수 있어요.