Azure OpenAI 프로바이더

Azure OpenAI 프로바이더

Azure OpenAI 프로바이더는 @ai-sdk/azure 모듈로 제공되며 Azure OpenAI 채팅 API 언어 모델을 지원합니다. 리소스 이름(resourceName) 기반과 완전한 Microsoft Foundry base URL 기반 두 방식으로 설정할 수 있고, API 키 또는 Microsoft Entra ID 토큰 인증을 지원합니다.

출처: 공식문서

본문

설치

pnpm add @ai-sdk/azure

프로바이더 인스턴스

기본 인스턴스:

import { azure } from '@ai-sdk/azure';

리소스 이름 기반 커스텀 인스턴스:

import { createAzure } from '@ai-sdk/azure';

const azure = createAzure({
  resourceName: 'your-resource-name', // Azure resource name
  apiKey: process.env.AZURE_API_KEY,
});

완전한 Microsoft Foundry OpenAI v1 base URL 사용:

const azure = createAzure({
  baseURL: 'https://your-resource.services.ai.azure.com/openai/v1',
  apiKey: process.env.AZURE_API_KEY,
});

Microsoft Entra ID 인증(토큰 프로바이더). @azure/identity의 credential 헬퍼 사용:

import { createAzure } from '@ai-sdk/azure';
import {
  DefaultAzureCredential,
  getBearerTokenProvider,
} from '@azure/identity';

const credential = new DefaultAzureCredential();
const scope = 'https://cognitiveservices.azure.com/.default';
const tokenProvider = getBearerTokenProvider(credential, scope);

const azure = createAzure({
  resourceName: 'your-resource-name',
  tokenProvider,
});

인스턴스 커스터마이징 옵션:

  • resourceName — Azure 리소스 이름. 기본값 AZURE_RESOURCE_NAME 환경변수. 조합 URL: https://{resourceName}.openai.azure.com/openai/v1{path}. URL 프리픽스를 직접 지정하려면 baseURL을 사용.
  • apiKey — api-key 헤더로 전송. 기본값 AZURE_API_KEY 환경변수.
  • tokenProvider — Authorization 헤더로 전송할 액세스 토큰을 반환하는 함수. 제공되면 apiKey 대신 사용.
  • apiVersion — 커스텀 API 버전(기본 v1). 프로바이더가 v1 경로를 구성하거나 deployment 기반 URL을 쓸 때 적용. 완전한 v1 base URL은 그대로 사용.

언어 모델

프로바이더 인스턴스로 언어 모델을 만들고 generateText·streamText에서 사용합니다. Azure 모델은 AI SDK Core의 Output으로 구조화 데이터 생성도 지원합니다.

더 알아보기