Azure AI Foundry SDK 客户端库

适用于 Python 的 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())
  # The AIProjectClient lets you access models, data, and services in your project.
  

适用于 Java 的 Azure AI Foundry Projects 客户端库（预览版）是一个统一库，通过连接到单个项目终结点，可以将多个客户端库一起使用。

• 将这些包添加到安装：

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

适用于 JavaScript 的 Azure AI Foundry Projects 客户端库是一个统一库，通过连接到单个项目终结点，可以将多个客户端库一起使用。

• 安装依赖项（预览版）：

  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());
  const projectClient = await project.getAzureOpenAIClient({
      // The API version should match the version of the Azure OpenAI resource
      apiVersion: "2024-12-01-preview"
  });
  // The AIProjectClient lets you access models, data, and services in your project.
  

适用于 .NET 的 Azure AI Foundry Projects 客户端库是一个统一库，通过连接到单个项目终结点，可以将多个客户端库一起使用。

• 安装软件包：

  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" }
  );
  // 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 ChatCompletionsClient(
      endpointUrl, 
      credential,
      clientOptions
  );
  // The ChatCompletionsClient lets you interact with models and services in your project.
  

C# 支持的服务

Service	Description	参考文档
语音	向应用程序添加语音到文本、文本到语音、翻译和说话人识别功能。	• 适用于 .NET 的语音 SDK • 语音 NuGet 包（语音命令行接口）
内容安全	检测应用程序和服务中的有害内容。	• 适用于 .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 搜索	将 AI 支持的云搜索引入你的移动应用和 Web 应用。	• 适用于 .NET 的 Azure AI 搜索 SDK • Azure AI 搜索 NuGet 包

Java 支持的服务

Service	Description	参考文档
语音	向应用程序添加语音到文本、文本到语音、翻译和说话人识别功能。	• 适用于 Java 的语音 SDK • 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 搜索	将 AI 支持的云搜索引入你的移动应用和 Web 应用。	• 适用于 Java 的 Azure AI 搜索 SDK • Azure AI 搜索 Maven 包

JavaScript 支持的服务

Service	Description	参考文档
语音	向应用程序添加语音到文本、文本到语音、翻译和说话人识别功能。	• 适用于 JavaScript 的语音 SDK • 语音 npm 包
内容安全	检测应用程序和服务中的有害内容。	• 适用于 JavaScript 的内容安全 SDK • 内容安全 npm 包
视觉	分析数字图像和富媒体资产中的内容。	• 适用于 JavaScript 的视觉 SDK • Vision npm 包
语言	使用自然语言理解功能生成应用程序。	• 适用于 JavaScript 的语言 SDK（文本分析） • 语言 npm 包
翻译工具	使用 AI 支持的翻译技术翻译超过 100 种正在使用、处于危险和濒危的语言和方言。	• JavaScript 翻译 SDK（文本） • 翻译 npm 包（文本）
文档智能	将文档转换为智能数据驱动解决方案。	• 适用于 JavaScript 的文档智能 SDK • 文档智能 npm 包
Azure AI 搜索	将 AI 支持的云搜索引入你的移动应用和 Web 应用。	• 适用于 JavaScript 的 Azure AI 搜索 SDK • Azure AI 搜索 npm 包

Python 支持的服务

Service	Description	参考文档
语音	向应用程序添加语音到文本、文本到语音、翻译和说话人识别功能。	• 适用于 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（批处理） • Translator PyPi 包（批处理）
文档智能	将文档转换为智能数据驱动解决方案。	• 用于 Python 的文档智能 SDK • 文档智能 PyPi 包
Azure AI 搜索	将 AI 支持的云搜索引入你的移动应用和 Web 应用。	• 适用于 Python 的 Azure AI 搜索 SDK • Azure AI 搜索 PyPi 包