SDKs e Endpoints do Microsoft Foundry (clássico)

• Ambiente de execução da linguagem instalado:
  • Python: python --version (≥3.8)

• Ambiente de execução da linguagem instalado:
  • Node.js: node --version (≥18)

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

• Ambiente 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 1.x para projetos clássicos do Foundry.

pip install openai azure-identity azure-ai-projects==1.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.

Adiciona estas dependências aos teus projetos clássicos do Maven pom.xml for Foundry.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-ai-inference</artifactId>
    <version>1.0.0-beta.6</version>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.18.2</version>
</dependency>

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 1.x para projetos clássicos do Foundry.

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

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 1.x do Azure AI SDK para projetos clássicos do Foundry.

# Add 1.x Azure AI SDK packages
dotnet add package Azure.Identity
dotnet add package Azure.AI.Projects --version 1.1.0
dotnet add package Azure.AI.Agents.Persistent --version 1.1.0
dotnet add package Azure.AI.Inference

Crie um cliente de projeto:

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

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:

models = project_client.get_openai_client(api_version="2024-10-21")
chat_responses = models.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "What is the size of France in square miles?"},
    ],
)

print(chat_responses.choices[0].message.content)

Crie um cliente de projeto:

package com.azure.ai.foundry.samples;

import com.azure.ai.inference.ChatCompletionsClient;
import com.azure.ai.inference.ChatCompletionsClientBuilder;
import com.azure.ai.inference.models.ChatCompletions;
import com.azure.core.credential.AzureKeyCredential;
import com.azure.core.credential.TokenCredential;
import com.azure.core.exception.HttpResponseException;
import com.azure.core.util.logging.ClientLogger;
import com.azure.identity.DefaultAzureCredentialBuilder;

String  prompt = "What best practices should I follow when asking an AI model to review Java code?";
String endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
TokenCredential credential = new DefaultAzureCredentialBuilder().build();
ChatCompletionsClient client = new ChatCompletionsClientBuilder()
    .credential(credential)
    .endpoint(endpoint)
    .buildClient();
```**Create and use an OpenAI-compatible client from your project:**
```java
ChatCompletions completions = client.complete(prompt);
String content = completions.getChoice().getMessage().getContent();
System.out.println("\nResponse from AI assistant:\n" + content);

Crie um cliente de projeto:

const endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const deployment = "gpt-4o";

const project = new AIProjectClient(endpoint, new DefaultAzureCredential());

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

const client = await project.getAzureOpenAIClient({
    // The API version should match the version of the Azure OpenAI resource
    apiVersion: "2024-12-01-preview"
});
const chatCompletion = await client.chat.completions.create({
    model: deployment,
    messages: [
        { role: "system", content: "You are a helpful assistant" },
        { role: "user", content: "What is the speed of light?" },
    ],
});

console.log(chatCompletion.choices[0].message.content);

Crie um cliente de projeto:

using System.ClientModel.Primitives;
using Azure.AI.OpenAI;
using Azure.AI.Projects;
using Azure.Identity;
using OpenAI.Chat;

string endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
AIProjectClient projectClient = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential());

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

ClientConnection connection = projectClient.GetConnection(typeof(AzureOpenAIClient).FullName!);
if (!connection.TryGetLocatorAsUri(out Uri uri) || uri is null)
{
    throw new InvalidOperationException("Invalid URI.");
}
uri = new Uri($"https://{uri.Host}");
const string modelDeploymentName = "gpt-4o";  
AzureOpenAIClient azureOpenAIClient = new AzureOpenAIClient(uri, new DefaultAzureCredential());
ChatClient chatClient = azureOpenAIClient.GetChatClient(deploymentName: modelDeploymentName);

Console.WriteLine("Complete a chat");
ChatCompletion result = chatClient.CompleteChat("List all the rainbow colors");
Console.WriteLine(result.Content[0].Text);

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

Para mais informações, consulte Azure Linguagens de programação suportadas pela OpenAI. 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.ai.openai.OpenAIClient;
import com.azure.ai.openai.OpenAIClientBuilder;
import com.azure.ai.openai.models.ChatChoice;
import com.azure.ai.openai.models.ChatCompletions;
import com.azure.ai.openai.models.ChatCompletionsOptions;
import com.azure.ai.openai.models.ChatRequestAssistantMessage;
import com.azure.ai.openai.models.ChatRequestMessage;
import com.azure.ai.openai.models.ChatRequestSystemMessage;
import com.azure.ai.openai.models.ChatRequestUserMessage;
import com.azure.ai.openai.models.ChatResponseMessage;
import com.azure.core.credential.AzureKeyCredential;
import com.azure.core.util.Configuration;

import java.util.ArrayList;
import java.util.List;

String endpoint = "https://<resource-name>.openai.azure.com/openai/v1";
String deploymentName = "gpt-5.2";
TokenCredential defaultCredential = new DefaultAzureCredentialBuilder().build();
OpenAIClient client = new OpenAIClientBuilder()
    .credential(defaultCredential)
    .endpoint("{endpoint}")
    .buildClient();

List<ChatRequestMessage> chatMessages = new ArrayList<>();
chatMessages.add(new ChatRequestSystemMessage("You are a helpful assistant."));
chatMessages.add(new ChatRequestUserMessage("What is the speed of light?"));

ChatCompletions chatCompletions = client.getChatCompletions(deploymentName, new ChatCompletionsOptions(chatMessages));

System.out.printf("Model ID=%s is created at %s.%n", chatCompletions.getId(), chatCompletions.getCreatedAt());
for (ChatChoice choice : chatCompletions.getChoices()) {
    ChatResponseMessage message = choice.getMessage();
    System.out.printf("Index: %d, Chat Role: %s.%n", choice.getIndex(), message.getRole());
    System.out.println("Message:");
    System.out.println(message.getContent());

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

import { AzureOpenAI } from "openai";
import { DefaultAzureCredential, getBearerTokenProvider } from "@azure/identity";

const deployment = "gpt-4o";
const endpoint = "https://<resource-name>.openai.azure.com";
const scope = "https://ai.azure.com/.default";
const apiVersion = "2024-04-01-preview";

const azureADTokenProvider = getBearerTokenProvider(new DefaultAzureCredential(), scope);

const options = { azureADTokenProvider, deployment, apiVersion, endpoint };

const client = new AzureOpenAI(options);

const result = await client.chat.completions.create({
    model: deployment,
    messages: [
        { role: "system", content: "You are a helpful assistant" },
        { role: "user", content: "What is the speed of light?" },
    ],
});
console.log(result.choices[0].message.content);

Para mais informações sobre a utilização do SDK OpenAI, consulte Azure Linguagens de programação suportadas por 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 `ChatClient` for the Azure OpenAI v1 endpoint.
   ```csharp
   using System.ClientModel.Primitives;
   using Azure.Identity;
   using OpenAI;
   using OpenAI.Chat;
   
   #pragma warning disable OPENAI001
   
   const string directModelEndpoint  = "https://<resource-name>.openai.azure.com/openai/v1/";
   const string modelDeploymentName = "gpt-5.2";    
   
   BearerTokenPolicy tokenPolicy = new(
        new DefaultAzureCredential(),
        "https://ai.azure.com/.default");
   OpenAIClient openAIClient = new(
        authenticationPolicy: tokenPolicy,
        options: new OpenAIClientOptions()
        {
            Endpoint = new($"{directModelEndpoint}"),
        });
   ChatClient chatClient = openAIClient.GetChatClient(modelDeploymentName);
   
   ChatCompletion completion = await chatClient.CompleteChatAsync(
        [
            new SystemChatMessage("You are a helpful assistant."),
                        new UserChatMessage("How many feet are in a mile?")
        ]);
   
   Console.WriteLine(completion.Content[0].Text);
   #pragma warning restore OPENAI001
   

Para mais informações sobre a utilização do SDK OpenAI, consulte Azure Linguagens de programação suportadas por 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 Speech 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. Reforma em 31 de março de 2029: Análise de Sentimento e Mineração de Opinião, Extração de Frases-Chave, Resumo, Ligação de Entidades, AQA e CLU.	• Início rápido de resposta a perguntas personalizadas (CQA)(descontinuação a 31 de março de 2029) • Início rápido de ligação de entidades(retirada 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) • Deteção de entidades nomeadas (NER) início rápido • Detetar Informação Pessoalmente Identificável (PII) - Início Rápido • Análise de sentimento e início rápido de mineração de opinião(desativação a 31 de março de 2029) • Utilização de início rápido de resumo de texto, documento e conversa(desativação a 31 de março de 2029) • Usar Análise de Texto para início rápido de saúde • SDK de Linguagem para .NET (análise de texto) • Pacote NuGet Language (análise de texto) • SDK de Language para .NET (Resposta a Perguntas) • Pacote NuGet Language (resposta a perguntas) • 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 do Tradutor NuGet (texto) • SDK do Tradutor para .NET (lote) • Tradutor pacote NuGet (batch)
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 fundamentação no início rápido • Início rápido de pesquisa em texto completo • Início rápido de classificação semântica • Chat com modelos OpenAI do Azure utilizando os seus próprios dados início rápido • SDK Pesquisa de IA do Azure para .NET • Pacote NuGet 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 de início rápido • Guia rápido para analisar o conteúdo das imagens • 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.	• Guia de início rápido de Inteligência Documental • SDK Document Intelligence para .NET • Pacote Document Intelligence NuGet
Visão	Analisar conteúdos em imagens digitais e ativos multimédia ricos.	• Azure Vision no Foundry Tools v3.2 GA Guia de início rápido • Início rápido de Análise de Imagem • Utilizar o início rápido do serviço Face • 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 Fala para Java • Pacote Speech Maven
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. Reforma em 31 de março de 2029: Análise de Sentimento e Mineração de Opinião, Extração de Frases-Chave, Resumo, Ligação de Entidades, AQA e CLU.	• Início rápido de ligação de entidades(retirada 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) • Deteção de entidades nomeadas (NER) início rápido • Detetar Informação Pessoalmente Identificável (PII) - Início Rápido • Análise de sentimento e início rápido de mineração de opinião(desativação a 31 de março de 2029) • Utilização de início rápido de resumo de texto, documento e conversa(desativação a 31 de março de 2029) • Usar Análise de Texto para início rápido de 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) • O pacote Translator Maven (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 fundamentação no início rápido • Início rápido de pesquisa em texto completo • Início rápido de classificação semântica • Chat com modelos OpenAI do Azure utilizando os seus próprios dados início rápido • 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 de início rápido • Guia rápido para analisar o conteúdo das imagens • SDK de Segurança de Conteúdo para Java • Pacote Content Safety Maven
Inteligência de Documentos	Transforme documentos em soluções inteligentes orientadas por dados.	• Guia de início rápido de Inteligência Documental • Document Intelligence SDK para Java • Pacote Document Intelligence Maven
Visão	Analisar conteúdos em imagens digitais e ativos multimédia ricos.	• Início rápido de Análise de Imagem • Utilizar o início rápido do serviço Face • 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 voz
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. Reforma em 31 de março de 2029: Análise de Sentimento e Mineração de Opinião, Extração de Frases-Chave, Resumo, Ligação de Entidades, AQA e CLU.	• Início rápido de ligação de entidades(retirada 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) • Deteção de entidades nomeadas (NER) início rápido • Detetar Informação Pessoalmente Identificável (PII) - Início Rápido • Análise de sentimento e início rápido de mineração de opinião(desativação a 31 de março de 2029) • Utilização de início rápido de resumo de texto, documento e conversa(desativação a 31 de março de 2029) • Usar Análise de Texto para início rápido de saúde • SDK de linguagem para JavaScript (análise de texto) • Pacote de linguagem npm • 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 de tradução (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 fundamentação no início rápido • Início rápido de pesquisa em texto completo • Início rápido de classificação semântica • Chat com modelos OpenAI do Azure utilizando os seus próprios dados início rápido • Kit de Desenvolvimento de Software 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 de início rápido • Guia rápido para analisar o conteúdo das imagens • Pacote npm de Segurança de Conteúdo
Inteligência de Documentos	Transforme documentos em soluções inteligentes orientadas por dados.	• Guia de início rápido de Inteligência Documental • SDK de Inteligência de Documentos para JavaScript • Pacote npm de Inteligência Documental
Visão	Analisar conteúdos em imagens digitais e ativos multimédia ricos.	• Azure Vision no Foundry Tools v3.2 GA Guia de início rápido • Início rápido de Análise de Imagem • Utilizar o início rápido do serviço Face • Vision SDK para JavaScript • Pacote npm Vision

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 texto para fala • 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. Reforma em 31 de março de 2029: Análise de Sentimento e Mineração de Opinião, Extração de Frases-Chave, Resumo, Ligação de Entidades, AQA e CLU.	• Início rápido de resposta a perguntas personalizadas (CQA)(descontinuação a 31 de março de 2029) • Início rápido de ligação de entidades(retirada 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) • Detetar Informação Pessoalmente Identificável (PII) - Início Rápido • Análise de sentimento e início rápido de mineração de opinião(desativação a 31 de março de 2029) • Utilização de início rápido de resumo de texto, documento e conversa(desativação a 31 de março de 2029) • Usar Análise de Texto para início rápido de 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) • Pacote PyPi Language (perguntas e respostas) • Language SDK para Python (conversações linguísticas)(descontinuação a 31 de março de 2029) • Pacote PyPi de linguagens (conversas sobre linguagens)(desativaçã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) • O Pacote de Tradução PyPi (texto) • SDK de Tradução para Python (em lote) • Pacote do tradutor PyPi (batch)
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 fundamentação no início rápido • Início rápido de pesquisa em texto completo • Início rápido de classificação semântica • Chat com modelos OpenAI do Azure utilizando os seus próprios dados início rápido • Pesquisa de IA do Azure SDK para Python • Pacote PyPi do 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 de início rápido • Guia rápido para analisar o conteúdo das imagens • SDK Content Safety para Python • Pacote PyPi de Segurança de Conteúdos
Inteligência de Documentos	Transforme documentos em soluções inteligentes orientadas por dados.	• Guia de início rápido de Inteligência Documental • SDK Document Intelligence para Python • Pacote PyPi de Inteligência de Documentos
Visão	Analisar conteúdos em imagens digitais e ativos multimédia ricos.	• Azure Vision no Foundry Tools v3.2 GA Guia de início rápido • Início rápido de Análise de Imagem • Utilizar o início rápido do serviço Face • SDK Vision para Python • Pacote Vision PyPi