SDKs e Endpoints do Microsoft Foundry

• Runtime da linguagem instalado:
  • Python: python --version (≥3.8)

• Runtime da linguagem instalado:
  • Node.js: node --version (≥18)

• Ambiente de execução da linguagem instalado
  • .NET: dotnet --version (≥6.0)

• Tempo de execução da linguagem instalado.
  • Java: java --version (≥11)

A biblioteca cliente Azure AI Projects para Python é uma biblioteca unificada que permite usar múltiplas bibliotecas clientes em conjunto, ligando-as a um único endpoint de projeto.

Execute este comando para instalar os pacotes para projetos Foundry.

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

A biblioteca cliente Azure AI Projects para Java é uma biblioteca unificada que permite usar múltiplas bibliotecas clientes em conjunto ligando-se a um único endpoint de projeto.

Adicione estes pacotes à sua instalação para projetos da 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;

A biblioteca cliente Azure AI Projects para JavaScript é uma biblioteca unificada que permite usar múltiplas bibliotecas clientes em conjunto ao ligar-se a um único endpoint de projeto.

Execute este comando para instalar os pacotes JavaScript dos projetos Foundry.

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

A biblioteca cliente Azure AI Projects para .NET é uma biblioteca unificada que permite usar múltiplas bibliotecas clientes em conjunto ligando-as a um único endpoint de projeto.

Execute estes comandos para adicionar os pacotes necessários ao seu projeto .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

Crie um cliente de projeto:

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

Crie um cliente compatível com OpenAI a partir do seu projeto:

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}")

Produção esperada:

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

Crie um cliente de projeto:

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

Crie um cliente de projeto:

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

Crie um cliente compatível com OpenAI a partir do seu projeto:

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}`);

Crie um cliente de projeto:

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

Crie um cliente compatível com OpenAI a partir do seu projeto:

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

Produção esperada:

{
  "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)."
}

Para mais informações, consulte Azure Linguagens de programação suportadas pela OpenAI

O excerto seguinte mostra como usar diretamente o endpoint 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());

Para mais informações sobre a utilização do SDK OpenAI, consulte Azure Linguagens de programação suportadas pela 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}`);

Para mais informações sobre a utilização do SDK OpenAI, consulte Azure Linguagens de programação suportadas pela OpenAI

1. Instale o pacote OpenAI: Execute este comando para adicionar a biblioteca cliente OpenAI ao seu projeto .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
   

Para mais informações sobre a utilização do SDK OpenAI, consulte Azure Linguagens de programação suportadas pela OpenAI

Ferramentas de Fundição suportadas por C#

Ferramenta de Fundição	Descrição	Inicios rápidos e documentação de referência
Discurso	Adicionar capacidades de voz para texto, texto para voz, tradução e reconhecimento de altifalantes às aplicações.	• Início rápido de voz para texto • Início rápido de texto para fala • Início rápido de tradução de fala • SDK de Fala para .NET • Pacote NuGet Speech (Speech CLI)
Língua	Constrói aplicações com capacidades de compreensão de linguagem natural. Funcionalidades suportadas: Deteção de Linguagem, Deteção de PII, Análise de Texto for Health, NER pré-construído e NER personalizado. Descontinuação a 31 de março de 2029: Análise de Sentimento e Mineração de Opinião, Extração de Frases-Chave, Sumarização, Ligação de Entidades, CQA e CLU.	• Início rápido de perguntas e respostas personalizadas (CQA)(reforma a 31 de março de 2029) • Guia rápido para ligação de entidades(descontinuação a 31 de março de 2029) • Início rápido de deteção de língua • Início rápido de extração de frases-chave(retirada a 31 de março de 2029) • Deteção de entidades nomeadas (NER) início rápido • Guia rápido para Detetar Informação Pessoalmente Identificável (PII) • Introdução à análise de sentimento e à mineração de opinião(retirada a 31 de março de 2029) • Utilizar a funcionalidade de resumo de texto, documento e conversa início rápido(desativação em 31 de março de 2029) • Usar o Análise de Texto para um início rápido em saúde • SDK Language para .NET (análise de texto) • Pacote NuGet Language (análise de texto) • SDK de Linguagem para .NET (Sistema de Perguntas e Respostas) • Pacote NuGet de Language (perguntas e respostas) • Migrar do Language Studio para Microsoft Foundry para orientação sobre a migração de cargas de trabalho com funcionalidades a serem retiradas
Tradutor	Utilize tecnologia de tradução alimentada por IA para traduzir mais de 100 línguas e dialetos em uso, em risco e em perigo.	• Tradutor SDK para .NET (texto) • Pacote NuGet do Tradutor (texto) • SDK de tradução para .NET (lote) • Pacote NuGet do Tradutor (em lote)
Pesquisa de IA do Azure	Traga a pesquisa na nuvem alimentada por IA para as suas aplicações móveis e web.	• Utilizar quickstart de recuperação agentica • Início rápido de pesquisa vetorial • Pesquisa generativa clássica (RAG) usando dados de base início rápido • Início rápido de pesquisa em texto completo • Início rápido de classificação semântica • Chat com Azure modelos OpenAI usando os seus próprios dados quickstart • SDK Pesquisa de IA do Azure para .NET • Pacote Pesquisa de IA do Azure NuGet
	Detetar conteúdos prejudiciais em aplicações e serviços.	• Analisar o conteúdo do texto quickstart • Usar uma lista de bloqueio de texto Quickstart • Analisar o conteúdo das imagens: Guia rápido • SDK Segurança de Conteúdo para .NET • Pacote NuGet de Segurança de Conteúdo
Inteligência de Documentos	Transforme documentos em soluções inteligentes orientadas por dados.	• Início Rápido da Inteligência Documental • Document Intelligence SDK para .NET • Pacote NuGet Document Intelligence
Visão	Análise de conteúdo em imagens digitais e ativos multimédia ricos.	• Azure Vision no Foundry Tools v3.2 GA Início rápido • Início rápido de Análise de Imagem • Usar o serviço Face Quickstart • SDK Vision para .NET • Pacote NuGet Vision

Java suportava ferramentas Foundry

Ferramenta de Fundição	Descrição	Inicios rápidos e documentação de referência
Discurso	Adicionar capacidades de voz para texto, texto para voz, tradução e reconhecimento de altifalantes às aplicações.	• Início rápido de voz para texto • Início rápido de texto para fala • Início rápido de tradução de fala • SDK de Speech para Java • Speech Maven package
Língua	Constrói aplicações com capacidades de compreensão de linguagem natural. Funcionalidades suportadas: Deteção de Linguagem, Deteção de PII, Análise de Texto for Health, NER pré-construído e NER personalizado. Descontinuação a 31 de março de 2029: Análise de Sentimento e Mineração de Opinião, Extração de Frases-Chave, Sumarização, Ligação de Entidades, CQA e CLU.	• Guia rápido para ligação de entidades(descontinuação a 31 de março de 2029) • Início rápido de deteção de língua • Início rápido de extração de frases-chave(retirada a 31 de março de 2029) • Deteção de entidades nomeadas (NER) início rápido • Guia rápido para Detetar Informação Pessoalmente Identificável (PII) • Introdução à análise de sentimento e à mineração de opinião(retirada a 31 de março de 2029) • Utilizar a funcionalidade de resumo de texto, documento e conversa início rápido(desativação em 31 de março de 2029) • Usar o Análise de Texto para um início rápido em saúde • SDK Language para Java (análise de texto) • Pacote Language Maven • Migrar do Language Studio para Microsoft Foundry para orientação sobre a migração de cargas de trabalho com funcionalidades a serem retiradas
Tradutor	Utilize tecnologia de tradução alimentada por IA para traduzir mais de 100 línguas e dialetos em uso, em risco e em perigo.	• SDK Tradutor para Java (texto) • Translator Maven Package (texto)
Pesquisa de IA do Azure	Traga a pesquisa na nuvem alimentada por IA para as suas aplicações móveis e web.	• Utilizar quickstart de recuperação agentica • Início rápido de pesquisa vetorial • Pesquisa generativa clássica (RAG) usando dados de base início rápido • Início rápido de pesquisa em texto completo • Início rápido de classificação semântica • Chat com Azure modelos OpenAI usando os seus próprios dados quickstart • SDK Pesquisa de IA do Azure para Java • Pacote Pesquisa de IA do Azure Maven
	Detetar conteúdos prejudiciais em aplicações e serviços.	• Analisar o conteúdo do texto quickstart • Usar uma lista de bloqueio de texto Quickstart • Analisar o conteúdo das imagens: Guia rápido • SDK Content Safety para Java • Pacote Maven de Segurança de Conteúdo
Inteligência de Documentos	Transforme documentos em soluções inteligentes orientadas por dados.	• Início Rápido da Inteligência Documental • SDK Document Intelligence para Java • Pacote Document Intelligence Maven
Visão	Análise de conteúdo em imagens digitais e ativos multimédia ricos.	• Início rápido de Análise de Imagem • Usar o serviço Face Quickstart • SDK Vision para Java • Pacote Vision Maven

JavaScript suportava ferramentas Foundry

Ferramenta de Fundição	Descrição	Inicios rápidos e documentação de referência
Discurso	Adicionar capacidades de voz para texto, texto para voz, tradução e reconhecimento de altifalantes às aplicações.	• Início rápido de voz para texto • Início rápido de texto para fala • Início rápido de tradução de fala • SDK de fala para JavaScript • Pacote npm de fala
Língua	Constrói aplicações com capacidades de compreensão de linguagem natural. Funcionalidades suportadas: Deteção de Linguagem, Deteção de PII, Análise de Texto for Health, NER pré-construído e NER personalizado. Descontinuação a 31 de março de 2029: Análise de Sentimento e Mineração de Opinião, Extração de Frases-Chave, Sumarização, Ligação de Entidades, CQA e CLU.	• Guia rápido para ligação de entidades(descontinuação a 31 de março de 2029) • Início rápido de deteção de língua • Início rápido de extração de frases-chave(retirada a 31 de março de 2029) • Deteção de entidades nomeadas (NER) início rápido • Guia rápido para Detetar Informação Pessoalmente Identificável (PII) • Introdução à análise de sentimento e à mineração de opinião(retirada a 31 de março de 2029) • Utilizar a funcionalidade de resumo de texto, documento e conversa início rápido(desativação em 31 de março de 2029) • Usar o Análise de Texto para um início rápido em saúde • SDK de linguagem para JavaScript (análise de texto) • Pacote npm de linguagem • Migrar do Language Studio para Microsoft Foundry para orientação sobre a migração de cargas de trabalho com funcionalidades a serem retiradas
Tradutor	Utilize tecnologia de tradução alimentada por IA para traduzir mais de 100 línguas e dialetos em uso, em risco e em perigo.	• SDK de tradutor para JavaScript (texto) • Pacote npm Translator (texto)
Pesquisa de IA do Azure	Traga a pesquisa na nuvem alimentada por IA para as suas aplicações móveis e web.	• Utilizar quickstart de recuperação agentica • Início rápido de pesquisa vetorial • Pesquisa generativa clássica (RAG) usando dados de base início rápido • Início rápido de pesquisa em texto completo • Início rápido de classificação semântica • Chat com Azure modelos OpenAI usando os seus próprios dados quickstart • SDK Pesquisa de IA do Azure para JavaScript • Pacote Pesquisa de IA do Azure npm
	Detetar conteúdos prejudiciais em aplicações e serviços.	• Analisar o conteúdo do texto quickstart • Usar uma lista de bloqueio de texto Quickstart • Analisar o conteúdo das imagens: Guia rápido • Pacote npm de Segurança de Conteúdo
Inteligência de Documentos	Transforme documentos em soluções inteligentes orientadas por dados.	• Início Rápido da Inteligência Documental • SDK de Inteligência de Documentos para JavaScript • Pacote npm de Inteligência Documental
Visão	Análise de conteúdo em imagens digitais e ativos multimédia ricos.	• Azure Vision no Foundry Tools v3.2 GA Início rápido • Início rápido de Análise de Imagem • Usar o serviço Face Quickstart • Vision SDK para JavaScript • Pacote Vision NPM

Ferramentas Foundry suportadas por Python

Ferramenta de Fundição	Descrição	Inicios rápidos e documentação de referência
Discurso	Adicionar capacidades de voz para texto, texto para voz, tradução e reconhecimento de altifalantes às aplicações.	• Início rápido de voz para texto • Início rápido de síntese de voz • Início rápido de tradução de fala • SDK de Speech para Python • Pacote PyPi de fala
Língua	Constrói aplicações com capacidades de compreensão de linguagem natural. Funcionalidades suportadas: Deteção de Linguagem, Deteção de PII, Análise de Texto for Health, NER pré-construído e NER personalizado. Descontinuação a 31 de março de 2029: Análise de Sentimento e Mineração de Opinião, Extração de Frases-Chave, Resumo, Vinculação de Entidades, AQA e CLU.	• Início rápido para resposta personalizada a perguntas (CQA)(reforma a 31 de março de 2029) • Guia rápido de ligação de entidades(retirado a 31 de março de 2029) • Início rápido de deteção de idioma • Início rápido de extração de frases-chave(retirada a 31 de março de 2029) • Início rápido de detetar entidades nomeadas (NER) • Guia de Início Rápido para Detetar Informação Pessoalmente Identificável (PII) • Análise de sentimento e início rápido de mineração de opinião(retirada a 31 de março de 2029) • Utilização de resumo de texto, documento e conversa no guia rápido de início(a ser descontinuado a 31 de março de 2029) • Usar Análise de Texto para início rápido na saúde • Language SDK para Python (análise de texto) • Pacote PyPi de linguagem (análise de texto) • Language SDK para Python (resposta a perguntas) • Language PyPi package (respostas a perguntas) • Language SDK para Python (conversas de linguagem)(descontinuação a 31 de março de 2029) • Pacote Language PyPi (conversações linguísticas)(descontinuação a 31 de março de 2029) • Migrar do Language Studio para Microsoft Foundry para orientação sobre a migração de cargas de trabalho com funcionalidades a serem retiradas
Tradutor	Utilize tecnologia de tradução alimentada por IA para traduzir mais de 100 línguas e dialetos em uso, em risco e em perigo.	• SDK de tradução para Python (texto) • Pacote PyPi do Tradutor (texto) • SDK Tradutor para Python (lote) • Pacote de tradução PyPi (em lote)
Pesquisa de IA do Azure	Traga a pesquisa na nuvem alimentada por IA para as suas aplicações móveis e web.	• Liga-te a um serviço de pesquisa rápida • Utilizar quickstart de recuperação agentica • Início rápido de pesquisa vetorial • Pesquisa generativa clássica (RAG) usando dados de base início rápido • Início rápido de pesquisa em texto completo • Início rápido de classificação semântica • Chat com Azure modelos OpenAI usando os seus próprios dados quickstart • SDK Pesquisa de IA do Azure para Python • Pacote PyPi Pesquisa de IA do Azure
	Detetar conteúdos prejudiciais em aplicações e serviços.	• Analisar o conteúdo do texto quickstart • Usar uma lista de bloqueio de texto Quickstart • Analisar o conteúdo das imagens: Guia rápido • Content Safety SDK para Python • Pacote PyPi de Segurança de Conteúdos
Inteligência de Documentos	Transforme documentos em soluções inteligentes orientadas por dados.	• Início Rápido da Inteligência Documental • SDK Document Intelligence para Python • Pacote PyPi de Inteligência de Documentos
Visão	Análise de conteúdo em imagens digitais e ativos multimédia ricos.	• Azure Vision no Foundry Tools v3.2 GA Início rápido • Início rápido de Análise de Imagem • Usar o serviço Face Quickstart • SDK Vision para Python • Pacote Vision PyPi