Microsoft Foundry SDK 및 엔드포인트

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

• 프로젝트 클라이언트 라이브러리 설치

  pip install azure-ai-projects azure-identity openai
  

  pip install --pre azure-ai-projects
  pip install azure-identity openai
  

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

  from azure.identity import DefaultAzureCredential
  from azure.ai.projects import AIProjectClient
  
  project = AIProjectClient(
    endpoint="your_project_endpoint",  # Replace with your endpoint
    credential=DefaultAzureCredential())
  # The AIProjectClient lets you access models, data, and services in your project.
  

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

• 설치에 다음 패키지를 추가합니다.

  • com.azure.ai.projects
  • com.azure.core

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

  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();
  // The ProjectsClient enables unified access to your project's resources.
  

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

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

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

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

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

  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());
  // The AIProjectClient lets you access models, data, and services in your project.
  

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

• 패키지를 설치합니다.

  dotnet add package Azure.Identity
  dotnet add package Azure.Core
  dotnet add package OpenAI
  

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

  using Azure.Identity;
  using Azure.Core;
  using Azure.Core.Pipeline;
  using Azure.AI.Projects;
  using System;
  
  string endpointUrl = "your_project_endpoint"; // Replace with your endpoint
  
  DefaultAzureCredential credential = new();
  BearerTokenPolicy tokenPolicy = new(credential, "https://cognitiveservices.azure.com/.default");
  
  AIProjectClientOptions clientOptions = new AIProjectClientOptions();
  // The PerRetry position ensures the authentication policy is applied to every retry attempt.
  // This is important for robust authentication in distributed/cloud environments.
  clientOptions.AddPolicy(tokenPolicy, HttpPipelinePosition.PerRetry);
  
  AIProjectClient projectClient = new(new Uri(endpointUrl), new DefaultAzureCredential(), clientOptions);
  // The AIProjectClient lets you access models, data, and services in your project.
  

// 
OpenAIClient openAIClient = projectClient.getOpenAIClient();

// Use the AIProjectClient to create an OpenAI client for your project
const openAIClient = await project.getOpenAIClient();

1. OpenAI 패키지를 설치합니다.

   dotnet add package OpenAI
   

2. 다음 코드 조각은 Azure OpenAI v1 엔드포인트를 사용하여 직접 OpenAI 클라이언트를 만드는 방법을 보여 줍니다.

   using Azure.Identity;
   using Azure.Core;
   using Azure.Core.Pipeline;   
   using OpenAI;
   using System;
   using System.ClientModel.Primitives;
   
   endpointUrl = "https://<YOUR-RESOURCE-NAME>.openai.azure.com/openai/v1/"
   
   DefaultAzureCredential credential = new();
   BearerTokenPolicy tokenPolicy = new(credential, "https://cognitiveservices.azure.com/.default");
   
   OpenAIClientOptions clientOptions = new()
   {
       Endpoint = new Uri(endpointUrl)
   };
   
   // The PerRetry position ensures the authentication policy is applied to every retry attempt.
   // This is important for robust authentication in distributed/cloud environments.
   clientOptions.AddPolicy(tokenPolicy, HttpPipelinePosition.PerRetry);
   
   var projectClient = new ResponseClient(
       endpointUrl, 
       credential,
       clientOptions
   );
   // The ResponseClient lets you interact with models and services in your project.
   

C# 지원 Foundry Tools

주조 도구	Description	빠른 시작 및 참조 설명서
음성	애플리케이션에 음성을 텍스트로, 텍스트 음성 변환, 번역 및 화자 인식 기능을 추가합니다.	• 음성 텍스트 변환 빠른 시작 • 텍스트 음성 변환 빠른 시작 • 음성 번역 빠른 시작 • .NET용 Speech SDK • Speech NuGet 패키지(Speech CLI)
콘텐츠 안전	애플리케이션 및 서비스에서 유해한 콘텐츠를 검색합니다.	• 텍스트 콘텐츠 분석 빠른 시작 • 텍스트 차단 목록 빠른 시작 사용 • 이미지 콘텐츠 분석 빠른 시작 • .NET용 콘텐츠 안전 SDK • 콘텐츠 안전 NuGet 패키지
비전	디지털 이미지 및 리치 미디어 자산의 콘텐츠를 분석합니다.	• Foundry Tools v3.2 GA 읽기의 Azure Vision 빠른 시작 • 이미지 분석 빠른 시작 • Face 서비스 빠른 시작 사용 • .NET용 Vision SDK • Vision NuGet 패키지
언어	자연어 이해 기능을 사용하여 애플리케이션을 빌드합니다.	• CQA(사용자 지정 질문 답변) 빠른 시작 • 엔티티 링크 빠르게 시작하기 • 언어 검색 빠른 시작 • 핵심 구 추출 빠른 시작 • 명명된 엔터티 검색(NER) 빠른 시작 • PII(개인 식별 정보) 검색 빠른 시작 • 감정 분석 및 의견 마이닝 빠른 시작 • 텍스트, 문서 및 대화 요약 빠른 시작 사용 • 상태를 위한 Text Analytics 사용 빠른 시작 • .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 기반 클라우드 검색을 모바일 및 웹앱으로 가져옵니다.	• 에이전틱 검색 빠른 시작 사용 • 벡터 검색 빠른 시작 • 기반을 두는 과정 데이터를 사용한 클래식 생성 검색(RAG) 빠른 시작 • 전체 텍스트 검색 빠른 시작 • 시맨틱 랭킹 빠른 시작 • 자신의 데이터를 사용하여 Azure OpenAI 모델과 빠른 채팅 시작하기 • .NET용 Azure AI Search SDK • Azure AI Search NuGet 패키지

자바 지원 파운드리 도구

주조 도구	Description	빠른 시작 및 참조 설명서
음성	애플리케이션에 음성을 텍스트로, 텍스트 음성 변환, 번역 및 화자 인식 기능을 추가합니다.	• 음성 텍스트 변환 빠른 시작 • 텍스트 음성 변환 빠른 시작 • 음성 번역 빠른 시작 • Java용 Speech SDK • Speech Maven 패키지
콘텐츠 안전	애플리케이션 및 서비스에서 유해한 콘텐츠를 검색합니다.	• 텍스트 콘텐츠 분석 빠른 시작 • 텍스트 차단 목록 빠른 시작 사용 • 이미지 콘텐츠 분석 빠른 시작 • Java용 콘텐츠 안전 SDK • 콘텐츠 안전 Maven 패키지
비전	디지털 이미지 및 리치 미디어 자산의 콘텐츠를 분석합니다.	• 이미지 분석 빠른 시작 • Face 서비스 빠른 시작 사용 • Java용 Vision SDK • Vision Maven 패키지
언어	자연어 이해 기능을 사용하여 애플리케이션을 빌드합니다.	• 엔티티 링크 빠르게 시작하기 • 언어 검색 빠른 시작 • 핵심 구 추출 빠른 시작 • 명명된 엔터티 검색(NER) 빠른 시작 • PII(개인 식별 정보) 검색 빠른 시작 • 감정 분석 및 의견 마이닝 빠른 시작 • 텍스트, 문서 및 대화 요약 빠른 시작 사용 • 상태를 위한 Text Analytics 사용 빠른 시작 • Java용 언어 SDK(텍스트 분석) • Language Maven 패키지
Translator	AI 기반 번역 기술을 사용하여 100개 이상의 사용 중인 위험에 처한 사라질 위기의 언어 및 방언을 번역합니다.	• Java용 Translator SDK(텍스트) • Translator Maven 패키지(텍스트)
문서 인텔리전스	문서를 지능형 데이터 기반 솔루션으로 전환합니다.	• 문서 인텔리전스 빠른 시작 • Java용 문서 인텔리전스 SDK • 문서 인텔리전스 Maven 패키지
Azure AI 검색	AI 기반 클라우드 검색을 모바일 및 웹앱으로 가져옵니다.	• 에이전틱 검색 빠른 시작 사용 • 벡터 검색 빠른 시작 • 기반을 두는 과정 데이터를 사용한 클래식 생성 검색(RAG) 빠른 시작 • 전체 텍스트 검색 빠른 시작 • 시맨틱 랭킹 빠른 시작 • 자신의 데이터를 사용하여 Azure OpenAI 모델과 빠른 채팅 시작하기 • Java용 Azure AI Search SDK • Azure AI Search Maven 패키지

JavaScript를 지원하는 주조 도구

주조 도구	Description	참조 설명서
음성	애플리케이션에 음성을 텍스트로, 텍스트 음성 변환, 번역 및 화자 인식 기능을 추가합니다.	• 음성 텍스트 변환 빠른 시작 • 텍스트 음성 변환 빠른 시작 • 음성 번역 빠른 시작 • JavaScript용 Speech SDK • Speech npm 패키지
콘텐츠 안전	애플리케이션 및 서비스에서 유해한 콘텐츠를 검색합니다.	• 텍스트 콘텐츠 분석 빠른 시작 • 텍스트 차단 목록 빠른 시작 사용 • 이미지 콘텐츠 분석 빠른 시작 • 콘텐츠 안전 npm 패키지
비전	디지털 이미지 및 리치 미디어 자산의 콘텐츠를 분석합니다.	• Foundry Tools v3.2 GA 읽기의 Azure Vision 빠른 시작 • 이미지 분석 빠른 시작 • Face 서비스 빠른 시작 사용 • JavaScript용 Vision SDK • 비전 npm 패키지
언어	자연어 이해 기능을 사용하여 애플리케이션을 빌드합니다.	• 엔티티 링크 빠르게 시작하기 • 언어 검색 빠른 시작 • 핵심 구 추출 빠른 시작 • 명명된 엔터티 검색(NER) 빠른 시작 • PII(개인 식별 정보) 검색 빠른 시작 • 감정 분석 및 의견 마이닝 빠른 시작 • 텍스트, 문서 및 대화 요약 빠른 시작 사용 • 상태를 위한 Text Analytics 사용 빠른 시작 • JavaScript용 언어 SDK(텍스트 분석) • 언어 npm 패키지
Translator	AI 기반 번역 기술을 사용하여 100개 이상의 사용 중인 위험에 처한 사라질 위기의 언어 및 방언을 번역합니다.	• JavaScript용 Translator SDK(텍스트) • Translator npm 패키지(텍스트)
문서 인텔리전스	문서를 지능형 데이터 기반 솔루션으로 전환합니다.	• 문서 인텔리전스 빠른 시작 • JavaScript용 문서 인텔리전스 SDK • 문서 인텔리전스 npm 패키지
Azure AI 검색	AI 기반 클라우드 검색을 모바일 및 웹앱으로 가져옵니다.	• 에이전틱 검색 빠른 시작 사용 • 벡터 검색 빠른 시작 • 기반을 두는 과정 데이터를 사용한 클래식 생성 검색(RAG) 빠른 시작 • 전체 텍스트 검색 빠른 시작 • 시맨틱 랭킹 빠른 시작 • 자신의 데이터를 사용하여 Azure OpenAI 모델과 빠른 채팅 시작하기 • JavaScript용 Azure AI Search SDK • Azure AI Search npm 패키지

파이썬 지원 파운드리 도구

주조 도구	Description	빠른 시작 및 참조 설명서
음성	애플리케이션에 음성을 텍스트로, 텍스트 음성 변환, 번역 및 화자 인식 기능을 추가합니다.	• 음성 텍스트 변환 빠른 시작 • 텍스트 음성 변환 빠른 시작 • 음성 번역 빠른 시작 • Python용 Speech SDK • Speech PyPi 패키지
콘텐츠 안전	애플리케이션 및 서비스에서 유해한 콘텐츠를 검색합니다.	• 텍스트 콘텐츠 분석 빠른 시작 • 텍스트 차단 목록 빠른 시작 사용 • 이미지 콘텐츠 분석 빠른 시작 • Python용 콘텐츠 안전 SDK • 콘텐츠 안전 PyPi 패키지
비전	디지털 이미지 및 리치 미디어 자산의 콘텐츠를 분석합니다.	• Foundry Tools v3.2 GA 읽기의 Azure Vision 빠른 시작 • 이미지 분석 빠른 시작 • Face 서비스 빠른 시작 사용 • Python용 Vision SDK • Vision PyPi 패키지
언어	자연어 이해 기능을 사용하여 애플리케이션을 빌드합니다.	• CQA(사용자 지정 질문 답변) 빠른 시작 • 엔티티 링크 빠르게 시작하기 • 언어 검색 빠른 시작 • 핵심 구 추출 빠른 시작 • 명명된 엔터티 검색(NER) 빠른 시작 • PII(개인 식별 정보) 검색 빠른 시작 • 감정 분석 및 의견 마이닝 빠른 시작 • 텍스트, 문서 및 대화 요약 빠른 시작 사용 • 상태를 위한 Text Analytics 사용 빠른 시작 • 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 기반 클라우드 검색을 모바일 및 웹앱으로 가져옵니다.	• 검색 서비스 빠른 시작에 연결 • 에이전틱 검색 빠른 시작 사용 • 벡터 검색 빠른 시작 • 기반을 두는 과정 데이터를 사용한 클래식 생성 검색(RAG) 빠른 시작 • 전체 텍스트 검색 빠른 시작 • 시맨틱 랭킹 빠른 시작 • 자신의 데이터를 사용하여 Azure OpenAI 모델과 빠른 채팅 시작하기 • Python용 Azure AI Search SDK • Azure AI Search PyPi 패키지