Пакеты SDK и конечные точки Microsoft Foundry

• Установленная языковая среда выполнения:
  • Python: python --version (≥3.8)

• Установленная языковая среда выполнения:
  • Node.js: node --version (≥18)

• Установленная языковая среда выполнения:
  • .NET: dotnet --version (≥6.0)

• Установленная языковая среда выполнения:
  • Java: java --version (≥11)

Клиентская библиотека Azure AI Projects для Python — это единая библиотека, которая позволяет совместно использовать несколько клиентских библиотек, подключаясь к одной конечной точке проекта.

Выполните эту команду, чтобы установить пакеты для проектов Foundry.

pip install "azure-ai-projects>=2.0.0"

Клиентская библиотека Azure AI Projects для Java — это единая библиотека, которая позволяет совместно использовать несколько клиентских библиотек, подключаясь к одной конечной точке проекта.

Добавьте эти пакеты в установку для проектов Foundry.

package com.azure.ai.agents;

import com.azure.core.util.Configuration;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.openai.models.responses.Response;
import com.openai.models.responses.ResponseCreateParams;

Клиентская библиотека Azure AI Projects для JavaScript — это единая библиотека, которая позволяет совместно использовать несколько клиентских библиотек, подключаясь к одной конечной точке проекта.

Выполните эту команду, чтобы установить пакеты JavaScript для проектов Foundry.

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

Клиентская библиотека Azure AI Projects для .NET — это единая библиотека, которая позволяет совместно использовать несколько клиентских библиотек, подключаясь к одной конечной точке проекта.

Выполните эти команды, чтобы добавить необходимые пакеты в проект .NET.

dotnet add package Azure.AI.Projects
dotnet add package Azure.AI.Projects.Agents
dotnet add package Azure.AI.Extensions.OpenAI
dotnet add package Azure.Identity

Создайте клиент проекта:

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

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

Создайте клиент, совместимый с OpenAI, из проекта:

with project_client.get_openai_client() as openai_client:
    response = openai_client.responses.create(
        model="gpt-5.2",
        input="What is the size of France in square miles?",
    )
    print(f"Response output: {response.output_text}")

Ожидаемые выходные данные:

Response output: France has an area of approximately 213,011 square miles (551,695 square kilometers).

Создайте клиент проекта:

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();
```**Create and use an OpenAI-compatible client from your project:**
```java
OpenAIClient openAIClient = projectClient.getOpenAIClient();

Создайте клиент проекта:

import { DefaultAzureCredential } from "@azure/identity";
import { AIProjectClient } from "@azure/ai-projects";
import "dotenv/config";

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

Создайте клиент, совместимый с OpenAI, из проекта:

const openAIClient = await project.getOpenAIClient();
const response = await openAIClient.responses.create({
    model: deploymentName,
    input: "What is the size of France in square miles?",
});
console.log(`Response output: ${response.output_text}`);

Создайте клиент проекта:

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

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

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

Создайте клиент, совместимый с OpenAI, из проекта:

var responseClient = projectClient.ProjectOpenAIClient.GetProjectResponsesClientForModel("gpt-5.2");
var response = responseClient.CreateResponse("What is the speed of light?");
Console.WriteLine(response.GetOutputText());

from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://ai.azure.com/.default"
)

client = OpenAI(  
  base_url = "https://<resource-name>.openai.azure.com/openai/v1/",  
  api_key=token_provider,
)

response = client.responses.create(
    model="model_deployment_name",
    input= "What is the size of France in square miles?" 
)

print(response.model_dump_json(indent=2)) 

Ожидаемые выходные данные:

{
  "id": "resp_abc123",
  "object": "response",
  "created": 1234567890,
  "model": "gpt-5.2",
  "output_text": "France has an area of approximately 213,011 square miles (551,695 square kilometers)."
}

Для получения дополнительной информации см. раздел Поддерживаемые языки программирования Azure OpenAI

В следующем фрагменте кода показано, как напрямую использовать конечную точку Azure OpenAI /openai/v1.

import com.azure.identity.AuthenticationUtil;
import com.azure.identity.DefaultAzureCredential;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.credential.BearerTokenCredential;

import java.util.function.Supplier;

DefaultAzureCredential tokenCredential = new DefaultAzureCredentialBuilder().build();
String endpoint = "https://<resource-name>.openai.azure.com/openai/v1";
String deploymentName = "gpt-5.2";
Supplier<String> bearerTokenSupplier = AuthenticationUtil.getBearerTokenSupplier(
        tokenCredential, "https://ai.azure.com/.default");
OpenAIClient openAIClient = OpenAIOkHttpClient.builder()
        .baseUrl(endpoint)
        .credential(BearerTokenCredential.create(bearerTokenSupplier))
        .build();

ResponseCreateParams responseCreateParams = ResponseCreateParams.builder()
        .input("What is the speed of light?")
        .model(deploymentName) 
        .build();

Response response = openAIClient.responses().create(responseCreateParams);

System.out.println("Response output: " + response.getOutputText());

Дополнительные сведения об использовании пакета SDK OpenAI см. в разделе Azure поддерживаемые языки программирования OpenAI

const endpoint = "https://<resource-name>.openai.azure.com/openai/v1";
const scope = "https://ai.azure.com/.default";
const azureADTokenProvider = getBearerTokenProvider(new DefaultAzureCredential(), scope);
const client = new OpenAI({ baseURL: endpoint, apiKey: azureADTokenProvider });
const response = await client.responses.create({
        model: deploymentName,
        input: "What is the size of France in square miles?",
    });
console.log(`Response output: ${response.output_text}`);

Дополнительные сведения об использовании пакета SDK OpenAI см. в разделе Azure поддерживаемые языки программирования OpenAI

1. Установите пакет OpenAI: выполните следующую команду, чтобы добавить клиентную библиотеку OpenAI в проект .NET.

   dotnet add package OpenAI
   ```When it succeeds, the .NET CLI confirms that it installed the `OpenAI` package.
   
   This snippet configures `DefaultAzureCredential`, builds `OpenAIClientOptions`, and creates a `ResponsesClient` for the Azure OpenAI v1 endpoint.
   ```csharp
   using Azure.Identity;
   using OpenAI;
   using OpenAI.Responses;
   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://ai.azure.com/.default");
   
   OpenAIClient openAIClient = new(
        authenticationPolicy: tokenPolicy,
        options: new OpenAIClientOptions()
        {
            Endpoint = new($"{directModelEndpoint}"),
        });
   ResponsesClient client = openAIClient.GetResponsesClient();
   
   CreateResponseOptions options = new()
    {
        Model = deploymentName,
        InputItems = { ResponseItem.CreateUserMessageItem("What is the size of France in square miles?") },
        Temperature = (float)0.7,
    };
   
   var modelDirectResponse = client.CreateResponse(options);
   
   Console.WriteLine($"[ASSISTANT]: {modelDirectResponse.Value.GetOutputText()}");
   #pragma warning restore OPENAI001
   

Дополнительные сведения об использовании пакета SDK OpenAI см. в разделе Azure поддерживаемые языки программирования OpenAI

Средства Foundry с поддержкой C#

Инструмент Foundry	Описание	Краткие руководства и справочная документация
Речь	Добавьте в приложения возможности преобразования речи в текст, текста в речь, перевода и распознавания говорящего.	• Быстрый старт по преобразованию речи в текст • Краткое руководство по переводу текста в речь • Краткое руководство по переводу речи • пакет SDK Speech для .NET • пакет NuGet Speech (Speech CLI)
Язык	Создавайте приложения с возможностями распознавания естественного языка. Поддерживаемые функции: распознавание языка, обнаружение PII, Анализ текста для здравоохранения, Предварительно созданный NER и Пользовательский NER. Выход на пенсию 31 марта 2029 г.: анализ тональности и интеллектуальный анализ мнений, извлечение ключевых фраз, сводка, связывание сущностей, CQA и CLU.	• Краткое руководство по пользовательским вопросам (CQA) (снятие с эксплуатации 31 марта 2029 г.) • Краткое руководство по связыванию сущностей(выход из эксплуатации 31 марта 2029 г.) • Быстрый старт по обнаружению языка • Краткое руководство по извлечению ключевых фраз(прекращение поддержки 31 марта 2029 г.) • Краткое руководство по обнаружению именованных сущностей (NER) • Быстрый старт по обнаружению личных сведений (PII) • Краткое руководство по анализу тональности и интеллектуальному анализу мнений(выход на пенсию 31 марта 2029 г.) • Использование текстов, документов и быстрого старта для резюмирования бесед(прекращение поддержки 31 марта 2029 г.) • Текстовая аналитика для здравоохранения: краткое руководство по использованию • Language SDK для .NET (анализ текста) • пакет NuGet Language (текстовый анализ) • пакет SDK Language для .NET (ответы на вопросы) • пакет NuGet Language (ответы на вопросы) • Перейти из Language Studio в Microsoft Foundry для направления по миграции рабочих нагрузок с устаревающими функциями
Переводчик	Используйте технологию перевода на основе ИИ, чтобы перевести более 100 используемых, подверженных риску языков и диалектов.	• пакет SDK Translator для .NET (text) • Translator NuGet package (text) • пакет SDK Translator для .NET (пакетная версия) • Translator NuGet package (batch)
значок Поиск с использованием ИИ Azure	Запустите поиск в облаке, на основе искусственного интеллекта, в мобильные и веб-приложения.	• Быстрый старт по агентскому извлечению • Быстрый старт поиска по векторам • Классический генеративный поиск (RAG) с помощью краткого руководства по данным для привязки • Краткое руководство по полнотекстовому поиску • Краткое руководство по семантическому ранжированию • Чат с моделями Azure OpenAI при помощи руководства по быстрому старту с использованием собственных данных • пакет SDK Поиск с использованием ИИ Azure для .NET • пакет NuGet Поиск с использованием ИИ Azure
Безопасность содержимого	Обнаружение вредного содержимого в приложениях и службах.	• Быстрый старт по анализу текстового содержимого • Использование списка блокировок текста: быстрый старт • Краткое руководство по анализу содержимого изображения • Content Safety SDK для .NET • пакет NuGet Content Safety NuGet
Аналитика документов	Преобразуйте документы в интеллектуальные решения на основе данных.	• Краткое руководство по интеллектуальному анализу документов • пакет SDK Document Intelligence для .NET • пакет NuGet Document Intelligence
Видение	Анализ содержимого в цифровых изображениях и богатых ресурсах мультимедиа.	• Быстрый старт для Azure Vision в инструментах Foundry версии 3.2 GA • Краткое руководство по анализу изображений • Краткое руководство по использованию службы распознавания лиц • пакет SDK Vision для .NET • пакет NuGet Vision NuGet

Поддерживаемые Java средства Foundry

Инструмент Foundry	Описание	Краткие руководства и справочная документация
Речь	Добавьте в приложения возможности преобразования речи в текст, текста в речь, перевода и распознавания говорящего.	• Быстрый старт по преобразованию речи в текст • Краткое руководство по переводу текста в речь • Краткое руководство по переводу речи • пакет SDK Speech для Java • Пакет Speech Maven
Язык	Создавайте приложения с возможностями распознавания естественного языка. Поддерживаемые функции: распознавание языка, обнаружение PII, Анализ текста для здравоохранения, Предварительно созданный NER и Пользовательский NER. Выход на пенсию 31 марта 2029 г.: анализ тональности и интеллектуальный анализ мнений, извлечение ключевых фраз, сводка, связывание сущностей, CQA и CLU.	• Краткое руководство по связыванию сущностей(выход из эксплуатации 31 марта 2029 г.) • Быстрый старт по обнаружению языка • Краткое руководство по извлечению ключевых фраз(прекращение поддержки 31 марта 2029 г.) • Краткое руководство по обнаружению именованных сущностей (NER) • Быстрый старт по обнаружению личных сведений (PII) • Краткое руководство по анализу тональности и интеллектуальному анализу мнений(выход на пенсию 31 марта 2029 г.) • Использование текстов, документов и быстрого старта для резюмирования бесед(прекращение поддержки 31 марта 2029 г.) • Текстовая аналитика для здравоохранения: краткое руководство по использованию • пакет SDK Language для Java (анализ текста) • Пакет Language Maven • Перейти из Language Studio в Microsoft Foundry для направления по миграции рабочих нагрузок с устаревающими функциями
Переводчик	Используйте технологию перевода на основе ИИ, чтобы перевести более 100 используемых, подверженных риску языков и диалектов.	• SDK Translator для Java (текст) • Пакет Translator Maven (текст)
значок Поиск с использованием ИИ Azure	Запустите поиск в облаке, на основе искусственного интеллекта, в мобильные и веб-приложения.	• Быстрый старт по агентскому извлечению • Быстрый старт поиска по векторам • Классический генеративный поиск (RAG) с помощью краткого руководства по данным для привязки • Краткое руководство по полнотекстовому поиску • Краткое руководство по семантическому ранжированию • Чат с моделями Azure OpenAI при помощи руководства по быстрому старту с использованием собственных данных • SDK Поиск с использованием ИИ Azure для Java • пакет Поиск с использованием ИИ Azure Maven
Безопасность содержимого	Обнаружение вредного содержимого в приложениях и службах.	• Быстрый старт по анализу текстового содержимого • Использование списка блокировок текста: быстрый старт • Краткое руководство по анализу содержимого изображения • Content Safety SDK для Java • Пакет защиты содержимого Maven
Аналитика документов	Преобразуйте документы в интеллектуальные решения на основе данных.	• Краткое руководство по интеллектуальному анализу документов • пакет SDK Document Intelligence для Java • Пакет Maven аналитики документов
Видение	Анализ содержимого в цифровых изображениях и богатых ресурсах мультимедиа.	• Краткое руководство по анализу изображений • Краткое руководство по использованию службы распознавания лиц • пакет SDK Vision для Java • Пакет Vision Maven

Средства Foundry, поддерживающие JavaScript

Инструмент Foundry	Описание	Краткие руководства и справочная документация
Речь	Добавьте в приложения возможности преобразования речи в текст, текста в речь, перевода и распознавания говорящего.	• Быстрый старт по преобразованию речи в текст • Краткое руководство по переводу текста в речь • Краткое руководство по переводу речи • Пакет SDK для JavaScript (Речь) • Пакет npm "Speech"
Язык	Создавайте приложения с возможностями распознавания естественного языка. Поддерживаемые функции: распознавание языка, обнаружение PII, Анализ текста для здравоохранения, Предварительно созданный NER и Пользовательский NER. Выход на пенсию 31 марта 2029 г.: анализ тональности и интеллектуальный анализ мнений, извлечение ключевых фраз, сводка, связывание сущностей, CQA и CLU.	• Краткое руководство по связыванию сущностей(выход из эксплуатации 31 марта 2029 г.) • Быстрый старт по обнаружению языка • Краткое руководство по извлечению ключевых фраз(прекращение поддержки 31 марта 2029 г.) • Краткое руководство по обнаружению именованных сущностей (NER) • Быстрый старт по обнаружению личных сведений (PII) • Краткое руководство по анализу тональности и интеллектуальному анализу мнений(выход на пенсию 31 марта 2029 г.) • Использование текстов, документов и быстрого старта для резюмирования бесед(прекращение поддержки 31 марта 2029 г.) • Текстовая аналитика для здравоохранения: краткое руководство по использованию • Языковой пакет SDK для JavaScript (анализ текста) • Языковой пакет npm • Перейти из Language Studio в Microsoft Foundry для направления по миграции рабочих нагрузок с устаревающими функциями
Переводчик	Используйте технологию перевода на основе ИИ, чтобы перевести более 100 используемых, подверженных риску языков и диалектов.	• Пакет SDK переводчика для JavaScript (текст) • Пакет npm переводчика (текст)
значок Поиск с использованием ИИ Azure	Запустите поиск в облаке, на основе искусственного интеллекта, в мобильные и веб-приложения.	• Быстрый старт по агентскому извлечению • Быстрый старт поиска по векторам • Классический генеративный поиск (RAG) с помощью краткого руководства по данным для привязки • Краткое руководство по полнотекстовому поиску • Краткое руководство по семантическому ранжированию • Чат с моделями Azure OpenAI при помощи руководства по быстрому старту с использованием собственных данных • пакет SDK Поиск с использованием ИИ Azure для JavaScript • пакет npm Поиск с использованием ИИ Azure npm
Безопасность содержимого	Обнаружение вредного содержимого в приложениях и службах.	• Быстрый старт по анализу текстового содержимого • Использование списка блокировок текста: быстрый старт • Краткое руководство по анализу содержимого изображения • Пакет npm безопасности содержимого
Аналитика документов	Преобразуйте документы в интеллектуальные решения на основе данных.	• Краткое руководство по интеллектуальному анализу документов • Пакет SDK аналитики документов для JavaScript • Пакет npm для аналитики документов
Видение	Анализ содержимого в цифровых изображениях и богатых ресурсах мультимедиа.	• Быстрый старт для Azure Vision в инструментах Foundry версии 3.2 GA • Краткое руководство по анализу изображений • Краткое руководство по использованию службы распознавания лиц • Пакет SDK визуального распознавания для JavaScript • Пакет npm для визуального зрения

Средства Foundry с поддержкой Python

Инструмент Foundry	Описание	Краткие руководства и справочная документация
Речь	Добавьте в приложения возможности преобразования речи в текст, текста в речь, перевода и распознавания говорящего.	• Быстрый старт по преобразованию речи в текст • Краткое руководство по переводу текста в речь • Краткое руководство по переводу речи • пакет SDK Speech для Python • Пакет PyPi Speech
Язык	Создавайте приложения с возможностями распознавания естественного языка. Поддерживаемые функции: распознавание языка, обнаружение PII, Анализ текста для здравоохранения, Предварительно созданный NER и Пользовательский NER. Выход на пенсию 31 марта 2029 г.: анализ тональности и интеллектуальный анализ мнений, извлечение ключевых фраз, сводка, связывание сущностей, CQA и CLU.	• Краткое руководство по пользовательским вопросам (CQA) (снятие с эксплуатации 31 марта 2029 г.) • Краткое руководство по связыванию сущностей(выход из эксплуатации 31 марта 2029 г.) • Быстрый старт по обнаружению языка • Краткое руководство по извлечению ключевых фраз(прекращение поддержки 31 марта 2029 г.) • Краткое руководство по обнаружению именованных сущностей (NER) • Быстрый старт по обнаружению личных сведений (PII) • Краткое руководство по анализу тональности и интеллектуальному анализу мнений(выход на пенсию 31 марта 2029 г.) • Использование текстов, документов и быстрого старта для резюмирования бесед(прекращение поддержки 31 марта 2029 г.) • Текстовая аналитика для здравоохранения: краткое руководство по использованию • пакет SDK Language для Python (анализ текста) • Пакет PyPi языка (анализ текста) • Language SDK для Python (ответы на вопросы) • Пакет PyPi языка (ответы на вопросы) • Language SDK для Python (языковые взаимодействия)(вывод из эксплуатации 31 марта 2029 г.) • Пакет PyPi языка (разговоры на языке)(выход из эксплуатации 31 марта 2029 г.) • Перейти из Language Studio в Microsoft Foundry для направления по миграции рабочих нагрузок с устаревающими функциями
Переводчик	Используйте технологию перевода на основе ИИ, чтобы перевести более 100 используемых, подверженных риску языков и диалектов.	• пакет SDK Translator для Python (text) • Пакет PyPi переводчика (текст) • пакет SDK Translator для Python (пакетная версия) • Пакет PyPi переводчика (пакетная обработка)
значок Поиск с использованием ИИ Azure	Запустите поиск в облаке, на основе искусственного интеллекта, в мобильные и веб-приложения.	• Быстрый старт подключения к службе поиска • Быстрый старт по агентскому извлечению • Быстрый старт поиска по векторам • Классический генеративный поиск (RAG) с помощью краткого руководства по данным для привязки • Краткое руководство по полнотекстовому поиску • Краткое руководство по семантическому ранжированию • Чат с моделями Azure OpenAI при помощи руководства по быстрому старту с использованием собственных данных • пакет SDK Поиск с использованием ИИ Azure для Python • пакет pyPi Поиск с использованием ИИ Azure PyPi
Безопасность содержимого	Обнаружение вредного содержимого в приложениях и службах.	• Быстрый старт по анализу текстового содержимого • Использование списка блокировок текста: быстрый старт • Краткое руководство по анализу содержимого изображения • SDK Content Safety для Python • Пакет PyPi безопасности содержимого
Аналитика документов	Преобразуйте документы в интеллектуальные решения на основе данных.	• Краткое руководство по интеллектуальному анализу документов • пакет SDK Document Intelligence для Python • Пакет PyPi аналитики документов
Видение	Анализ содержимого в цифровых изображениях и богатых ресурсах мультимедиа.	• Быстрый старт для Azure Vision в инструментах Foundry версии 3.2 GA • Краткое руководство по анализу изображений • Краткое руководство по использованию службы распознавания лиц • пакет SDK Vision для Python • Пакет PyPi визуального зрения