共用方式為

Azure AI Foundry SDK 用戶端程式庫

Azure AI Foundry SDK 是一個全方位的工具鏈，旨在簡化 Azure 上的 AI 應用程式開發。 它可讓開發人員：

  • 透過單一介面從各種模型提供者存取熱門模型
  • 輕鬆地將模型、數據和 AI 服務結合在一起，以建置 AI 支援的應用程式
  • 跨開發、測試和生產環境評估、偵錯及改善應用程式品質與安全性

Azure AI Foundry SDK 是一組專為共同運作而設計的用戶端連結庫和服務。

備註

本文適用於 Foundry 專案。 此處顯示的程式代碼不適用於 中樞型專案。 如需詳細資訊，請參閱 項目類型。

先決條件

  • Azure 訂用帳戶。 如果您沒有帳戶，請建立 免費帳戶。

  • 如果您還沒有 Foundry 專案，請建立專案。

  • 在專案的 [概觀] 區段中複製 Azure AI Foundry 專案端點。 您將很快使用它。

    此螢幕快照顯示 Foundry 專案的專案概觀。

    小提示

    如果您沒有看到 Azure AI Foundry 專案端點，則會使用中樞型專案。 （請參閱 項目類型）。 切換至 Foundry 專案，或使用上述步驟建立一個專案。

  • 使用您用來存取專案的相同帳戶來登入 Azure CLI：

    az login

統一專案客戶端程式庫

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 預覽版增補使用條款。

  • 將這些套件新增至您的安裝（預覽）：

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

  • 在程式代碼中建立專案用戶端。 從 專案的 [概觀] 頁面複製 Azure AI 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();

這很重要

本文中標示為 (預覽) 的項目目前處於公開預覽狀態。 此預覽版本沒有服務等級協定，不建議將其用於生產工作負載。 可能不支援特定功能，或可能已經限制功能。 如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

  • 安裝相依性 （預覽）：

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

  • 在程式代碼中建立專案用戶端。 從 專案的 [概觀] 頁面複製 Azure AI 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());

  • 安裝套件：

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

  • 在程式代碼中建立專案用戶端。 從 專案的 [概觀] 頁面複製 Azure AI Foundry 專案端點，並更新連接字串值。

    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 AI Services 用戶端連結庫

若要使用 Azure AI 服務，您可以使用下列用戶端連結庫搭配專案首頁上所列的端點。

C# 支援的服務

服務 說明 參考文件
語音圖示 語音 將語音轉換為文字、語音合成、翻譯和說話者辨識功能新增至應用程式功能。 • 適用於 .NET 的語音 SDK

• 語音 NuGet 套件（語音 CLI）
內容安全性圖示 內容安全性 偵測應用程式和服務中的有害內容。 • 適用於 .NET 的內容安全 SDK

• 內容安全性 NuGet 套件
視覺圖示 視覺 分析數位影像和多媒體資產中的內容。 • 適用於 .NET 的視覺 SDK

• 視覺 NuGet 封裝套件
語言圖示 語言 使用自然語言理解功能建置應用程式。 • 適用於 .NET 的語言 SDK（文字分析）

• 語言 NuGet 套件 （文字分析）

• 適用於 .NET 的語言 SDK（問題解答）

• 語言 NuGet 套件 （問題解答）
翻譯工具圖示 翻譯工具 使用 AI 支援的翻譯技術來翻譯超過 100 種使用中、高風險和瀕危的語言和方言。 • 適用於 .NET 的翻譯工具 SDK （文字）

• 翻譯工具 NuGet 套件 （文字）

• 適用於 .NET 的翻譯工具 SDK（批次）

• 翻譯工具 NuGet 套件 （批次）
文件智慧圖示 文件智慧服務 將檔案轉換成智慧型資料驅動解決方案。 • 適用於 .NET 的文件智慧 SDK

• 檔案智慧 NuGet 套件
Azure AI 搜尋圖示 Azure AI 搜尋服務 將 AI 支援的雲端搜尋引進行動應用程式和 Web 應用程式中。 • 適用於 .NET 的 Azure AI 搜尋 SDK

• Azure AI 搜尋 NuGet 套件

Java 支援的服務

服務 說明 參考文件
語音圖示 語音 將語音轉換為文字、語音合成、翻譯和說話者辨識功能新增至應用程式功能。 • 適用於 Java 的語音 SDK

• Speech Maven 套件
內容安全性圖示 內容安全性 偵測應用程式和服務中的有害內容。 • 適用於 Java 的內容安全 SDK

• 內容安全 Maven 套件
視覺圖示 [Vision]../../../ai-services/computer-vision/index.yml） 分析數位影像和多媒體資產中的內容。 • 適用於 Java 的視覺 SDK

• 視覺 Maven 套件
語言圖示 語言 使用自然語言理解功能建置應用程式。 • 適用於 Java 的語言 SDK（文字分析）

• 語言 Maven 套件
翻譯工具圖示 翻譯工具 使用 AI 支援的翻譯技術來翻譯超過 100 種使用中、高風險和瀕危的語言和方言。 • 適用於 Java 的翻譯工具 SDK（文字）

• 翻譯工具 Maven 套件 （文字）
文件智慧圖示 文件智慧服務 將檔案轉換成智慧型資料驅動解決方案。 • 適用於 Java 的文件智慧 SDK

• 智慧文件 Maven 套件
Azure AI 搜尋圖示 Azure AI 搜尋服務 將 AI 支援的雲端搜尋引進行動應用程式和 Web 應用程式中。 • 適用於 Java 的 Azure AI 搜尋 SDK

• Azure AI 搜尋 Maven 套件

JavaScript 支援服務

服務 說明 參考文件
語音圖示 語音 將語音轉換為文字、語音合成、翻譯和說話者辨識功能新增至應用程式功能。 • 適用於 JavaScript 的語音 SDK

• 語音 npm 套件
內容安全性圖示 內容安全性 偵測應用程式和服務中的有害內容。 • 適用於 JavaScript 的內容安全 SDK

• 內容安全性 npm 套件
視覺圖示 視覺 分析數位影像和多媒體資產中的內容。 • 適用於 JavaScript 的視覺 SDK

• 視覺 npm 套件
語言圖示 語言 使用自然語言理解功能建置應用程式。 • 適用於 JavaScript 的語言 SDK（文字分析）

• 語言 npm 套件
翻譯工具圖示 翻譯工具 使用 AI 支援的翻譯技術來翻譯超過 100 種使用中、高風險和瀕危的語言和方言。 • 適用於 JavaScript 的翻譯工具 SDK（文字）

• 翻譯工具 npm 套件 （text）
文件智慧圖示 文件智慧服務 將檔案轉換成智慧型資料驅動解決方案。 • 適用於 JavaScript 的文件智慧 SDK

• 文件智能 npm 套件
Azure AI 搜尋圖示 Azure AI 搜尋服務 將 AI 支援的雲端搜尋引進行動應用程式和 Web 應用程式中。 • 適用於 JavaScript 的 Azure AI 搜尋 SDK

• Azure AI 搜尋 npm 套件

Python 支援服務

服務 說明 參考文件
語音圖示 語音 將語音轉換為文字、語音合成、翻譯和說話者辨識功能新增至應用程式功能。 • 適用於 Python 的語音 SDK

• 語音 PyPi 套件
內容安全性圖示 內容安全性 偵測應用程式和服務中的有害內容。 • 適用於 Python 的內容安全 SDK

• 內容安全性 PyPi 套件
視覺圖示 視覺 分析數位影像和多媒體資產中的內容。 • 適用於 Python 的視覺 SDK

• Vision PyPi 套件
語言圖示 語言 使用自然語言理解功能建置應用程式。 • 適用於 Python 的語言 SDK（文字分析）

• 語言 PyPi 套件 （文字分析）

• 適用於 Python 的語言 SDK（問題解答）

• 語言 PyPi 套件 （問題解答）

• 適用於 Python 的語言 SDK（語言對話）

• 語言 PyPi 套件 （語言交流）
翻譯工具圖示 翻譯工具 使用 AI 支援的翻譯技術來翻譯超過 100 種使用中、高風險和瀕危的語言和方言。 • 適用於 Python 的翻譯工具 SDK（文字）

• 翻譯工具 PyPi 套件 （文字）

• 適用於 Python 的翻譯 SDK（批次版）

• 翻譯工具 PyPi 套件 （批次）
文件智慧圖示 文件智慧服務 將檔案轉換成智慧型資料驅動解決方案。 • 適用於 Python 的文件智慧 SDK

• 檔案智慧 PyPi 套件
Azure AI 搜尋圖示 Azure AI 搜尋服務 將 AI 支援的雲端搜尋引進行動應用程式和 Web 應用程式中。 • 適用於 Python 的 Azure AI 搜尋 SDK

• Azure AI 搜尋 PyPi 套件