Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Note
Этот документ относится к порталу Microsoft Foundry (классическая модель).
Note
Этот документ относится к порталу Microsoft Foundry (new).
В этой статье описываются компоненты SDK и конечные точки, которые можно использовать с Foundry. В нем показано, как подключиться к проекту, получить доступ к моделям из разных поставщиков и использовать средства Foundry. Пакет SDK предоставляет единый способ работы с ресурсами ИИ через клиентские библиотеки на нескольких языках программирования.
Пакет SDK Для Microsoft Foundry упрощает разработку приложений ИИ в Azure. Это позволяет разработчикам:
- Доступ к моделям из различных поставщиков через один интерфейс
- Объединение моделей, данных и служб ИИ для создания приложений, управляемых ИИ
- Оценка, отладка и повышение качества и безопасности приложений в разработке, тестировании и рабочей среде
Пакет SDK Для Microsoft Foundry интегрируется с другими клиентскими библиотеками и службами, которые работают вместе.
Foundry SDK
Разработчикам, работающим с Microsoft Foundry, необходима гибкость для интеграции нескольких возможностей искусственного интеллекта в унифицированные рабочие процессы. Эти пакеты SDK предоставляют стандартные блоки для подготовки ресурсов, оркестрации агентов и подключения к специализированным службам ИИ. Выбрав нужную библиотеку, вы можете упростить разработку, уменьшить сложность и обеспечить масштабирование решений в проектах Foundry и внешних конечных точках.
Note
Эта статья относится к проекту Foundry. Приведенный здесь код не работает для центрального проекта. Дополнительные сведения см. в разделе "Типы проектов".
Prerequisites
- Учетная запись Azure с активной подпиской. Если у вас его нет, создайте бесплатную учетную запись Azure, которая включает бесплатную пробную подписку.
- Создайте проект Foundry , если у вас еще нет.
- Microsoft Foundry Models позволяет клиентам использовать самые мощные модели от флагманных поставщиков моделей с помощью одной конечной точки и учетных данных. Это означает, что можно переключаться между моделями и использовать их из приложения, не изменяя одну строку кода.Скопируйте конечную точку проекта Foundry в разделе «Обзор» вашего проекта. Вы будете использовать его через некоторое время.
Tip
Если вы не видите конечную точку проекта Foundry, значит, вы используете проект на основе узлов. (См. типы проектов). Перейдите в проект Foundry или выполните описанные выше действия, чтобы создать проект.
- Выберите "Главная" в правом верхнем углу навигации.
- Выберите ключи и скопируйте конечную точку. Вы будете использовать его через некоторое время.
- Скопируйте конечную точку с экрана приветствия. Вы будете использовать его на следующем шаге.
Войдите с помощью Azure CLI, используя ту же учетную запись, которую вы используете для доступа к проекту:
az login
В следующих примерах показано, как выполнить проверку подлинности и создать клиент для конечной точки проекта.
Tip
Эти примеры кода являются начальными точками. Используйте эти клиенты для взаимодействия с моделями, выполнения вычислений и многого другого, как описано в разделе клиентских библиотек.
Клиентская библиотека Azure AI Projects для Python — это единая библиотека, которая позволяет использовать несколько клиентских библиотек вместе, подключаясь к одной конечной точке проекта.
Установка клиентской библиотеки проекта
pip install azure-ai-projects azure-identity openaipip 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.
Клиентская библиотека Проектов ИИ Azure для Java (предварительная версия) — это единая библиотека, которая позволяет совместно использовать несколько клиентских библиотек, подключаясь к одной конечной точке проекта.
Important
Элементы, обозначенные в этой статье как (предварительная версия), сейчас предлагаются в общедоступной предварительной версии. Эта предварительная версия предоставляется без соглашения об уровне обслуживания, и мы не рекомендуем ее для рабочих нагрузок. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены. Для получения дополнительной информации см. Дополнительные условия использования для предварительных версий Microsoft Azure.
Добавьте эти пакеты в установку:
com.azure.ai.projectscom.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.
Клиентская библиотека Azure AI Projects для JavaScript — это единая библиотека, которая позволяет использовать несколько клиентских библиотек вместе, подключаясь к одной конечной точке проекта.
Установка зависимостей (предварительная версия):
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.
Клиентская библиотека Проектов ИИ Azure для .NET — это единая библиотека, которая позволяет использовать несколько клиентских библиотек вместе, подключаясь к одной конечной точке проекта.
Установка пакетов:
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.
OpenAI SDK
Пакет SDK OpenAI позволяет взаимодействовать со службой Azure OpenAI. Он предлагает простой интерфейс для вызова API и управления проверкой подлинности. Пакет SDK OpenAI напрямую вызывает конечную точку Azure OpenAI. В следующем фрагменте кода показано, как создать клиент OpenAI из клиента Project для правильного управления области и контекста.
Какую конечную точку следует использовать?
- Управление проектом или вызовом агентов версии 2? Используйте конечную точку проекта Foundry с пакетом SDK для Foundry. Получите клиент OpenAI из проекта с помощью Microsoft Entra ID для аутентификации.
- Вызов модели напрямую? Используйте конечную точку Azure OpenAI с пакетом SDK OpenAI с идентификатором Microsoft Entra в качестве предпочтительного метода проверки подлинности. При использовании ключей API выберите конечную точку версии 1:
https://<YOUR-RESOURCE-NAME>.openai.azure.com/openai/v1/
Создание клиента OpenAI из проекта
# Use the AIProjectClient to create an OpenAI client for your project
openai_client = project.get_openai_client(api_version="api_version")
response = openai_client.responses.create(
model="gpt-4.1-mini",
input="What is the size of France in square miles?",
)
print(f"Response output: {response.output_text}")
В следующем фрагменте кода показано, как использовать конечную точку Azure OpenAI версии 1 с клиентом OpenAI для ответов.
from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
token_provider = get_bearer_token_provider(
DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default"
)
client = OpenAI(
base_url = "https://<YOUR-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))
Дополнительные сведения об использовании пакета SDK OpenAI см. в поддерживаемых Azure OpenAI языках программирования.
# Use the AIProjectClient to create an OpenAI client for your project
openai_client = project.get_openai_client()
response = openai_client.responses.create(
model="gpt-4.1-mini",
input="What is the size of France in square miles?",
)
print(f"Response output: {response.output_text}")
В следующем фрагменте кода показано, как использовать конечную точку Azure OpenAI версии 1 с клиентом OpenAI для ответов.
from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
token_provider = get_bearer_token_provider(
DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default"
)
client = OpenAI(
base_url = "https://<YOUR-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))
Дополнительные сведения об использовании пакета SDK OpenAI смотрите в разделе поддерживаемые языки программирования Azure OpenAI.
Important
Элементы, обозначенные в этой статье как (предварительная версия), сейчас предлагаются в общедоступной предварительной версии. Эта предварительная версия предоставляется без соглашения об уровне обслуживания, и мы не рекомендуем ее для рабочих нагрузок. Некоторые функции могут не поддерживаться или их возможности могут быть ограничены. Для получения дополнительной информации см. Дополнительные условия использования для предварительных версий Microsoft Azure.
//
OpenAIClient openAIClient = projectClient.getOpenAIClient();
Дополнительные сведения об использовании пакета SDK OpenAI см. в поддерживаемых Azure OpenAI языках программирования.
Дополнительные сведения об использовании пакета SDK OpenAI смотрите в разделе поддерживаемые языки программирования Azure OpenAI.
// Use the AIProjectClient to create an OpenAI client for your project
const openAIClient = await project.getOpenAIClient();
Дополнительные сведения об использовании пакета SDK OpenAI см. в поддерживаемых Azure OpenAI языках программирования.
Дополнительные сведения об использовании пакета SDK OpenAI смотрите в разделе поддерживаемые языки программирования Azure OpenAI.
Установите пакет OpenAI:
dotnet add package OpenAIВ следующем фрагменте кода показано, как создать клиент OpenAI непосредственно с помощью конечной точки Azure OpenAI версии 1.
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.
Дополнительные сведения об использовании пакета SDK OpenAI см. в поддерживаемых Azure OpenAI языках программирования.
Дополнительные сведения об использовании пакета SDK OpenAI смотрите в разделе поддерживаемые языки программирования Azure OpenAI.
После создания клиента используйте его для доступа к моделям, выполнению вычислений и подключению к другим службам ИИ.
- Используя конечную точку проекта, можно:
- Использование моделей Foundry, включая Azure OpenAI
- Использование службы агента Foundry
- Выполнение вычислений в облаке
- Включение трассировки для приложения
- Тонкая настройка модели
- Получение конечных точек и ключей для подключений к внешним ресурсам, таких как средства Foundry, локальная оркестрация и многое другое.
В следующем разделе перечислены клиентские библиотеки Средств Foundry и показано, как их использовать.
Инструментальные пакеты SDK для платформы Foundry
Чтобы использовать средства Foundry, можно использовать следующие пакеты SDK с перечисленными конечными точками.
Какую конечную точку следует использовать?
Выберите конечную точку в зависимости от ваших потребностей:
Используйте интерфейс средств Foundry для доступа к инструментам компьютерного зрения, защиты контента, интеллектуальному анализу документов, языка, перевода и инструментария токенов.
Конечная точка средств Foundry: https://<YOUR-RESOURCE-NAME>.services.ai.azure.com/
Для средств распознавания речи и перевода используйте конечные точки в следующих таблицах. Замените заполнители сведениями о ресурсе.
Конечные точки службы "Речь"
| Инструмент Foundry | Endpoint |
|---|---|
| Речь к тексту (стандартная версия) | https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com |
| Преобразование текста в речь (нейронное) | https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com |
| Custom Voice | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Конечные точки перевода
| Инструмент Foundry | Endpoint |
|---|---|
| Перевод текста | https://api.cognitive.microsofttranslator.com/ |
| Перевод документов | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
В следующих разделах содержатся ссылки на краткое руководство по пакетам SDK для средств Foundry и справочные сведения.
Средства Foundry, поддерживаемые C#
Инструменты Foundry, поддерживаемые Java
Инструменты Foundry с поддержкой JavaScript
Поддерживаемые инструменты Foundry для Python
Использование Agent Framework для локальной оркестрации
Microsoft Agent Framework — это пакет средств разработки с открытым кодом для создания агентов ИИ и рабочих процессов с несколькими агентами для .NET и Python. Он предоставляет способ создания агентов ИИ и управления ими, которые могут взаимодействовать с пользователями и другими службами. Он может координировать агентов в Foundry или использовать локальных агентов, которые применяют модели Foundry.
Дополнительные сведения см. в обзоре Microsoft Agent Framework