Azure AI Foundry SDK 클라이언트 라이브러리

2025-07-01

Azure AI Foundry SDK는 Azure에서 AI 애플리케이션 개발을 간소화하도록 설계된 포괄적인 도구 체인입니다. 개발자는 다음을 수행할 수 있습니다.

단일 인터페이스를 통해 다양한 모델 공급자에서 인기 있는 모델에 액세스
모델, 데이터 및 AI 서비스를 쉽게 결합하여 AI 기반 애플리케이션을 빌드합니다.
개발, 테스트 및 프로덕션 환경에서 애플리케이션 품질 및 안전성 평가, 디버그 및 개선

Azure AI Foundry SDK는 함께 작동하도록 설계된 클라이언트 라이브러리 및 서비스 집합입니다.

비고

이 문서는 Foundry 프로젝트에 적용됩니다. 여기에 표시된 코드는 허브 기반 프로젝트에서 작동하지 않습니다. 자세한 내용은 프로젝트 유형을 참조하세요.

필수 조건

Azure 구독. 계정이 없는 경우 체험 계정을 만듭니다.
Foundry 프로젝트가 아직 없는 경우 만듭니다.
프로젝트의 개요 섹션에서 Azure AI Foundry 프로젝트 엔드포인트를 복사합니다. 잠시 후에 당신이 사용할 거예요.

팁 (조언)

Azure AI Foundry 프로젝트 엔드포인트가 표시되지 않으면 허브 기반 프로젝트를 사용하는 것입니다. ( 프로젝트 유형 참조). Foundry 프로젝트로 전환하거나 이전 단계를 사용하여 프로젝트를 만듭니다.
프로젝트에 액세스하는 데 사용하는 것과 동일한 계정을 사용하여 Azure CLI로 로그인합니다.
```
az login
```

Unified Projects 클라이언트 라이브러리

Azure AI Foundry Projects 클라이언트 라이브러리는 단일 프로젝트 엔드포인트에 연결하여 여러 클라이언트 라이브러리를 함께 사용할 수 있는 통합 라이브러리입니다.

프로젝트 클라이언트 라이브러리 설치
```
pip install azure-ai-projects azure-identity
```

코드에서 프로젝트 클라이언트를 만듭니다. 프로젝트의 개요 페이지에서 Azure AI Foundry 프로젝트 엔드포인트를 복사하고 연결 문자열 값을 업데이트합니다.

from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient

project = AIProjectClient(
  endpoint="your_project_endpoint",  # Replace with your endpoint
  credential=DefaultAzureCredential())

중요합니다

이 문서에 표시된 항목(미리 보기)은 현재 퍼블릭 미리 보기에서 확인할 수 있습니다. 이 미리 보기는 서비스 수준 계약 없이 제공되며, 프로덕션 워크로드에는 권장되지 않습니다. 특정 기능이 지원되지 않거나 기능이 제한될 수 있습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.

설치(미리 보기)에 다음 패키지를 추가합니다.
- com.azure.ai.projects
- com.azure.core

import com.azure.ai.projects.ProjectsClient;
import com.azure.ai.projects.ProjectsClientBuilder;
import com.azure.core.credential.AzureKeyCredential;

String endpoint ="your_project_endpoint"; // Replace with your endpoint

ProjectsClient projectClient = new ProjectsClientBuilder()
    .credential(new DefaultAzureCredential())
    .endpoint(endpoint)
    .buildClient();

중요합니다

종속성 설치(미리 보기):

npm install @azure/ai-projects @azure/identity

import { AIProjectClient } from '@azure/ai-projects';
import { DefaultAzureCredential } from '@azure/identity';

const endpoint = "your_project_endpoint"; // Replace with your actual endpoint
const project = new AIProjectClient(endpoint, new DefaultAzureCredential());

패키지를 설치합니다.

dotnet add package Azure.Identity
dotnet add package Azure.Core
dotnet add package Azure.AI.Inference

using Azure;
using Azure.Identity;
using Azure.AI.Inference;
using Azure.Core;
using Azure.Core.Pipeline;

var endpointUrl = "your_project_endpoint"; // Replace with your actual endpoint
var credential = new DefaultAzureCredential();

AzureAIInferenceClientOptions clientOptions = new AzureAIInferenceClientOptions();
BearerTokenAuthenticationPolicy tokenPolicy = new BearerTokenAuthenticationPolicy(
    credential, 
    new string[] { "https://cognitiveservices.azure.com/.default" }
);
clientOptions.AddPolicy(tokenPolicy, HttpPipelinePosition.PerRetry);

var projectClient = new ChatCompletionsClient(
    endpointUrl, 
    credential,
    clientOptions
);

프로젝트 엔드포인트를 사용하여 다음을 수행할 수 있습니다.
- Azure OpenAI를 비롯한 Foundry 모델 사용
- Foundry 에이전트 서비스 사용
- 클라우드에서 평가 실행
- 앱의 추적 기능 활성화
- 외부 리소스 연결에 대한 엔드포인트 및 키 검색

Azure AI Services 클라이언트 라이브러리

Azure AI 서비스를 사용하려면 프로젝트 홈페이지에 나열된 엔드포인트와 함께 다음 클라이언트 라이브러리를 사용할 수 있습니다.

C# 지원 서비스

서비스	설명	참조 설명서
음성	애플리케이션에 음성을 텍스트로, 텍스트 음성 변환, 번역 및 화자 인식 기능을 추가합니다.	• .NET용 Speech SDK • Speech NuGet 패키지(Speech CLI)
콘텐츠 안전	애플리케이션 및 서비스에서 유해한 콘텐츠를 검색합니다.	• .NET용 콘텐츠 안전 SDK • 콘텐츠 안전 NuGet 패키지
비전	디지털 이미지 및 리치 미디어 자산의 콘텐츠를 분석합니다.	• .NET용 Vision SDK • Vision NuGet 패키지
언어	자연어 이해 기능을 사용하여 애플리케이션을 빌드합니다.	• .NET용 언어 SDK(텍스트 분석) • Language NuGet 패키지(텍스트 분석) • .NET용 언어 SDK(질문 답변) • Language NuGet 패키지(질문 답변)
Translator	AI 기반 번역 기술을 사용하여 100개 이상의 사용 중인 위험에 처한 사라질 위기의 언어 및 방언을 번역합니다.	• Translator SDK for .NET(text) • Translator NuGet 패키지(텍스트) • Translator SDK for .NET(batch) • Translator NuGet 패키지(일괄 처리)
문서 인텔리전스	문서를 지능형 데이터 기반 솔루션으로 전환합니다.	• .NET용 문서 인텔리전스 SDK • 문서 인텔리전스 NuGet 패키지
Azure AI 검색	AI 기반 클라우드 검색을 모바일 및 웹앱으로 가져옵니다.	• .NET용 Azure AI Search SDK • Azure AI Search NuGet 패키지

Java 지원 서비스

서비스	설명	참조 설명서
음성	애플리케이션에 음성을 텍스트로, 텍스트 음성 변환, 번역 및 화자 인식 기능을 추가합니다.	• Java용 Speech SDK • Speech Maven 패키지
콘텐츠 안전	애플리케이션 및 서비스에서 유해한 콘텐츠를 검색합니다.	• Java용 콘텐츠 안전 SDK • 콘텐츠 안전 Maven 패키지
[비전]../../../ai-services/computer-vision/index.yml)	디지털 이미지 및 리치 미디어 자산의 콘텐츠를 분석합니다.	• Java용 Vision SDK • Vision Maven 패키지
언어	자연어 이해 기능을 사용하여 애플리케이션을 빌드합니다.	• Java용 언어 SDK(텍스트 분석) • Language Maven 패키지
Translator	AI 기반 번역 기술을 사용하여 100개 이상의 사용 중인 위험에 처한 사라질 위기의 언어 및 방언을 번역합니다.	• Java용 Translator SDK(텍스트) • Translator Maven 패키지(텍스트)
문서 인텔리전스	문서를 지능형 데이터 기반 솔루션으로 전환합니다.	• Java용 문서 인텔리전스 SDK • 문서 인텔리전스 Maven 패키지
Azure AI 검색	AI 기반 클라우드 검색을 모바일 및 웹앱으로 가져옵니다.	• Java용 Azure AI Search SDK • Azure AI Search Maven 패키지

JavaScript 지원 서비스

서비스	설명	참조 설명서
음성	애플리케이션에 음성을 텍스트로, 텍스트 음성 변환, 번역 및 화자 인식 기능을 추가합니다.	• JavaScript용 Speech SDK • Speech npm 패키지
콘텐츠 안전	애플리케이션 및 서비스에서 유해한 콘텐츠를 검색합니다.	• JavaScript용 콘텐츠 안전 SDK • 콘텐츠 안전 npm 패키지
비전	디지털 이미지 및 리치 미디어 자산의 콘텐츠를 분석합니다.	• JavaScript용 Vision SDK • 비전 npm 패키지
언어	자연어 이해 기능을 사용하여 애플리케이션을 빌드합니다.	• JavaScript용 언어 SDK(텍스트 분석) • 언어 npm 패키지
Translator	AI 기반 번역 기술을 사용하여 100개 이상의 사용 중인 위험에 처한 사라질 위기의 언어 및 방언을 번역합니다.	• JavaScript용 Translator SDK(텍스트) • Translator npm 패키지(텍스트)
문서 인텔리전스	문서를 지능형 데이터 기반 솔루션으로 전환합니다.	• JavaScript용 문서 인텔리전스 SDK • 문서 인텔리전스 npm 패키지
Azure AI 검색	AI 기반 클라우드 검색을 모바일 및 웹앱으로 가져옵니다.	• JavaScript용 Azure AI Search SDK • Azure AI Search npm 패키지

Python 지원 서비스

서비스	설명	참조 설명서
음성	애플리케이션에 음성을 텍스트로, 텍스트 음성 변환, 번역 및 화자 인식 기능을 추가합니다.	• Python용 Speech SDK • Speech PyPi 패키지
콘텐츠 안전	애플리케이션 및 서비스에서 유해한 콘텐츠를 검색합니다.	• Python용 콘텐츠 안전 SDK • 콘텐츠 안전 PyPi 패키지
비전	디지털 이미지 및 리치 미디어 자산의 콘텐츠를 분석합니다.	• Python용 Vision SDK • Vision PyPi 패키지
언어	자연어 이해 기능을 사용하여 애플리케이션을 빌드합니다.	• Python용 언어 SDK(텍스트 분석) • 언어 PyPi 패키지(텍스트 분석) • Python용 언어 SDK(질문 답변) • 언어 PyPi 패키지(질문 답변) • Python용 언어 SDK(언어 대화) • 언어 PyPi 패키지(언어 대화)
Translator	AI 기반 번역 기술을 사용하여 100개 이상의 사용 중인 위험에 처한 사라질 위기의 언어 및 방언을 번역합니다.	• Python용 Translator SDK(텍스트) • Translator PyPi 패키지(텍스트) • Python용 Translator SDK(일괄 처리) • Translator PyPi 패키지(일괄 처리)
문서 인텔리전스	문서를 지능형 데이터 기반 솔루션으로 전환합니다.	• Python용 문서 인텔리전스 SDK • 문서 인텔리전스 PyPi 패키지
Azure AI 검색	AI 기반 클라우드 검색을 모바일 및 웹앱으로 가져옵니다.	• Python용 Azure AI Search SDK • Azure AI Search PyPi 패키지