SDKs e pontos de extremidade do Microsoft Foundry

• Tempo de execução do idioma instalado:
  • Python: python --version (≥3.8)

• Tempo de execução do idioma instalado:
  • Node.js: node --version (≥18)

• Tempo de execução do idioma instalado:
  • .NET: dotnet --version (≥6.0)

• Tempo de execução do idioma instalado:
  • Java: java --version (≥11)

A biblioteca de clientes Azure AI Projects para Python é uma biblioteca unificada que permite que você use várias bibliotecas de cliente juntas conectando-se a um único ponto de extremidade de projeto.

Execute este comando para instalar os pacotes para projetos do Foundry.

pip install azure-ai-projects >=2.0.0

A biblioteca de clientes Azure AI Projects para Java é uma biblioteca unificada que permite que você use várias bibliotecas de cliente juntas conectando-se a um único ponto de extremidade de projeto.

Adicione esses pacotes à sua instalação para projetos do 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 de clientes Azure AI Projects para JavaScript é uma biblioteca unificada que permite que você use várias bibliotecas de cliente juntas conectando-se a um único ponto de extremidade de projeto.

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

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

A biblioteca de clientes Azure AI Projects para .NET é uma biblioteca unificada que permite que você use várias bibliotecas de clientes juntas conectando-se a um único ponto de extremidade de projeto.

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

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

Saída esperada:

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

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

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

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

Saída 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 obter mais informações, consulte linguagens de programação compatíveis com Azure OpenAI

O fragmento de código a seguir mostra como usar o ponto de extremidade Azure OpenAI /openai/v1 diretamente.

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 obter mais informações sobre como usar o SDK do OpenAI, consulte Azure linguagens de programação com suporte do 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 obter mais informações sobre como usar o SDK do OpenAI, consulte Azure linguagens de programação com suporte do OpenAI

1. Instale o pacote OpenAI: execute este comando para adicionar a biblioteca de clientes OpenAI ao seu projeto de .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 obter mais informações sobre como usar o SDK do OpenAI, consulte Azure linguagens de programação com suporte do OpenAI

Ferramentas Foundry compatíveis com C#

Ferramenta de Fundição	DESCRIÇÃO	Guias de início rápido e documentação de referência
Fala	Adicione funcionalidades de conversão de fala em texto, texto em fala, tradução e reconhecimento de locutor aos aplicativos.	• Início rápido de conversão de fala em texto • Início rápido de conversão de texto em fala • Início rápido da tradução de fala • Speech SDK para .NET • Pacote NuGet de Fala (Speech CLI)
Linguagem	Crie aplicativos com recursos de compreensão de linguagem natural. Recursos com suporte: Detecção de Idioma, Detecção de PII, Análise de Texto para a Saúde, NER Predefinido e NER Personalizado. Desativação em 31 de março de 2029: Análise de Sentimento e Mineração de Opiniões, Extração de Frases-chave, Resumo, Vinculação de Entidades, CQA e CLU.	• Início rápido de perguntas e respostas personalizadas (CQA)(desativação prevista para 31 de março de 2029) • Início rápido de vinculação de entidades(desativação em 31 de março de 2029) • Início rápido da detecção de idioma • Início rápido da extração de frases-chave(desativando-se em 31 de março de 2029) • Início rápido para Detecção de entidades nomeadas (NER) • Início rápido para Detectar PII (informações de identificação pessoal) • Início rápido de análise de sentimento e mineração de opinião(desativação em 31 de março de 2029) • Usando o início rápido de resumo de texto, documento e conversa(desativação em 31 de março de 2029) • Using Análise de Texto para início rápido de saúde • Language SDK for .NET (análise de texto) • pacote NuGet de Linguagem (análise de texto) • Language SDK for .NET (Resposta a Perguntas) • pacote NuGet Language (resposta a perguntas) • Migração do Language Studio para o Microsoft Foundry para obter orientações sobre a migração de cargas de trabalho com recursos que estão sendo desativados
Tradutor	Use tecnologia de tradução com tecnologia de IA para traduzir mais de 100 idiomas e dialetos em uso, em risco e ameaçados.	• Translator SDK para .NET (texto) • pacote NuGet Translator (texto) • Translator SDK para .NET (em lote) • pacote NuGet Translator (lote)
ícone Pesquisa de IA do Azure	Insira a pesquisa em nuvem habilitada para IA nos seus aplicativos Web e móveis.	• Início rápido para Usar a recuperação por meio de agentes • Início rápido da pesquisa de vetor • Pesquisa generativa clássica (RAG) usando início rápido de dados de base • Início rápido da pesquisa de texto completo • Início rápido da classificação semântica • Chat com modelos do Azure OpenAI usando seu próprio início rápido com seus dados • SDK Pesquisa de IA do Azure  para .NET • Pacote NuGet do Pesquisa de IA do Azure
Segurança de Conteúdo	Detectar conteúdo prejudicial em aplicativos e serviços.	• Início rápido para Analisar conteúdo do texto • Início rápido para Usar uma lista de bloqueio de texto • Guia de início rápido para análise de conteúdo de imagem • Content Safety SDK para .NET • Content Safety NuGet package
Inteligência de Documentos	Transforme documentos em soluções inteligentes baseadas em dados.	• Início rápido do Document Intelligence • SDK do Document Intelligence para .NET • pacote NuGet Document Intelligence
Visão	Analise o conteúdo em imagens digitais e ativos de mídia avançada.	• Azure Vision in Foundry Tools v3.2 GA Leia o guia de início rápido • Início rápido da Análise de Imagem • Início rápido para Usar o Serviço de Face • Vision SDK para .NET • Pacote NuGet Vision

Ferramentas de Foundry compatíveis com Java

Ferramenta de Fundição	DESCRIÇÃO	Guias de início rápido e documentação de referência
Fala	Adicione funcionalidades de conversão de fala em texto, texto em fala, tradução e reconhecimento de locutor aos aplicativos.	• Início rápido de conversão de fala em texto • Início rápido de conversão de texto em fala • Início rápido da tradução de fala • SDK de Fala para Java • Pacote Maven de Fala
Linguagem	Crie aplicativos com recursos de compreensão de linguagem natural. Recursos com suporte: Detecção de Idioma, Detecção de PII, Análise de Texto para Saúde, NER Predefinido e NER Personalizado. Desativação em 31 de março de 2029: Análise de Sentimento e Mineração de Opiniões, Extração de Frases-chave, Resumo, Vinculação de Entidades, CQA e CLU.	• Início rápido de vinculação de entidade(desativação em 31 de março de 2029) • Início rápido da detecção de idioma • Início rápido da extração de frases-chave(desativando-se em 31 de março de 2029) • Início rápido para Detecção de entidades nomeadas (NER) • Início rápido para Detectar PII (informações de identificação pessoal) • Início rápido de análise de sentimento e mineração de opinião(desativação em 31 de março de 2029) • Usando o início rápido de resumo de texto, documento e conversa(desativação em 31 de março de 2029) • Uso de Análise de Texto para Saúde - Início Rápido • Language SDK for Java (análise de texto) • Pacote Maven de Linguagem • Migração do Language Studio para o Microsoft Foundry para obter diretrizes sobre como migrar cargas de trabalho com recursos que estão sendo desativados.
Tradutor	Use tecnologia de tradução com tecnologia de IA para traduzir mais de 100 idiomas e dialetos em uso, em risco e ameaçados.	• Translator SDK for Java (text) • Pacote Maven do Tradutor (texto)
ícone Pesquisa de IA do Azure	Insira a pesquisa em nuvem habilitada para IA nos seus aplicativos Web e móveis.	• Início rápido para Usar a recuperação por meio de agentes • Início rápido da pesquisa de vetor • Pesquisa generativa clássica (RAG) usando início rápido de dados de base • Início rápido da pesquisa de texto completo • Início rápido da classificação semântica • Conversar com modelos do Azure OpenAI usando seu próprio guia rápido de dados • Pesquisa de IA do Azure  SDK para Java • pacote Maven do Pesquisa de IA do Azure
Segurança de Conteúdo	Detectar conteúdo prejudicial em aplicativos e serviços.	• Início rápido para Analisar conteúdo do texto • Início rápido para Usar uma lista de bloqueio de texto • Guia de início rápido para análise de conteúdo de imagem • Content Safety SDK for Java • Pacote Maven de Segurança de Conteúdo
Inteligência de Documentos	Transforme documentos em soluções inteligentes baseadas em dados.	• Início rápido do Document Intelligence • SDK Document Intelligence para Java • Pacote Maven da Informação de Documentos
Visão	Analise o conteúdo em imagens digitais e ativos de mídia avançada.	• Início rápido da Análise de Imagem • Início rápido para Usar o Serviço de Face • Vision SDK para Java • Pacote do Vision Maven

Ferramentas de Fundição compatíveis com JavaScript

Ferramenta de Fundição	DESCRIÇÃO	Guias de início rápido e documentação de referência
Fala	Adicione funcionalidades de conversão de fala em texto, texto em fala, tradução e reconhecimento de locutor aos aplicativos.	• Início rápido de conversão de fala em texto • Início rápido de conversão de texto em fala • Início rápido da tradução de fala • SDK de Fala para JavaScript • Pacote npm de voz
Linguagem	Crie aplicativos com recursos de compreensão de linguagem natural. Recursos com suporte: Detecção de Idioma, Detecção de PII, Análise de Texto para Integridade, NER Predefinido e NER Personalizado. Desativação em 31 de março de 2029: Análise de Sentimento e Mineração de Opiniões, Extração de Frases-chave, Resumo, Vinculação de Entidade, CQA e CLU.	• Início rápido para vincular entidades(descontinuação em 31 de março de 2029) • Início rápido da detecção de idioma • Início rápido da extração de frases-chave(desativando-se em 31 de março de 2029) • Início rápido para Detecção de entidades nomeadas (NER) • Início rápido para Detectar PII (informações de identificação pessoal) • Início rápido de análise de sentimento e mineração de opinião(desativação em 31 de março de 2029) • Usando o início rápido de resumo de texto, documento e conversa(desativação em 31 de março de 2029) • Uso de Análise de Texto para Saúde - Início Rápido • SDK de linguagem para JavaScript (análise de texto) • Pacote npm da Linguagem • Migração do Language Studio para o Microsoft Foundry para obter diretrizes sobre como migrar cargas de trabalho com recursos que estão sendo desativados.
Tradutor	Use tecnologia de tradução com tecnologia de IA para traduzir mais de 100 idiomas e dialetos em uso, em risco e ameaçados.	• SDK do Tradutor para JavaScript (texto) • Pacote npm de tradutor (texto)
ícone Pesquisa de IA do Azure	Insira a pesquisa em nuvem habilitada para IA nos seus aplicativos Web e móveis.	• Início rápido para Usar a recuperação por meio de agentes • Início rápido da pesquisa de vetor • Pesquisa generativa clássica (RAG) usando início rápido de dados de base • Início rápido da pesquisa de texto completo • Início rápido da classificação semântica • Conversar com modelos do Azure OpenAI usando seu próprio guia rápido de dados • Pesquisa de IA do Azure  SDK para JavaScript • pacote npm Pesquisa de IA do Azure
Segurança de Conteúdo	Detectar conteúdo prejudicial em aplicativos e serviços.	• Início rápido para Analisar conteúdo do texto • Início rápido para Usar uma lista de bloqueio de texto • Guia de início rápido para análise de conteúdo de imagem • Pacote npm de segurança de conteúdo
Inteligência de Documentos	Transforme documentos em soluções inteligentes baseadas em dados.	• Início rápido do Document Intelligence • Document Intelligence SDK para JavaScript • Pacote npm da Informação de Documentos
Visão	Analise o conteúdo em imagens digitais e ativos de mídia avançada.	• Azure Vision in Foundry Tools v3.2 Disponibilidade Geral Leia o guia de início rápido • Início rápido da Análise de Imagem • Início rápido para Usar o Serviço de Face • SDK de Visão para JavaScript • Pacote npm do Visão

Ferramentas de Foundry com suporte para Python

Ferramenta de Fundição	DESCRIÇÃO	Guias de início rápido e documentação de referência
Fala	Adicione funcionalidades de conversão de fala em texto, texto em fala, tradução e reconhecimento de locutor aos aplicativos.	• Início rápido de conversão de fala em texto • Início rápido de conversão de texto em fala • Início rápido da tradução de fala • Speech SDK para Python • Pacote de reconhecimento de fala PyPi
Linguagem	Crie aplicativos com recursos de compreensão de linguagem natural. Recursos com suporte: Detecção de Idioma, Detecção de PII, Análise de Texto para Integridade, NER Predefinido e NER Personalizado. Desativação em 31 de março de 2029: Análise de Sentimento e Mineração de Opiniões, Extração de Frases-chave, Resumo, Vinculação de Entidade, CQA e CLU.	• Início rápido da CQA (resposta a perguntas personalizadas)(desativação em 31 de março de 2029) • Início rápido para vincular entidades(descontinuação em 31 de março de 2029) • Início rápido da detecção de idioma • Início rápido da extração de frases-chave(desativando-se em 31 de março de 2029) • Início rápido para Detecção de entidades nomeadas (NER) • Início rápido para Detectar PII (informações de identificação pessoal) • Início rápido de análise de sentimento e mineração de opinião(desativação em 31 de março de 2029) • Usando o início rápido de resumo de texto, documento e conversa(desativação em 31 de março de 2029) • Uso de Análise de Texto para Saúde - Início Rápido • Language SDK for Python (análise de texto) • Pacote PyPi de linguagem (análise de texto) • Language SDK para Python (resposta à pergunta) • Pacote PyPi de linguagem (resposta a perguntas) • Language SDK for Python (conversações de linguagem)(desativando 31 de março de 2029) • Pacote PyPi de linguagem (interações de linguagem)(descontinuando em 31 de março de 2029) • Migração do Language Studio para o Microsoft Foundry para obter diretrizes sobre como migrar cargas de trabalho com recursos que estão sendo desativados.
Tradutor	Use tecnologia de tradução com tecnologia de IA para traduzir mais de 100 idiomas e dialetos em uso, em risco e ameaçados.	• Translator SDK para Python (texto) • Pacote Tradutor PyPi (texto) • Translator SDK para Python (lote) • Pacote PyPi do Tradutor (lote)
ícone Pesquisa de IA do Azure	Insira a pesquisa em nuvem habilitada para IA nos seus aplicativos Web e móveis.	• Início rápido para Conectar-se a um serviço Pesquisa • Início rápido para Usar a recuperação por meio de agentes • Início rápido da pesquisa de vetor • Pesquisa generativa clássica (RAG) usando início rápido de dados de base • Início rápido da pesquisa de texto completo • Início rápido da classificação semântica • Conversar com modelos do Azure OpenAI usando seu próprio guia rápido de dados • Pesquisa de IA do Azure  SDK para Python • Pesquisa de IA do Azure  pacote PyPi
Segurança de Conteúdo	Detectar conteúdo prejudicial em aplicativos e serviços.	• Início rápido para Analisar conteúdo do texto • Início rápido para Usar uma lista de bloqueio de texto • Guia de início rápido para análise de conteúdo de imagem • Content Safety SDK for Python • Pacote PyPi de Segurança de Conteúdo
Inteligência de Documentos	Transforme documentos em soluções inteligentes baseadas em dados.	• Início rápido do Document Intelligence • Document Intelligence para Python SDK • Pacote PyPi da Informação de Documentos
Visão	Analise o conteúdo em imagens digitais e ativos de mídia avançada.	• Azure Vision in Foundry Tools v3.2 Disponibilidade Geral Leia o guia de início rápido • Início rápido da Análise de Imagem • Início rápido para Usar o Serviço de Face • Vision SDK para Python • Pacote PyPi do Visão