Microsoft Foundry 軟體開發工具包與端點

Azure AI Projects Python 用戶端函式庫是一個統一函式庫，允許你透過連接單一專案端點，同時使用多個用戶端函式庫。

pip install azure-ai-projects azure-identity openai

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

Azure AI Projects 的 Java 用戶端函式庫（預覽版）是一個統一函式庫，允許你透過連接單一專案端點來同時使用多個用戶端函式庫。

將這些套件新增至您的安裝：

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

Azure AI 專案的 JavaScript 用戶端函式庫是一個統一函式庫，允許你透過連接單一專案端點來同時使用多個用戶端函式庫。

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

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

Azure AI Projects 的 .NET 用戶端函式庫是一個統一函式庫，允許你透過連接單一專案端點，同時使用多個用戶端函式庫。

執行這個指令，將 Azure.AI.Projects 套件加入你的 .NET 專案。

dotnet add package Azure.AI.Projects --version 1.2

建立專案客戶：

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

project = AIProjectClient(
  endpoint="https://<resource-name>.services.ai.azure.com/api/projects/<project-name>",
  credential=DefaultAzureCredential())

從你的專案建立一個 OpenAI 相容的客戶端：

openai_client = project.inference.get_azure_openai_client(api_version="2024-10-21")
response = openai_client.responses.create(
    model="gpt-5.2",
    input="What is the speed of light?",
)
print(response.output_text)

建立專案客戶：

import com.azure.ai.projects.ProjectsClient;
import com.azure.ai.projects.ProjectsClientBuilder;
import com.azure.identity.DefaultAzureCredentialBuilder;

String endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";

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

從你的專案建立一個 OpenAI 相容的客戶端：

OpenAIClient openAIClient = projectClient.getOpenAIClient();

建立專案客戶：

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

const endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const project = new AIProjectClient(endpoint, new DefaultAzureCredential());

從你的專案建立一個 OpenAI 相容的客戶端：

const openAIClient = await project.getOpenAIClient();

建立專案客戶：

using Azure.AI.Projects.OpenAI; 
using Azure.Identity;
using OpenAI.Responses;

string endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";

AIProjectClient projectClient = new(
    endpoint: new Uri(endpoint), 
    tokenProvider: new DefaultAzureCredential());

從你的專案建立一個 OpenAI 相容的客戶端：

#pragma warning disable OPENAI001
OpenAIResponseClient responseClient = projectClient.OpenAI.GetProjectResponsesClientForModel("gpt-5.2");
OpenAIResponse response = responseClient.CreateResponse("What is the speed of light?");
Console.WriteLine(response.GetOutputText());
#pragma warning restore OPENAI001

這個片段從ProjectsClient中取得OpenAIClient，讓你可以透過 Foundry 發送 OpenAI 請求。

OpenAIClient openAIClient = projectClient.getOpenAIClient();

這段摘要是利用專案客戶端建立一個 OpenAI 客戶端，你可以在多個請求間重複使用。

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

1. 安裝 OpenAI 套件：

   執行這個指令，將 OpenAI 客戶端函式庫加入你的 .NET 專案。

   dotnet add package OpenAI
   

當它成功時，.NET CLI 會確認已安裝該 OpenAI 套件。

1. 以下程式碼片段示範如何直接使用 Azure OpenAI v1 端點建立 OpenAI 用戶端。

   此片段用於配置 DefaultAzureCredential，建置 OpenAIClientOptions，並為 Azure OpenAI v1 端點創建 ResponseClient。

   using Azure.Identity;
   using Azure.Core;
   using OpenAI;
   using System;
   using System.ClientModel.Primitives;
   
   #pragma warning disable OPENAI001
   
   const string directModelEndpoint  = "https://<resource-name>.openai.azure.com/openai/v1/";
   const string deploymentName = "gpt-5.2";    
   
   BearerTokenPolicy tokenPolicy = new(
       new DefaultAzureCredential(),
       "https://cognitiveservices.azure.com/.default");
   
   OpenAIResponseClient client = new(
       model: deploymentName,
       authenticationPolicy: tokenPolicy, // To use Entra 
    // credential: new ApiKeyCredential("<YOUR-AZURE-OPENAI-API-KEY>") // To use APIKEY 
       options: new OpenAIClientOptions()
       {
           Endpoint = new($"{directModelEndpoint}"),
       });
   ResponseCreationOptions options = new ResponseCreationOptions
   {
       Temperature = (float)0.7,
   };
   
   OpenAIResponse modelDirectResponse = client.CreateResponse(
        [
           ResponseItem.CreateUserMessageItem("What is the size of France in square miles?"),
        ], options);
   
   Console.WriteLine($"[ASSISTANT]: {modelDirectResponse.GetOutputText()}");
   #pragma warning restore OPENAI001
   // The ResponseClient lets you interact with models and services in your project.
   

支援 C# 的 Foundry 工具

鑄造工具	Description	快速入門與參考文件
語音	將語音轉換為文字、語音合成、翻譯和說話者辨識功能新增至應用程式功能。	• 語音轉文字快速啟動 • 文字轉語音快速啟動 • 語音翻譯快速啟動 • 適用於 .NET 的語音 SDK • 語音 NuGet 套件 (語音 CLI)
語言	使用自然語言理解功能建置應用程式。	• 自訂問答（CQA）快速啟動 • 實體連結快速入門 • 語言偵測快速啟動 • 關鍵詞組擷取快速啟動 • 偵測命名實體（NER）快速入門 • 偵測個人識別資訊 (PII) 快速入門 (部分機器翻譯) • 情緒分析與意見挖掘快速啟動 • 使用文字、文件與對話摘要快速啟動 • 為健康情況使用文字分析快速入門 • 適用於 .NET 的語言 SDK（文字分析） • 語言 NuGet 套件 （文字分析） • 適用於 .NET 的語言 SDK（問題解答） • 語言 NuGet 套件 （問題解答）
翻譯工具	使用 AI 支援的翻譯技術來翻譯超過 100 種使用中、高風險和瀕危的語言和方言。	• 適用於 .NET 的翻譯工具 SDK （文字） • 翻譯工具 NuGet 套件 （文字） • 適用於 .NET 的翻譯工具 SDK (批次) • 翻譯工具 NuGet 套件 （批次）
Azure AI 搜尋服務	將 AI 支援的雲端搜尋引進行動應用程式和 Web 應用程式中。	• 使用 Agent 擷取快速入門 (部分機器翻譯) • 向量搜尋快速啟動 • 經典生成式搜尋（RAG）使用基礎數據快速入門 • 全文搜尋快速啟動 • 語意排名快速入門 • 使用您自己的資料與 Azure OpenAI 模型聊天快速入門 • 適用於 .NET 的 Azure AI 搜尋 SDK • Azure AI 搜尋 NuGet 套件
內容安全性	偵測應用程式和服務中的有害內容。	• 分析文字內容快速入門 • 使用文字封鎖清單快速入門 • 分析影像內容快速入門 • 適用於 .NET 的內容安全 SDK • 內容安全性 NuGet 套件
文件智慧服務	將檔案轉換成智慧型資料驅動解決方案。	• 文件智能快速入門 • 適用於 .NET 的文件智慧 SDK • 檔案智慧 NuGet 套件
視覺	分析數位影像和多媒體資產中的內容。	• Foundry Tools 中的 Azure Vision v3.2 GA 讀取快速入門 • 影像分析快速入門 • 使用臉部服務快速啟動 • 適用於 .NET 的視覺 SDK • 視覺 NuGet 套件

Java 支援的鑄造工具

鑄造工具	Description	快速入門與參考文件
語音	將語音轉換為文字、語音合成、翻譯和說話者辨識功能新增至應用程式功能。	• 語音轉文字快速啟動 • 文字轉語音快速啟動 • 語音翻譯快速啟動 • 適用於 Java 的語音 SDK • Speech Maven 套件
語言	使用自然語言理解功能建置應用程式。	• 實體連結快速入門 • 語言偵測快速啟動 • 關鍵詞組擷取快速啟動 • 偵測命名實體（NER）快速入門 • 偵測個人識別資訊 (PII) 快速入門 (部分機器翻譯) • 情緒分析與意見挖掘快速啟動 • 使用文字、文件與對話摘要快速啟動 • 為健康情況使用文字分析快速入門 • 適用於 Java 的語言 SDK（文字分析） • 語言 Maven 套件
翻譯工具	使用 AI 支援的翻譯技術來翻譯超過 100 種使用中、高風險和瀕危的語言和方言。	• 適用於 Java 的翻譯工具 SDK（文字） • 翻譯工具 Maven 套件 （文字）
Azure AI 搜尋服務	將 AI 支援的雲端搜尋引進行動應用程式和 Web 應用程式中。	• 使用 Agent 擷取快速入門 (部分機器翻譯) • 向量搜尋快速啟動 • 經典生成式搜尋（RAG）使用基礎數據快速入門 • 全文搜尋快速啟動 • 語意排名快速入門 • 使用您自己的資料與 Azure OpenAI 模型聊天快速入門 • 適用於 Java 的 Azure AI 搜尋 SDK • Azure AI 搜尋服務 Maven 套件
內容安全性	偵測應用程式和服務中的有害內容。	• 分析文字內容快速入門 • 使用文字封鎖清單快速入門 • 分析影像內容快速入門 • 適用於 Java 的內容安全 SDK • 內容安全 Maven 套件
文件智慧服務	將檔案轉換成智慧型資料驅動解決方案。	• 文件智能快速入門 • 適用於 Java 的文件智慧 SDK • 文件智慧服務 Maven 套件
視覺	分析數位影像和多媒體資產中的內容。	• 影像分析快速入門 • 使用臉部服務快速啟動 • 適用於 Java 的視覺 SDK • 視覺 Maven 套件

支援 JavaScript 的 Foundry 工具

鑄造工具	Description	參考文件
語音	將語音轉換為文字、語音合成、翻譯和說話者辨識功能新增至應用程式功能。	• 語音轉文字快速啟動 • 文字轉語音快速啟動 • 語音翻譯快速啟動 • 適用於 JavaScript 的語音 SDK • 語音 npm 套件
語言	使用自然語言理解功能建置應用程式。	• 實體連結快速入門 • 語言偵測快速啟動 • 關鍵詞組擷取快速啟動 • 偵測命名實體（NER）快速入門 • 偵測個人識別資訊 (PII) 快速入門 (部分機器翻譯) • 情緒分析與意見挖掘快速啟動 • 使用文字、文件與對話摘要快速啟動 • 為健康情況使用文字分析快速入門 • 適用於 JavaScript 的語言 SDK（文字分析） • 語言 npm 套件
翻譯工具	使用 AI 支援的翻譯技術來翻譯超過 100 種使用中、高風險和瀕危的語言和方言。	• 適用於 JavaScript 的翻譯工具 SDK（文字） • 翻譯工具 npm 套件 （text）
Azure AI 搜尋服務	將 AI 支援的雲端搜尋引進行動應用程式和 Web 應用程式中。	• 使用 Agent 擷取快速入門 (部分機器翻譯) • 向量搜尋快速啟動 • 經典生成式搜尋（RAG）使用基礎數據快速入門 • 全文搜尋快速啟動 • 語意排名快速入門 • 使用您自己的資料與 Azure OpenAI 模型聊天快速入門 • 適用於 JavaScript 的 Azure AI 搜尋 SDK • Azure AI 搜尋服務 npm 套件
內容安全性	偵測應用程式和服務中的有害內容。	• 分析文字內容快速入門 • 使用文字封鎖清單快速入門 • 分析影像內容快速入門 • 內容安全性 npm 套件
文件智慧服務	將檔案轉換成智慧型資料驅動解決方案。	• 文件智能快速入門 • 適用於 JavaScript 的文件智慧 SDK • 文件智能 npm 套件
視覺	分析數位影像和多媒體資產中的內容。	• Foundry Tools 中的 Azure Vision v3.2 GA 讀取快速入門 • 影像分析快速入門 • 使用臉部服務快速啟動 • 適用於 JavaScript 的視覺 SDK • 視覺 npm 套件

Python 支援的 Foundry Tools

鑄造工具	Description	快速入門與參考文件
語音	將語音轉換為文字、語音合成、翻譯和說話者辨識功能新增至應用程式功能。	• 語音轉文字快速啟動 • 文字轉語音快速啟動 • 語音翻譯快速啟動 • 適用於 Python 的語音 SDK • 語音 PyPi 套件
語言	使用自然語言理解功能建置應用程式。	• 自訂問答（CQA）快速啟動 • 實體連結快速入門 • 語言偵測快速啟動 • 關鍵詞組擷取快速啟動 • 識別命名實體（NER）快速入門 • 偵測個人識別資訊 (PII) 快速入門 (部分機器翻譯) • 情緒分析與意見挖掘快速啟動 • 使用文字、文件與對話摘要快速啟動 • 為健康情況使用文字分析快速入門 • 適用於 Python 的語言 SDK（文字分析） • 語言 PyPi 套件 （文字分析） • 適用於 Python 的語言 SDK（問題解答） • 語言 PyPi 套件 （問題解答） • 適用於 Python 的語言 SDK（語言對話） • 語言 PyPi 套件 (語言交談)
翻譯工具	使用 AI 支援的翻譯技術來翻譯超過 100 種使用中、高風險和瀕危的語言和方言。	• 適用於 Python 的翻譯工具 SDK（文字） • 翻譯工具 PyPi 套件 （文字） • 適用於 Python 的翻譯 SDK（批次版） • 翻譯工具 PyPi 套件 （批次）
Azure AI 搜尋服務	將 AI 支援的雲端搜尋引進行動應用程式和 Web 應用程式中。	• 連線到搜尋服務快速入門 • 使用 Agent 擷取快速入門 (部分機器翻譯) • 向量搜尋快速啟動 • 經典生成式搜尋（RAG）使用基礎數據快速入門 • 全文搜尋快速啟動 • 語意排名快速入門 • 使用您自己的資料與 Azure OpenAI 模型聊天快速入門 • 適用於 Python 的 Azure AI 搜尋 SDK • Azure AI 搜尋 PyPi 套件
內容安全性	偵測應用程式和服務中的有害內容。	• 分析文字內容快速入門 • 使用文字封鎖清單快速入門 • 分析影像內容快速入門 • 適用於 Python 的內容安全 SDK • 內容安全性 PyPi 套件
文件智慧服務	將檔案轉換成智慧型資料驅動解決方案。	• 文件智能快速入門 • 適用於 Python 的文件智慧 SDK • 檔案智慧 PyPi 套件
視覺	分析數位影像和多媒體資產中的內容。	• Foundry Tools 中的 Azure Vision v3.2 GA 讀取快速入門 • 影像分析快速入門 • 使用臉部服務快速啟動 • 適用於 Python 的視覺 SDK • Vision PyPi 套件