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
  

• 在代码中创建项目客户端。 从项目的“概述”页复制 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 的语音 SDK • 语音 NuGet 包（语音命令行接口）
内容安全	检测应用程序和服务中的有害内容。	• 分析文本内容快速入门 • 使用文本阻止列表快速入门 • 图像内容分析快速入门 • 适用于 .NET 的内容安全 SDK • 内容安全 NuGet 包
视觉	分析数字图像和富媒体资产中的内容。	• Foundry Tools v3.2 GA 中的 Azure Vision 阅读快速入门指南 • 图像分析快速入门 • 使用人脸服务快速入门 • 适用于 .NET 的视觉 SDK • 视觉 NuGet 包
语言	使用自然语言理解功能生成应用程序。	• 自定义问答（CQA）快速入门 • 实体链接快速入门 • 语言检测快速入门 • 关键短语提取快速入门 • 检测命名实体（NER）快速入门 • 检测个人身份信息（PII）快速入门 • 情绪分析和观点挖掘快速入门 • 使用文本、文档和对话摘要快速入门 • 使用文本分析进行健康快速入门 • 用于 .NET 的语言 SDK（文本分析） • 语言 NuGet 包（文本分析） • 适用于 .NET 的语言 SDK （问答） • 语言 NuGet 包（问题解答）
翻译工具	使用 AI 支持的翻译技术翻译超过 100 种正在使用、处于危险和濒危的语言和方言。	• 适用于 .NET 的翻译 SDK （文本） • NuGet 翻译包（文本） • 适用于 .NET 的翻译 SDK（批处理） • NuGet 翻译包（批处理）
文档智能	将文档转换为智能数据驱动解决方案。	• 文档智能快速入门 • 适用于 .NET 的文档智能 SDK • 文档智能 NuGet 包
Azure AI 搜索	将 AI 支持的云搜索引入你的移动应用和 Web 应用。	• 使用代理检索快速入门 • 矢量搜索快速入门 • 使用基础设置数据进行经典生成式搜索 (RAG) 快速入门 • 全文搜索快速入门 • 语义排名快速入门 • 快速入门：使用自己的数据与 Azure OpenAI 模型聊天 • 适用于 .NET 的 Azure AI 搜索 SDK • Azure AI 搜索 NuGet 包

Java 支持的 Foundry 工具

铸造工具	Description	快速入门和参考文档
语音	向应用程序添加语音到文本、文本到语音、翻译和说话人识别功能。	• 语音转文本快速入门 • 文本转语音快速入门 • 语音翻译快速入门 • 适用于 Java 的语音 SDK • Maven 语音包
内容安全	检测应用程序和服务中的有害内容。	• 分析文本内容快速入门 • 使用文本阻止列表快速入门 • 图像内容分析快速入门 • 适用于 Java 的内容安全 SDK • 内容安全 Maven 包
视觉	分析数字图像和富媒体资产中的内容。	• 图像分析快速入门 • 使用人脸服务快速入门 • 适用于 Java 的视觉 SDK • 视觉 Maven 包
语言	使用自然语言理解功能生成应用程序。	• 实体链接快速入门 • 语言检测快速入门 • 关键短语提取快速入门 • 检测命名实体（NER）快速入门 • 检测个人身份信息（PII）快速入门 • 情绪分析和观点挖掘快速入门 • 使用文本、文档和对话摘要快速入门 • 使用文本分析进行健康快速入门 • 用于 Java 的语言 SDK（文本分析） • 语言 Maven 包
翻译工具	使用 AI 支持的翻译技术翻译超过 100 种正在使用、处于危险和濒危的语言和方言。	• Java 翻译 SDK（文本） • Maven 翻译包（文本）
文档智能	将文档转换为智能数据驱动解决方案。	• 文档智能快速入门 • 适用于 Java 的文档智能 SDK • 文档智能 Maven 包
Azure AI 搜索	将 AI 支持的云搜索引入你的移动应用和 Web 应用。	• 使用代理检索快速入门 • 矢量搜索快速入门 • 使用基础设置数据进行经典生成式搜索 (RAG) 快速入门 • 全文搜索快速入门 • 语义排名快速入门 • 快速入门：使用自己的数据与 Azure OpenAI 模型聊天 • 适用于 Java 的 Azure AI 搜索 SDK • Azure AI 搜索 Maven 包

JavaScript 支持的 Foundry 工具

铸造工具	Description	参考文档
语音	向应用程序添加语音到文本、文本到语音、翻译和说话人识别功能。	• 语音转文本快速入门 • 文本转语音快速入门 • 语音翻译快速入门 • 适用于 JavaScript 的语音 SDK • 语音 npm 包
内容安全	检测应用程序和服务中的有害内容。	• 分析文本内容快速入门 • 使用文本阻止列表快速入门 • 图像内容分析快速入门 • 内容安全 npm 包
视觉	分析数字图像和富媒体资产中的内容。	• Foundry Tools v3.2 GA 中的 Azure Vision 阅读快速入门指南 • 图像分析快速入门 • 使用人脸服务快速入门 • 适用于 JavaScript 的视觉 SDK • Vision npm 包
语言	使用自然语言理解功能生成应用程序。	• 实体链接快速入门 • 语言检测快速入门 • 关键短语提取快速入门 • 检测命名实体（NER）快速入门 • 检测个人身份信息（PII）快速入门 • 情绪分析和观点挖掘快速入门 • 使用文本、文档和对话摘要快速入门 • 使用文本分析进行健康快速入门 • 适用于 JavaScript 的语言 SDK（文本分析） • 语言 npm 包
翻译工具	使用 AI 支持的翻译技术翻译超过 100 种正在使用、处于危险和濒危的语言和方言。	• JavaScript 翻译 SDK（文本） • 翻译 npm 包（文本）
文档智能	将文档转换为智能数据驱动解决方案。	• 文档智能快速入门 • 适用于 JavaScript 的文档智能 SDK • 文档智能 npm 包
Azure AI 搜索	将 AI 支持的云搜索引入你的移动应用和 Web 应用。	• 使用代理检索快速入门 • 矢量搜索快速入门 • 使用基础设置数据进行经典生成式搜索 (RAG) 快速入门 • 全文搜索快速入门 • 语义排名快速入门 • 快速入门：使用自己的数据与 Azure OpenAI 模型聊天 • 适用于 JavaScript 的 Azure AI 搜索 SDK • Azure AI 搜索 npm 包

Python 支持的 Foundry 工具

铸造工具	Description	快速入门和参考文档
语音	向应用程序添加语音到文本、文本到语音、翻译和说话人识别功能。	• 语音转文本快速入门 • 文本转语音快速入门 • 语音翻译快速入门 • 适用于 Python 的语音 SDK • 语音 PyPi 包
内容安全	检测应用程序和服务中的有害内容。	• 分析文本内容快速入门 • 使用文本阻止列表快速入门 • 图像内容分析快速入门 • 适用于 Python 的内容安全 SDK • 内容安全 PyPi 包
视觉	分析数字图像和富媒体资产中的内容。	• Foundry Tools v3.2 GA 中的 Azure Vision 阅读快速入门指南 • 图像分析快速入门 • 使用人脸服务快速入门 • 用于 Python 的视觉 SDK • Vision PyPi 包
语言	使用自然语言理解功能生成应用程序。	• 自定义问答（CQA）快速入门 • 实体链接快速入门 • 语言检测快速入门 • 关键短语提取快速入门 • 检测命名实体 (NER) 快速入门 • 检测个人身份信息（PII）快速入门 • 情绪分析和观点挖掘快速入门 • 使用文本、文档和对话摘要快速入门 • 使用文本分析进行健康快速入门 • 用于 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 应用。	• 连接到搜索服务快速入门 • 使用代理检索快速入门 • 矢量搜索快速入门 • 使用基础设置数据进行经典生成式搜索 (RAG) 快速入门 • 全文搜索快速入门 • 语义排名快速入门 • 快速入门：使用自己的数据与 Azure OpenAI 模型聊天 • 适用于 Python 的 Azure AI 搜索 SDK • Azure AI 搜索 PyPi 包