Microsoft Foundry SDK:er och slutpunkter (klassisk)

• Språkkörning installerad:
  • Python: python --version (≥3.8)

• Språkkörning installerad:
  • Node.js: node --version (≥18)

• Språkkörning installerad:
  • .NET: dotnet --version (≥6.0)

• Språkkörning installerad:
  • Java: java --version (≥11)

Klientbiblioteket Azure AI Projects för Python är ett enhetligt bibliotek som gör att du kan använda flera klientbibliotek tillsammans genom att ansluta till en enda projektslutpunkt.

Kör det här kommandot för att installera 1.x-paketen för klassiska Foundry-projekt.

pip install openai azure-identity azure-ai-projects==1.0.0

Klientbiblioteket Azure AI Projects för Java är ett enhetligt bibliotek som gör att du kan använda flera klientbibliotek tillsammans genom att ansluta till en enda projektslutpunkt.

Lägg till dessa beroenden i Maven pom.xml för klassiska Foundry-projekt.

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

Klientbiblioteket Azure AI Projects för JavaScript är ett enhetligt bibliotek som gör att du kan använda flera klientbibliotek tillsammans genom att ansluta till en enda projektslutpunkt.

Kör det här kommandot för att installera 1.x JavaScript-paketen för klassiska Foundry-projekt.

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

Klientbiblioteket Azure AI Projects för .NET är ett enhetligt bibliotek som gör att du kan använda flera klientbibliotek tillsammans genom att ansluta till en enda projektslutpunkt.

Kör de här kommandona för att lägga till 1.x-Azure AI SDK-paket för klassiska Foundry-projekt.

# 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

Skapa en projektklient:

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

Skapa en OpenAI-kompatibel klient från projektet:

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)

Skapa en projektklient:

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

Skapa en projektklient:

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

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

Skapa en OpenAI-kompatibel klient från projektet:

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

Skapa en projektklient:

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

Skapa en OpenAI-kompatibel klient från projektet:

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

Mer information finns i Azure Programmeringsspråk som stöds av OpenAI. Förväntade utdata:

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

Mer information finns i Azure Programmeringsspråk som stöds av OpenAI

Följande kodfragment visar hur du använder Azure OpenAI /openai/v1 slutpunkt direkt.

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

Mer information om hur du använder OpenAI SDK finns i Azure OpenAI-programmeringsspråk som stöds.

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

Mer information om hur du använder OpenAI SDK finns i Azure OpenAI-programmeringsspråk som stöds.

1. Installera OpenAI-paketet: Kör det här kommandot för att lägga till OpenAI-klientbiblioteket i ditt .NET projekt.

   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
   

Mer information om hur du använder OpenAI SDK finns i Azure OpenAI-programmeringsspråk som stöds.

Gjutningsverktyg som stöds i C#

Gjutningsverktyg	Beskrivning	Snabbstarter och referensdokumentation
Tal	Lägg till funktioner för tal till text, text till tal, översättning och talarigenkänning i program.	• Snabbstart för tal till text • Snabbstart för text till tal • Snabbstart för talöversättning • Speech SDK för .NET • Speech NuGet-paket (Speech CLI)
Språk	Skapa program med funktioner för förståelse av naturligt språk. Funktioner som stöds: Språkidentifiering, PII-identifiering, Text Analytics för hälsa, fördefinierad NER och anpassad NER. Går i pension 31 mars 2029: Sentimentanalys och åsiktsutvinning, extrahering av nyckelfraser, sammanfattning, entitetslänkning, CQA och CLU.	• Snabbstart för svar på anpassade frågor (CQA)(går i pension 31 mars 2029) • Snabbstart för entitetslänkning(dras tillbaka 31 mars 2029) • Snabbstart för språkidentifiering • Snabbstart för extrahering av nyckelfraser(går i pension 31 mars 2029) • Snabbstart för identifiering av namngivna entiteter (NER) • Snabbstart för att upptäcka personidentifierande information (PII) • Snabbstart för sentimentanalys och åsiktsutvinning(går i pension 31 mars 2029) • Snabbstart för text-, dokument- och konversationssammanfattning(dras tillbaka 31 mars 2029) • Använda Text Analytics för hälsosnabbstart • Language SDK för .NET (textanalys) • Language NuGet-paket (textanalys) • Language SDK för .NET (frågesvar) • Language NuGet-paket (frågesvar) • Migrera från Language Studio till Microsoft Foundry för vägledning om hur du migrerar arbetsbelastningar med tillbakadragna funktioner
Translator	Använd AI-baserad översättningsteknik för att översätta mer än 100 använda, riskfyllda och utrotningshotade språk och dialekter.	• Translator SDK för .NET (text) • Translator NuGet-paket (text) • Translator SDK för .NET (batch) • Translator NuGet-paket (batch)
Azure AI-sökning	Ta med AI-baserad molnsökning till dina mobil- och webbappar.	• Använd snabbstart för agentbaserad hämtning • Snabbstart för vektorsökning • Snabbstart för klassisk generativ sökning (RAG) med referensdata • Snabbstart för fulltextsökning • Snabbstart för semantisk rankning • Chatta med Azure OpenAI-modeller med hjälp av din egen data • Azure AI-sökning SDK för .NET • Azure AI-sökning NuGet-paket
Content Safety	Identifiera skadligt innehåll i program och tjänster.	• Snabbstart för analysera textinnehåll • Använda en snabbstart för textblockeringslista • Snabbstart för att analysera bildinnehåll • Content Safety SDK för .NET • Content Safety NuGet-paket
Dokumentinformation	Omvandla dokument till intelligenta datadrivna lösningar.	• Snabbstart för dokumentintelligens • Document Intelligence SDK för .NET • Document Intelligence NuGet-paket
Vision	Analysera innehåll i digitala bilder och omfattande medietillgångar.	• Azure Vision in Foundry Tools v3.2 GA Läs snabbstartguide • Snabbstart för bildanalys • Använd snabbstarten för ansiktstjänsten • Vision SDK för .NET • Vision NuGet-paket

Stödda Java Foundry-verktyg

Gjutningsverktyg	Beskrivning	Snabbstarter och referensdokumentation
Tal	Lägg till funktioner för tal till text, text till tal, översättning och talarigenkänning i program.	• Snabbstart för tal till text • Snabbstart för text till tal • Snabbstart för talöversättning • Speech SDK för Java • Speech Maven-paket
Språk	Skapa program med funktioner för förståelse av naturligt språk. Funktioner som stöds: Språkidentifiering, PII-identifiering, Text Analytics för hälsa, fördefinierad NER och anpassad NER. Går i pension 31 mars 2029: Sentimentanalys och åsiktsutvinning, extrahering av nyckelfraser, sammanfattning, entitetslänkning, CQA och CLU.	• Snabbstart för entitetslänkning(dras tillbaka 31 mars 2029) • Snabbstart för språkidentifiering • Snabbstart för extrahering av nyckelfraser(går i pension 31 mars 2029) • Snabbstart för identifiering av namngivna entiteter (NER) • Snabbstart för att upptäcka personidentifierande information (PII) • Snabbstart för sentimentanalys och åsiktsutvinning(går i pension 31 mars 2029) • Snabbstart för text-, dokument- och konversationssammanfattning(dras tillbaka 31 mars 2029) • Använda Text Analytics för hälsosnabbstart • Language SDK för Java (textanalys) • Language Maven-paket • Migrera från Language Studio till Microsoft Foundry för vägledning om hur du migrerar arbetsbelastningar med tillbakadragna funktioner
Translator	Använd AI-baserad översättningsteknik för att översätta mer än 100 använda, riskfyllda och utrotningshotade språk och dialekter.	• Translator SDK för Java (text) • Translator Maven-paket (text)
Azure AI-sökning	Ta med AI-baserad molnsökning till dina mobil- och webbappar.	• Använd snabbstart för agentbaserad hämtning • Snabbstart för vektorsökning • Snabbstart för klassisk generativ sökning (RAG) med referensdata • Snabbstart för fulltextsökning • Snabbstart för semantisk rankning • Chatta med Azure OpenAI-modeller med hjälp av din egen data • Azure AI-sökning SDK för Java • Azure AI-sökning Maven-paket
Content Safety	Identifiera skadligt innehåll i program och tjänster.	• Snabbstart för analysera textinnehåll • Använda en snabbstart för textblockeringslista • Snabbstart för att analysera bildinnehåll • Content Safety SDK för Java • Content Safety Maven-paket
Dokumentinformation	Omvandla dokument till intelligenta datadrivna lösningar.	• Snabbstart för dokumentintelligens • Document Intelligence SDK för Java • Maven-paket för dokumentinformation
Vision	Analysera innehåll i digitala bilder och omfattande medietillgångar.	• Snabbstart för bildanalys • Använd snabbstarten för ansiktstjänsten • Vision SDK för Java • Vision Maven-paket

Foundry-verktyg som stöds i JavaScript

Gjutningsverktyg	Beskrivning	Snabbstarter och referensdokumentation
Tal	Lägg till funktioner för tal till text, text till tal, översättning och talarigenkänning i program.	• Snabbstart för tal till text • Snabbstart för text till tal • Snabbstart för talöversättning • Speech SDK för JavaScript • Speech npm-paket
Språk	Skapa program med funktioner för förståelse av naturligt språk. Funktioner som stöds: Språkidentifiering, PII-identifiering, Text Analytics för hälsa, fördefinierad NER och anpassad NER. Går i pension 31 mars 2029: Sentimentanalys och åsiktsutvinning, extrahering av nyckelfraser, sammanfattning, entitetslänkning, CQA och CLU.	• Snabbstart för entitetslänkning(dras tillbaka 31 mars 2029) • Snabbstart för språkidentifiering • Snabbstart för extrahering av nyckelfraser(går i pension 31 mars 2029) • Snabbstart för identifiering av namngivna entiteter (NER) • Snabbstart för att upptäcka personidentifierande information (PII) • Snabbstart för sentimentanalys och åsiktsutvinning(går i pension 31 mars 2029) • Snabbstart för text-, dokument- och konversationssammanfattning(dras tillbaka 31 mars 2029) • Använda Text Analytics för hälsosnabbstart • Language SDK för JavaScript (textanalys) • Language npm-paket • Migrera från Language Studio till Microsoft Foundry för vägledning om hur du migrerar arbetsbelastningar med tillbakadragna funktioner
Translator	Använd AI-baserad översättningsteknik för att översätta mer än 100 använda, riskfyllda och utrotningshotade språk och dialekter.	• Translator SDK för JavaScript (text) • Translator npm-paket (text)
Azure AI-sökning	Ta med AI-baserad molnsökning till dina mobil- och webbappar.	• Använd snabbstart för agentbaserad hämtning • Snabbstart för vektorsökning • Snabbstart för klassisk generativ sökning (RAG) med referensdata • Snabbstart för fulltextsökning • Snabbstart för semantisk rankning • Chatta med Azure OpenAI-modeller med hjälp av din egen data • Azure AI-sökning SDK för JavaScript • Azure AI-sökning npm-paket
Content Safety	Identifiera skadligt innehåll i program och tjänster.	• Snabbstart för analysera textinnehåll • Använda en snabbstart för textblockeringslista • Snabbstart för att analysera bildinnehåll • NPM-paket för innehållssäkerhet
Dokumentinformation	Omvandla dokument till intelligenta datadrivna lösningar.	• Snabbstart för dokumentintelligens • Document Intelligence SDK för JavaScript • Document Intelligence npm-paket
Vision	Analysera innehåll i digitala bilder och omfattande medietillgångar.	• Azure Vision in Foundry Tools v3.2 GA Läs snabbstartguide • Snabbstart för bildanalys • Använd snabbstarten för ansiktstjänsten • Vision SDK för JavaScript • Vision npm-paket

Pythonstöd för Foundry-verktyg

Gjutningsverktyg	Beskrivning	Snabbstarter och referensdokumentation
Tal	Lägg till funktioner för tal till text, text till tal, översättning och talarigenkänning i program.	• Snabbstart för tal till text • Snabbstart för text till tal • Snabbstart för talöversättning • Speech SDK för Python • Speech PyPi-paket
Språk	Skapa program med funktioner för förståelse av naturligt språk. Funktioner som stöds: Språkidentifiering, PII-identifiering, Text Analytics för hälsa, fördefinierad NER och anpassad NER. Går i pension 31 mars 2029: Sentimentanalys och åsiktsutvinning, extrahering av nyckelfraser, sammanfattning, entitetslänkning, CQA och CLU.	• Snabbstart för svar på anpassade frågor (CQA)(går i pension 31 mars 2029) • Snabbstart för entitetslänkning(dras tillbaka 31 mars 2029) • Snabbstart för språkidentifiering • Snabbstart för extrahering av nyckelfraser(går i pension 31 mars 2029) • Snabbstart för att känna igen namngivna entiteter (NER) • Snabbstart för att upptäcka personidentifierande information (PII) • Snabbstart för sentimentanalys och åsiktsutvinning(går i pension 31 mars 2029) • Snabbstart för text-, dokument- och konversationssammanfattning(dras tillbaka 31 mars 2029) • Använda Text Analytics för hälsosnabbstart • Language SDK för Python (textanalys) • Språk-PyPi-paket (textanalys) • Language SDK för Python (frågesvar) • Språk-PyPi-paket (frågesvar) • Language SDK för Python (språkkonversationer)(dras tillbaka 31 mars 2029) • Språk-PyPi-paket (språkkonversationer)(dras tillbaka 31 mars 2029) • Migrera från Language Studio till Microsoft Foundry för vägledning om hur du migrerar arbetsbelastningar med tillbakadragna funktioner
Translator	Använd AI-baserad översättningsteknik för att översätta mer än 100 använda, riskfyllda och utrotningshotade språk och dialekter.	• Translator SDK för Python (text) • Translator PyPi-paket (text) • Translator SDK för Python (batch) • Translator PyPi package (batch)
Azure AI-sökning	Ta med AI-baserad molnsökning till dina mobil- och webbappar.	• Ansluta till en söktjänsts snabbstart • Använd snabbstart för agentbaserad hämtning • Snabbstart för vektorsökning • Snabbstart för klassisk generativ sökning (RAG) med referensdata • Snabbstart för fulltextsökning • Snabbstart för semantisk rankning • Chatta med Azure OpenAI-modeller med hjälp av din egen data • Azure AI-sökning SDK för Python • Azure AI-sökning PyPi-paket
Content Safety	Identifiera skadligt innehåll i program och tjänster.	• Snabbstart för analysera textinnehåll • Använda en snabbstart för textblockeringslista • Snabbstart för att analysera bildinnehåll • Content Safety SDK för Python • PyPi-paket för innehållssäkerhet
Dokumentinformation	Omvandla dokument till intelligenta datadrivna lösningar.	• Snabbstart för dokumentintelligens • Document Intelligence SDK för Python • PyPi-paket för dokumentinformation
Vision	Analysera innehåll i digitala bilder och omfattande medietillgångar.	• Azure Vision in Foundry Tools v3.2 GA Läs snabbstartguide • Snabbstart för bildanalys • Använd snabbstarten för ansiktstjänsten • Vision SDK för Python • Vision PyPi-paket