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

Ресурс Foundry предоставляет унифицированный доступ к моделям, агентам и средствам. В этой статье объясняется, какой пакет SDK и конечная точка используются для вашего сценария.

Пакет SDK Foundry — это пакет SDK с тонким клиентом, который предоставляет все API проекта Foundry через одну конечную точку проекта. Пакеты SDK для более высокого уровня создаются на нем. Например, пакет Agent Framework foundry зависит от пакета SDK Foundry для доступа к моделям, средствам и конфигурации проекта Foundry.

SDK Что это за конечная точка
Foundry SDK SDK тонкого клиента для работы со всеми API проекта Foundry. Доступ к моделям и платформам Foundry (поиск файлов, интерпретатор кода, веб-поиск, память, SharePoint, WorkIQ, Fabric IQ, MCP). https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
Платформа агента Размещенные агенты и многоагентные системы создаются с помощью кода. Пакет foundry зависит от пакета SDK Foundry для доступа к проекту. Запустить в отдельном процессе. API ответов в конечной точке проекта через FoundryChatClient.
OpenAI SDK Вся функциональность API OpenAI, включая эмбеддинги. Максимальная задержка и максимальная совместимость OpenAI. https://<resource-name>.openai.azure.com/openai/v1
Anthropic SDK Модели Anthropic Claude, развернутые в Foundry. https://<resource-name>.services.ai.azure.com/anthropic
Пакеты SDK для средств foundry Предварительно созданные решения (визуальное распознавание, речь, безопасность содержимого и многое другое). Конечные точки для конкретного инструмента.

Выберите пакет SDK:

  • Используйте Foundry SDK при создании приложений с агентами, оценками или функциями, относящимися к Foundry.
  • Используйте Agent Framework при создании размещённых агентов или мультиагентных систем в коде с использованием API Responses
  • Используйте OpenAI SDK, если требуется максимальная совместимость с OpenAI или минимальная задержка, при генерации эмбеддингов или при использовании прямых моделей Foundry через Chat Completions
  • Используйте пакет SDK Anthropic при работе с моделями Anthropic Claude, развернутыми в Foundry
  • Используйте пакеты SDK для средств Foundry при работе с определенными службами ИИ (визуальное распознавание, речь, язык и т. д.)

Примечание

Типы ресурсов: Ресурс Foundry предоставляет все ранее перечисленные конечные точки. Ресурс OpenAI Azure предоставляет только конечную точку /openai/v1.

Authentication: Примеры используют Microsoft Entra ID (DefaultAzureCredential). Ключи API работают с /openai/v1. Передайте ключ api_key вместо поставщика токенов.

Необходимые условия

  • Учетная запись Azure с активной подпиской. Если у вас нет, создайте учетную запись free Azure, которая включает бесплатную пробную подписку.

  • Укажите одну из следующих Azure ролей RBAC для создания ресурсов Foundry и управления ими.

    • Пользователь Foundry (роль с минимальными привилегиями для разработки)

      Важно

      Недавно были переименованы роли RBAC в Foundry. Foundry User, Foundry Owner, Foundry Account Owner и Foundry Project Manager ранее назывались пользователь Azure AI, владелец Azure AI, владелец учетной записи Azure AI и руководитель проекта Azure AI. Пока новое название внедряется, в некоторых местах вы всё ещё можете видеть прежние названия. Идентификаторы ролей и основные разрешения не меняются из-за переименования.

    • Foundry Project Manager (для управления проектами Foundry)

    • Участник или владелец (для разрешений на уровне подписки)

    Дополнительные сведения о разрешениях каждой роли см. в разделе Role-based access control for Microsoft Foundry.

  • Установите необходимые языковые среды выполнения, глобальные средства и расширения VS Code, как описано в разделе "Подготовка среды разработки".

Важно

Перед началом работы убедитесь, что среда разработки готова.
В этой статье рассматриваются конкретные сценарии, такие как установка пакета SDK, проверка подлинности и выполнение примера кода.

Проверка предварительных требований

Прежде чем продолжить, подтвердите:

  • Azure подписка активна: az account show
  • У вас есть необходимая роль RBAC: проверьте в портале Azure, ресурс Foundry, контроль управления доступом (IAM)
  • Установленная языковая среда выполнения:
    • Python: python --version (≥3.8)
  • Установленная языковая среда выполнения:
    • Node.js: node --version (≥18)
  • Установленная языковая среда выполнения:
    • .NET: dotnet --version (≥6.0)
  • Установленная языковая среда выполнения:
    • Java: java --version (≥11)

Foundry SDK

Пакет SDK Foundry — это пакет SDK с тонким клиентом, который предоставляет доступ ко всем API проекта Foundry через одну конечную точку проекта:

https://<resource-name>.services.ai.azure.com/api/projects/<project-name>

Это основа, на которой строятся другие SDK с поддержкой Foundry. Например, пакет Agent Framework foundry имеет зависимость от Foundry SDK и использует его для доступа к функциональности Foundry — при использовании FoundryChatClient вам не нужно самостоятельно настраивать конечную точку проекта или OpenAI-совместимый клиент.

Примечание

Если в организации используется настраиваемый поддомен, замените <resource-name> на <your-custom-subdomain> URL-адрес конечной точки.

Этот подход упрощает настройку приложения. Вместо управления несколькими конечными точками можно настроить одну.

Установка пакета SDK

Версия пакета SDK Версия портала Статус Пакет Python
2.x Литейный завод (новый) Стабильный azure-ai-projects>=2.0.0
1.x Литейный (классический) Стабильный azure-ai-projects==1.0.0

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

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

pip install "azure-ai-projects>=2.0.0"
Версия пакета SDK Версия портала Статус Пакет Java
2.0.0 Литейный завод (новый) Стабильный azure-ai-projects
azure-ai-agents
Версия пакета SDK Версия портала Статус Пакет JavaScript
2.0.1 Литейный завод (новый) Стабильный @azure/ai-projects
1.0.1 Классический литейный Стабильный @azure/ai-projects
Версия пакета SDK Версия портала Статус пакет .NET
2.0.0 (GA) Литейный завод (новый) Стабильный Azure.AI.Projects
Azure.AI.Projects.Agents
Azure.AI.Extensions.OpenAI
1.1.0 (GA) Классический литейный Стабильный Azure.AI.Projects

Важно

Не устанавливайте Azure.AI.Projects.OpenAI (предварительная версия) вместе с Azure.AI.Extensions.OpenAI (GA). Оба пакета определяют одни и те же типы в разных пространствах имен, что приводит к неоднозначным ошибкам ссылок. Используйте только Azure.AI.Extensions.OpenAI для сценариев агента.

Клиентская библиотека 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

Использование пакета SDK для Foundry

Пакет SDK предоставляет два типа клиентов, так как Foundry и OpenAI имеют разные формы API:

  • Клиент Project — используйте для операций, которые являются собственными для Foundry и не имеют эквивалента в OpenAI. Примеры: перечисление подключений, получение свойств проекта, включение трассировки.
  • Клиент, совместимый с OpenAI , используется для функций Foundry, основанных на концепциях OpenAI. API ответов, агенты, оценки и тонкая настройка используют шаблон запроса/ответа в стиле OpenAI. Этот клиент ориентирован на API Responses в эндпойнте вашего проекта, который предоставляет доступ к моделям Foundry из каталога (включая прямые модели, не относящиеся к Azure OpenAI), а также к инструментам платформы — стандартным инструментам OpenAI, таким как поиск по файлам, интерпретатор кода и веб-поиск, а также эксклюзивным инструментам Foundry, таким как память, SharePoint, WorkIQ, Fabric IQ и серверы MCP. Конечная точка проекта обслуживает этот трафик по маршруту /openai .

Большинство приложений используют оба клиента. Используйте клиент проекта для настройки и настройки, а затем используйте клиент, совместимый с OpenAI, для выполнения агентов, вычислений и вызовов моделей (включая прямые модели Foundry).

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

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());

Что можно сделать с помощью Foundry SDK

Устранение неполадок

Ошибки проверки подлинности

Если вы видите DefaultAzureCredential failed to retrieve a token:

  1. Убедитесь, что Azure CLI аутентифицирован

    az account show
    az login  # if not logged in
    
  2. Проверьте назначение ролей RBAC:

    • Убедитесь, что у вас есть по крайней мере роль пользователя Foundry в проекте Foundry

      Важно

      Недавно были переименованы роли RBAC в Foundry. Foundry User, Foundry Owner, Foundry Account Owner и Foundry Project Manager ранее назывались пользователь Azure AI, владелец Azure AI, владелец учетной записи Azure AI и руководитель проекта Azure AI. Пока новое название внедряется, в некоторых местах вы всё ещё можете видеть прежние названия. Идентификаторы ролей и основные разрешения не меняются из-за переименования.

    • См. раздел Назначение ролей Azure

  3. Для управляемого удостоверения в промышленных условиях:

Ошибки конфигурации конечной точки

Если вы видите Connection refused или 404 Not Found:

  • Убедитесь, что имена ресурсов и проектов соответствуют фактическому развертыванию
  • Проверьте формат URL-адреса конечной точки: должно быть https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
  • Для пользовательских поддоменов: замените <resource-name> настраиваемым поддоменом

Несоответствие версий пакета SDK

Если примеры кода завершаются ошибкой AttributeError или ModuleNotFoundError:

  • Проверьте версию пакета SDK:

    pip show azure-ai-projects  # Python
    npm list @azure/ai-projects  # JavaScript
    dotnet list package  # .NET
    
  • Переустановка с правильными флагами версий: см. команды установки в каждом разделе языка выше

OpenAI SDK

Используйте пакет SDK OpenAI, если требуется полная поверхность API OpenAI, оптимальная задержка и максимальная совместимость с существующими клиентами OpenAI. Этот конечный объект напрямую предоставляет доступ к API Responses в Azure OpenAI, а также к моделям Azure OpenAI и моделям Foundry Direct, включая эмбеддинги, завершения чата и генерацию изображений. Он не предоставляет доступ к функциям, зависящим от Foundry, таким как агенты, оценки или средства платформы foundry-exclusive, для них используйте API ответов в конечной точке проекта с помощью пакета SDK Foundry.

Совет

Используйте конечную точку пакета SDK OpenAI для генерации векторов представлений. Конечная точка проекта, используемая пакетом SDK Foundry, в настоящее время не направляет запросы на внедрение.

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

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

пакет SDK Anthropic

Используйте пакет SDK Anthropic для работы с моделями Anthropic Claude, развернутыми в Foundry. Модели Claude используют отдельную конечную точку /anthropic и API сообщений Anthropic, а не конечную точку, совместимую с OpenAI.

Эндпоинт Anthropic добавляет /anthropic к URL-адресу ресурса:

https://<resource-name>.services.ai.azure.com/anthropic

API сообщений доступен по адресу:

https://<resource-name>.services.ai.azure.com/anthropic/v1/messages
from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

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

client = AnthropicFoundry(
    azure_ad_token_provider=token_provider,
    base_url="https://<resource-name>.services.ai.azure.com/anthropic",
)

message = client.messages.create(
    model="claude-sonnet-4-6",  # Replace with your deployment name
    messages=[
        {"role": "user", "content": "What are 3 things to visit in Seattle?"}
    ],
    max_tokens=1048,
)

print(message.content)

Пакет SDK Anthropic не предоставляет собственный клиент C#. Используйте REST API с HttpClient для вызова моделей Claude.

using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using Azure.Identity;

string endpoint = "https://<resource-name>.services.ai.azure.com/anthropic/v1/messages";
string deploymentName = "claude-sonnet-4-6"; // Replace with your deployment name

var credential = new DefaultAzureCredential();
var token = await credential.GetTokenAsync(
    new Azure.Core.TokenRequestContext(["https://ai.azure.com/.default"]));

using var httpClient = new HttpClient();
httpClient.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", token.Token);
httpClient.DefaultRequestHeaders.Add("anthropic-version", "2023-06-01");

var requestBody = new
{
    model = deploymentName,
    messages = new[] { new { role = "user", content = "What are 3 things to visit in Seattle?" } },
    max_tokens = 1048
};

var response = await httpClient.PostAsync(
    endpoint,
    new StringContent(JsonSerializer.Serialize(requestBody), Encoding.UTF8, "application/json"));

string result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
import AnthropicFoundry from '@anthropic-ai/foundry-sdk';
import { getBearerTokenProvider, DefaultAzureCredential } from "@azure/identity";

const tokenProvider = getBearerTokenProvider(
    new DefaultAzureCredential(),
    'https://ai.azure.com/.default');

const client = new AnthropicFoundry({
    azureADTokenProvider: tokenProvider,
    baseURL: "https://<resource-name>.services.ai.azure.com/anthropic",
    apiVersion: "2023-06-01"
});

const message = await client.messages.create({
    model: "claude-sonnet-4-6", // Replace with your deployment name
    messages: [{ role: "user", content: "What are 3 things to visit in Seattle?" }],
    max_tokens: 1048,
});

console.log(message);

Пакет SDK Anthropic не предоставляет собственный клиент Java. Используйте REST API с HttpClient для вызова моделей Claude.

import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.core.credential.TokenRequestContext;

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

String endpoint = "https://<resource-name>.services.ai.azure.com/anthropic/v1/messages";
String deploymentName = "claude-sonnet-4-6"; // Replace with your deployment name

var credential = new DefaultAzureCredentialBuilder().build();
var token = credential.getToken(
    new TokenRequestContext().addScopes("https://ai.azure.com/.default")).block();

String requestBody = """
    {
        "model": "%s",
        "messages": [{"role": "user", "content": "What are 3 things to visit in Seattle?"}],
        "max_tokens": 1048
    }
    """.formatted(deploymentName);

HttpClient httpClient = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create(endpoint))
    .header("Authorization", "Bearer " + token.getToken())
    .header("Content-Type", "application/json")
    .header("anthropic-version", "2023-06-01")
    .POST(HttpRequest.BodyPublishers.ofString(requestBody))
    .build();

HttpResponse<String> response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Дополнительные сведения см. в разделе Использование моделей Anthropic Claude в Microsoft Foundry.

Платформа агента

Microsoft Agent Framework — это пакет SDK с открытым кодом (Python и .NET) для создания агентов и систем с несколькими агентами в коде. Это рекомендуемый путь для агентов Hosted (предварительная версия) в Microsoft Foundry.

Запустите свой код в качестве размещённого агента

Основной сценарий для агентов на основе кода в Foundry — Размещённые агенты (предварительная версия). Напишите своего агента с помощью Agent Framework, упакуйте его в образ контейнера или ZIP-архив с исходным кодом и позвольте Foundry запускать его с управляемой конечной точкой доступа, автоматическим масштабированием на изолированных Micro VM, выделенным удостоверением агента Microsoft Entra, состоянием на уровне сеанса и сквозной наблюдаемостью.

Размещённые агенты — это рекомендуемый вариант, если вам нужна управляемая Foundry конечная точка, доступная по сети, к которой могут обращаться другие приложения или агенты. См. раздел "Развертывание первого размещенного агента".

Создание агентов в коде за пределами Foundry с помощью API ответов

Если вы размещаете агент за пределами Foundry ( в собственном процессе или инфраструктуре), вы также можете использовать агентную платформу для вызова API ответов в конечной точке проекта напрямую. Agent Framework подключается через поставщика FoundryChatClient, который предназначен для следующих целей:

{project_endpoint}/openai/v1/responses

Переход к конечной точке проекта , а не конечной точке OpenAI на уровне ресурсов, предоставляет агенту:

  • Модели Foundry из каталога (Azure OpenAI и прямые модели Foundry) через единый API.
  • Средства платформы за пределами набора инструментов OpenAI, включая поиск файлов, интерпретатор кода, память, веб-поиск, серверы MCP, SharePoint, WorkIQ и Fabric IQ.
  • Данные в рамках проекта, аутентификация инструмента On-Behalf-Of (OBO), а также трассировка проекта, фильтры содержимого и конфигурация идентификации.

Этот шаблон дополняет размещённых агентов, а не заменяет их — тот же код Agent Framework уже сегодня может вызывать API Responses из вашего собственного процесса, а позже его можно упаковать как размещённого агента, когда вам понадобится конечная точка, управляемая Foundry. См. Краткое руководство: создание агентов с помощью API Responses.

Полное сравнение типов агентов и вариантов размещения см. в статье Что такое служба агентов Microsoft Foundry?.

Пакеты SDK для средств Foundry Tools

Инструменты Foundry (ранее Azure AI Services) — это предварительно разработанные точечные решения с выделенными пакетами SDK. Используйте следующие конечные точки для работы с средствами Foundry.

Какую конечную точку следует использовать?

Выберите конечную точку в зависимости от ваших потребностей:

Используйте конечную точку служб ИИ Azure для доступа к Компьютерное зрение, безопасности содержимого, аналитике документов, языку, переводу и средствам поиска маркеров.

Конечная точка средств Foundry: https://<your-resource-name>.cognitiveservices.azure.com/

Примечание

Конечные точки используют имя ресурса или настраиваемый поддомен. Если ваша организация настроила настраиваемый поддомен, замените во всех примерах конечных точек your-resource-name на your-custom-subdomain.

Если ваши рабочие нагрузки используют функции, которые Язык ИИ Azure прекращает поддерживать, такие как анализ тональности, извлечение ключевых фраз, резюмирование, связывание сущностей, CLU или CQA, следует планировать миграцию на альтернативы Foundry от Microsoft. Для новой разработки рекомендуется использовать пакет SDK для Foundry или конечную точку, совместимую с OpenAI, как описано ранее в этой статье. См. раздел Migrate из Language Studio в Microsoft Foundry.

Для средств распознавания речи и перевода используйте конечные точки в следующих таблицах. Замените заполнители сведениями о ресурсе.

Конечные точки речи

Литейный инструмент конечная точка
Речь к тексту (стандартная версия) https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com
Text to Speech (нейронные) https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com
Пользовательский голос https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/

Конечные точки перевода

Литейный инструмент конечная точка
Перевод текста https://api.cognitive.microsofttranslator.com/
Перевод документов https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/

Конечные точки языка

Литейный инструмент конечная точка
Анализ текста https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com

Важно

20 марта 2027 г. Azure Language Studio будет прекращена и перенесена в Microsoft Foundry; все возможности и будущие улучшения будут доступны в Microsoft Foundry.

31 марта 2029 г. следующие возможности языка Azure будут прекращены (прекращение поддержки). До этой даты пользователи должны перенести существующие рабочие нагрузки и подключить новые проекты к Microsoft модели Foundry для улучшения распознавания естественного языка и упрощенной интеграции приложений:

  • Извлечение ключевых фраз
  • Анализ тональности и определение мнений
  • Классификация пользовательского текста
  • Разговорное понимание языка (CLU)
  • Пользовательская система ответов на вопросы (CQA)
  • Рабочий процесс оркестрации
  • Сводка (извлекательная и абстрактная, для документов и переговоров)
  • Связывание сущностей

Основные функции с постоянной поддержкой: распознавание языка, обнаружение PII, Анализ текста для здравоохранения, предварительно настроенного NER и пользовательского NER.

Варианты миграции см. в разделе Migrate из Language Studio в Microsoft Foundry.

Поддерживаемые инструменты Foundry в C#

Литейный инструмент Описание Инструкции для начала работы и справочная документация
Значок Речь Добавьте возможность преобразования речи в текст, текста в речь, перевода и распознавания говорящего в приложения. Краткое руководство по распознаванию речи в текстовый формат

Краткое руководство по преобразованию текста в речь

Быстрый старт по переводу речи

• пакет SDK Speech для .NET

пакет NuGet Speech (Speech CLI)
Языковой значок Язык Создавайте приложения с возможностями распознавания естественного языка. Поддерживаемые функции: распознавание языка, обнаружение PII, Анализ текста для здравоохранения, предварительно созданный NER и пользовательский NER. Вывод из эксплуатации 31 марта 2029 г.: анализ тональности и анализ мнений, извлечение ключевых фраз, суммирование, связывание сущностей, CQA и CLU. Краткое руководство по быстрому ответу на вопросы (CQA) (устаревание 31 марта 2029 г.)

Краткое руководство по связыванию сущностей(выход из эксплуатации 31 марта 2029 г.)

Быстрый старт по обнаружению языка

Краткое руководство по извлечению ключевых фраз(закрытие 31 марта 2029 г.)

Краткое руководство по обнаружению именованных сущностей (Named Entity Recognition, NER)

Краткое руководство по обнаружению персональной информации (PII)

Краткое руководство по анализу тональности и интеллектуальному анализу мнений(выход на пенсию 31 марта 2029 г.)

Краткое руководство по использованию текста, документа ибеседы (выход на пенсию 31 марта 2029 г.)

Использование Анализ текста для быстрого старта в области здравоохранения

• языковой пакет SDK для .NET (анализ текста)

пакет NuGet Language (анализ текста)

SDK для обработки языков (.NET, ответы на вопросы)

• пакет NuGet для языка (ответы на вопросы)

Перенесите из Language Studio в Microsoft Foundry для миграции рабочих нагрузок с устаревающими функциями
Значок переводчика Переводчик Используйте технологию перевода на основе ИИ, чтобы перевести более 100 используемых, подверженных риску языков и диалектов. SDK Translator для .NET (text)

Пакет NuGet переводчика (текст)

• пакет SDK Translator для .NET (пакетная версия)

Пакет Translator NuGet (batch)
значок Поиск с использованием ИИ AzureПоиск с использованием ИИ 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 Tools версии 3.2 Общая доступность Краткий старт

Краткое руководство по анализу изображений

Краткое руководство по использованию службы распознавания лиц

• пакет SDK Vision для .NET

• пакет NuGet Vision NuGet

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

Литейный инструмент Описание Инструкции для начала работы и справочная документация
Значок Речь Добавьте возможность преобразования речи в текст, текста в речь, перевода и распознавания говорящего в приложения. Краткое руководство по распознаванию речи в текстовый формат

Краткое руководство по преобразованию текста в речь

Быстрый старт по переводу речи

• пакет SDK Speech для Java

Пакет Speech Maven
Языковой значок Язык Создавайте приложения с возможностями распознавания естественного языка. Поддерживаемые функции: распознавание языка, обнаружение PII, Анализ текста для здравоохранения, предварительно созданный NER и пользовательский NER. Вывод из эксплуатации 31 марта 2029 г.: анализ тональности и анализ мнений, извлечение ключевых фраз, суммирование, связывание сущностей, CQA и CLU. Краткое руководство по связыванию сущностей(выход из эксплуатации 31 марта 2029 г.)

Быстрый старт по обнаружению языка

Краткое руководство по извлечению ключевых фраз(закрытие 31 марта 2029 г.)

Краткое руководство по обнаружению именованных сущностей (Named Entity Recognition, NER)

Краткое руководство по обнаружению персональной информации (PII)

Краткое руководство по анализу тональности и интеллектуальному анализу мнений(выход на пенсию 31 марта 2029 г.)

Краткое руководство по использованию текста, документа ибеседы (выход на пенсию 31 марта 2029 г.)

Использование Анализ текста для быстрого старта в области здравоохранения

Language SDK для Java (анализ текста)

Пакет Language Maven

Перенесите из Language Studio в Microsoft Foundry для миграции рабочих нагрузок с устаревающими функциями
Значок переводчика Переводчик Используйте технологию перевода на основе ИИ, чтобы перевести более 100 используемых, подверженных риску языков и диалектов. Translator SDK для Java (text)

Пакет Translator Maven (текст)
значок Поиск с использованием ИИ AzureПоиск с использованием ИИ Azure Запустите поиск в облаке, на основе искусственного интеллекта, в мобильные и веб-приложения. Используйте быстрое начало для извлечения агентов

Быстрый старт по поиску векторов

Классический генеративный поиск (RAG) с помощью быстрого старта по опорным данным

Краткое руководство по полнотекстовому поиску

Краткое руководство по семантическому ранжированию

Чат с моделями Azure OpenAI, используя ваши собственные данные (быстрый старт)

• пакет SDK Поиск с использованием ИИ Azure для Java

• пакет Поиск с использованием ИИ Azure Maven
Значок Безопасность содержимого Обнаружение вредного содержимого в приложениях и службах. Краткое руководство по анализу текстового содержимого

Краткое руководство по использованию текстового блок-листа

Быстрый старт по анализу содержимого изображения

SDK Content Safety для Java

Пакет Maven защиты контента
Аналитика документов Аналитика документов Преобразуйте документы в интеллектуальные решения на основе данных. Краткое руководство по интеллектуальному анализу документов

• пакет SDK Document Intelligence для Java

Пакет Maven аналитики документов
Иконка зрения Зрение Анализ содержимого в цифровых изображениях и богатых ресурсах мультимедиа. Краткое руководство по анализу изображений

Краткое руководство по использованию службы распознавания лиц

• пакет SDK Vision для Java

Пакет Vision Maven

Поддерживаемые JavaScript инструменты Foundry

Литейный инструмент Описание Инструкции для начала работы и справочная документация
Значок Речь Добавьте возможность преобразования речи в текст, текста в речь, перевода и распознавания говорящего в приложения. Краткое руководство по распознаванию речи в текстовый формат

Краткое руководство по преобразованию текста в речь

Быстрый старт по переводу речи

SDK для работы с речью на JavaScript

Пакет npm службы "Речь"
Языковой значок Язык Создавайте приложения с возможностями распознавания естественного языка. Поддерживаемые функции: распознавание языка, обнаружение PII, Анализ текста для здравоохранения, предварительно созданный NER и пользовательский NER. Вывод из эксплуатации 31 марта 2029 г.: анализ тональности и анализ мнений, извлечение ключевых фраз, суммирование, связывание сущностей, CQA и CLU. Краткое руководство по связыванию сущностей(выход из эксплуатации 31 марта 2029 г.)

Быстрый старт по обнаружению языка

Краткое руководство по извлечению ключевых фраз(закрытие 31 марта 2029 г.)

Краткое руководство по обнаружению именованных сущностей (Named Entity Recognition, NER)

Краткое руководство по обнаружению персональной информации (PII)

Краткое руководство по анализу тональности и интеллектуальному анализу мнений(выход на пенсию 31 марта 2029 г.)

Краткое руководство по использованию текста, документа ибеседы (выход на пенсию 31 марта 2029 г.)

Использование Анализ текста для быстрого старта в области здравоохранения

Языковой пакет SDK для JavaScript (анализ текста)

Языковой пакет npm

Перенесите из Language Studio в Microsoft Foundry для миграции рабочих нагрузок с устаревающими функциями
Значок переводчика Переводчик Используйте технологию перевода на основе ИИ, чтобы перевести более 100 используемых, подверженных риску языков и диалектов. Пакет SDK переводчика для JavaScript (текст)

Пакет npm переводчика (текст)
значок Поиск с использованием ИИ AzureПоиск с использованием ИИ Azure Запустите поиск в облаке, на основе искусственного интеллекта, в мобильные и веб-приложения. Используйте быстрое начало для извлечения агентов

Быстрый старт по поиску векторов

Классический генеративный поиск (RAG) с помощью быстрого старта по опорным данным

Краткое руководство по полнотекстовому поиску

Краткое руководство по семантическому ранжированию

Чат с моделями Azure OpenAI, используя ваши собственные данные (быстрый старт)

• пакет SDK Поиск с использованием ИИ Azure для JavaScript

• пакет npm Поиск с использованием ИИ Azure npm
Значок Безопасность содержимого Обнаружение вредного содержимого в приложениях и службах. Краткое руководство по анализу текстового содержимого

Краткое руководство по использованию текстового блок-листа

Быстрый старт по анализу содержимого изображения

Пакет npm безопасности содержимого
Аналитика документов Аналитика документов Преобразуйте документы в интеллектуальные решения на основе данных. Краткое руководство по интеллектуальному анализу документов

Пакет SDK аналитики документов для JavaScript

Пакет npm для аналитики документов
Иконка зрения Зрение Анализ содержимого в цифровых изображениях и богатых ресурсах мультимедиа. Azure Vision в Foundry Tools версии 3.2 Общая доступность Краткий старт

Краткое руководство по анализу изображений

Краткое руководство по использованию службы распознавания лиц

Пакет SDK визуального распознавания для JavaScript

Пакет npm для визуального зрения

Средства Foundry, поддерживаемые Python

Литейный инструмент Описание Инструкции для начала работы и справочная документация
Значок Речь Добавьте возможность преобразования речи в текст, текста в речь, перевода и распознавания говорящего в приложения. Краткое руководство по распознаванию речи в текстовый формат

Краткое руководство по преобразованию текста в речь

Быстрый старт по переводу речи

• пакет 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 языка (ответы на вопросы)

• SDK пакет Language для Python (языковые взаимодействия)(вывод из эксплуатации 31 марта 2029 г.)

Языковой пакет PyPi (для разговоров на языке)(вывод из эксплуатации 31 марта 2029 г.)

Перенесите из Language Studio в Microsoft Foundry для миграции рабочих нагрузок с устаревающими функциями
Значок переводчика Переводчик Используйте технологию перевода на основе ИИ, чтобы перевести более 100 используемых, подверженных риску языков и диалектов. SDK Translator для Python (текст)

Пакет PyPi переводчика (текст)

• пакет SDK Translator для Python (пакетная версия)

Пакет PyPi переводчика (пакет)
значок Поиск с использованием ИИ AzureПоиск с использованием ИИ Azure Запустите поиск в облаке, на основе искусственного интеллекта, в мобильные и веб-приложения. Краткое руководство по подключению к службе поиска

Используйте быстрое начало для извлечения агентов

Быстрый старт по поиску векторов

Классический генеративный поиск (RAG) с помощью быстрого старта по опорным данным

Краткое руководство по полнотекстовому поиску

Краткое руководство по семантическому ранжированию

Чат с моделями Azure OpenAI, используя ваши собственные данные (быстрый старт)

• пакет SDK Поиск с использованием ИИ Azure для Python

• пакет pyPi Поиск с использованием ИИ Azure PyPi
Значок Безопасность содержимого Обнаружение вредного содержимого в приложениях и службах. Краткое руководство по анализу текстового содержимого

Краткое руководство по использованию текстового блок-листа

Быстрый старт по анализу содержимого изображения

Python Content Safety SDK

Пакет PyPi безопасности содержимого
Аналитика документов Аналитика документов Преобразуйте документы в интеллектуальные решения на основе данных. Краткое руководство по интеллектуальному анализу документов

• пакет SDK Document Intelligence для Python

Пакет PyPi аналитики документов
Иконка зрения Зрение Анализ содержимого в цифровых изображениях и богатых ресурсах мультимедиа. Azure Vision в Foundry Tools версии 3.2 Общая доступность Краткий старт

Краткое руководство по анализу изображений

Краткое руководство по использованию службы распознавания лиц

• пакет SDK Vision для Python

Пакет PyPi визуального зрения