Dela via

Azure AI Foundry SDK-klientbibliotek

Azure AI Foundry SDK är en omfattande verktygskedja som är utformad för att förenkla utvecklingen av AI-program i Azure. Det gör det möjligt för utvecklare att:

  • Få åtkomst till populära modeller från olika modellleverantörer via ett enda gränssnitt
  • Kombinera enkelt modeller, data och AI-tjänster för att skapa AI-baserade program
  • Utvärdera, felsöka och förbättra programkvaliteten och säkerheten i utvecklings-, testnings- och produktionsmiljöer

Azure AI Foundry SDK är en uppsättning klientbibliotek och tjänster som utformats för att fungera tillsammans.

Note

Den här artikeln gäller för ett Azure AI Foundry-projekt. Koden som visas här fungerar inte för ett hubbbaserat projekt. Mer information finns i Typer av projekt.

Prerequisites

  • Ett Azure-konto med en aktiv prenumeration. Om du inte har ett skapar du ett kostnadsfritt Azure-konto, som innehåller en kostnadsfri utvärderingsprenumeration.

  • Skapa ett Azure AI Foundry-projekt om du inte redan har ett.

  • Med Azure AI Foundry Models kan kunderna använda de mest kraftfulla modellerna från flaggskeppsmodellleverantörer med en enda slutpunkt och autentiseringsuppgifter. Det innebär att du kan växla mellan modeller och använda dem från ditt program utan att ändra en enda kodrad.

    Kopiera Azure AI Foundry-projektslutpunkten i avsnittet Översikt i projektet. Du kommer att använda den om en stund.

    Skärmbild som visar projektöversikten för ett Foundry-projekt.

    Tip

    Om du inte ser slutpunkten för Azure AI Foundry-projektet använder du ett hubbbaserat projekt. (Se Typer av projekt). Växla till ett Azure AI Foundry-projekt eller använd föregående steg för att skapa ett.

  • Logga in med Azure CLI med samma konto som du använder för att komma åt projektet:

    az login

Unified Projects-klientbibliotek

Följande exempel visar hur du ansluter till ditt Azure AI Foundry-projekt med olika programmeringsspråk. Den här anslutningen är det första steget för att komma åt modeller, data och AI-tjänster via SDK. Varje kodblock visar hur du autentiserar och skapar en klient för projektslutpunkten.

Tip

Kodexemplen nedan är startpunkter. Du använder dessa klienter för att interagera med modeller, köra utvärderingar med mera, enligt beskrivningen i avsnittet klientbibliotek nedan.

Azure AI Foundry Projects-klientbiblioteket 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.

  • Installera projektklientbiblioteket

    pip install azure-ai-projects azure-identity

  • Skapa en projektklient i kod. Kopiera Azure AI Foundry-projektslutpunkten från översiktssidan för projektet och uppdatera anslutningssträngvärdet.

    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 AI Foundry Projects-klientbiblioteket för Java (förhandsversion) är ett enhetligt bibliotek som gör att du kan använda flera klientbibliotek tillsammans genom att ansluta till en enda projektslutpunkt.

Important

Objekt markerade (förhandsversion) i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.

  • Lägg till dessa paket i installationen:

    • com.azure.ai.projects
    • com.azure.core

  • Skapa en projektklient i kod. Kopiera Azure AI Foundry-projektslutpunkten från översiktssidan för projektet och uppdatera anslutningssträngvärdet.

    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 Foundry Projects-klientbiblioteket 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.

  • Installera beroenden (förhandsversion):

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

  • Skapa en projektklient i kod. Kopiera Azure AI Foundry-projektslutpunkten från översiktssidan för projektet och uppdatera anslutningssträngvärdet.

    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());
const projectClient = await project.getAzureOpenAIClient({
    // The API version should match the version of the Azure OpenAI resource
    apiVersion: "2024-12-01-preview"
});
// The AIProjectClient lets you access models, data, and services in your project.

Azure AI Foundry Projects-klientbiblioteket 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.

  • Installera paket:

    dotnet add package Azure.Identity
dotnet add package Azure.Core
dotnet add package Azure.AI.Inference

  • Skapa en projektklient i kod. Kopiera Azure AI Foundry-projektslutpunkten från översiktssidan för projektet och uppdatera anslutningssträngvärdet.

    using Azure;
using Azure.Identity;
using Azure.AI.Inference;
using Azure.Core;
using Azure.Core.Pipeline;

var endpointUrl = "your_project_endpoint"; // Replace with your actual endpoint
var credential = new DefaultAzureCredential();

AzureAIInferenceClientOptions clientOptions = new AzureAIInferenceClientOptions();
BearerTokenAuthenticationPolicy tokenPolicy = new BearerTokenAuthenticationPolicy(
    credential, 
    new string[] { "https://cognitiveservices.azure.com/.default" }
);
// 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 ChatCompletionsClient(
    endpointUrl, 
    credential,
    clientOptions
);
// The ChatCompletionsClient lets you interact with models and services in your project.

När du har skapat en klient kan du använda den för att komma åt modeller, köra utvärderingar och ansluta till andra AI-tjänster. I nästa avsnitt visas de tillgängliga klientbiblioteken och hur du använder dem för specifika Azure AI-tjänster.

Azure AI Services-klientbibliotek

Om du vill använda Azure AI-tjänster kan du använda följande klientbibliotek med slutpunkterna som visas på projektets startsida.

C#-tjänster som stöds

Service Description Referensdokumentation
Ikon för tal Tal Lägg till funktioner för tal till text, text till tal, översättning och talarigenkänning i program. • Speech SDK för .NET

• Speech NuGet-paket (Speech CLI)
Ikonen Innehållssäkerhet Innehållssäkerhet Identifiera skadligt innehåll i program och tjänster. • Content Safety SDK för .NET

• Content Safety NuGet-paket
Vision-ikon Vision Analysera innehåll i digitala bilder och omfattande medietillgångar. • Vision SDK för .NET

• Vision NuGet-paket
Språkikon Språk Skapa program med funktioner för förståelse av naturligt språk. • Language SDK för .NET (textanalys)

• Language NuGet-paket (textanalys)

• Language SDK för .NET (frågesvar)

• Language NuGet-paket (frågesvar)
Translator-ikon Översättare 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)
Ikon för dokumentinformation Dokumentinformation Omvandla dokument till intelligenta datadrivna lösningar. • Document Intelligence SDK för .NET

• NuGet-paket för dokumentinformation
Azure AI Search-ikon Azure AI Search Lägg till AI-baserad molnsökning i dina mobil- och webbappar. • Azure AI Search SDK för .NET

• Azure AI Search NuGet-paket

Java-tjänster som stöds

Service Description Referensdokumentation
Ikon för tal Tal Lägg till funktioner för tal till text, text till tal, översättning och talarigenkänning i program. • Speech SDK för Java

• Speech Maven-paket
Ikonen Innehållssäkerhet Innehållssäkerhet Identifiera skadligt innehåll i program och tjänster. • Content Safety SDK för Java

• Content Safety Maven-paket
Visionikonen [Vision]../../../ai-services/computer-vision/index.yml) Analysera innehåll i digitala bilder och omfattande medietillgångar. • Vision SDK för Java

• Vision Maven-paket
Språkikon Språk Skapa program med funktioner för förståelse av naturligt språk. • Language SDK för Java (textanalys)

• Language Maven-paket
Translator-ikon Översättare 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)
Ikon för dokumentinformation Dokumentinformation Omvandla dokument till intelligenta datadrivna lösningar. • Document Intelligence SDK för Java

• Maven-paket för dokumentinformation
Azure AI Search-ikon Azure AI Search Lägg till AI-baserad molnsökning i dina mobil- och webbappar. • Azure AI Search SDK för Java

• Azure AI Search Maven-paket

JavaScript-tjänster som stöds

Service Description Referensdokumentation
Ikon för tal Tal Lägg till funktioner för tal till text, text till tal, översättning och talarigenkänning i program. • Speech SDK för JavaScript

• Speech npm-paket
Ikonen Innehållssäkerhet Innehållssäkerhet Identifiera skadligt innehåll i program och tjänster. • Content Safety SDK för JavaScript

• NPM-paket för innehållssäkerhet
Vision-ikon Vision Analysera innehåll i digitala bilder och omfattande medietillgångar. • Vision SDK för JavaScript

• Vision npm-paket
Språkikon Språk Skapa program med funktioner för förståelse av naturligt språk. • Language SDK för JavaScript (textanalys)

• Språk npm paketet
Translator-ikon Översättare 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)
Ikon för dokumentinformation Dokumentinformation Omvandla dokument till intelligenta datadrivna lösningar. • Document Intelligence SDK för JavaScript

• Document Intelligence npm-paket
Azure AI Search-ikon Azure AI Search Lägg till AI-baserad molnsökning i dina mobil- och webbappar. • Azure AI Search SDK för JavaScript

• Azure AI Search npm-paket

Python-tjänster som stöds

Service Description Referensdokumentation
Ikon för tal Tal Lägg till funktioner för tal till text, text till tal, översättning och talarigenkänning i program. • Speech SDK för Python

• Speech PyPi-paket
Ikonen Innehållssäkerhet Innehållssäkerhet Identifiera skadligt innehåll i program och tjänster. • Content Safety SDK för Python

• PyPi-paket för innehållssäkerhet
Vision-ikon Vision Analysera innehåll i digitala bilder och omfattande medietillgångar. • Vision SDK för Python

• Vision PyPi-paket
Språkikon Språk Skapa program med funktioner för förståelse av naturligt språk. • 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)

• Språk-PyPi-paket (språkkonversationer)
Translator-ikon Översättare 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-paket (batch)
Ikon för dokumentinformation Dokumentinformation Omvandla dokument till intelligenta datadrivna lösningar. • Document Intelligence SDK för Python

• PyPi-paket för dokumentinformation
Azure AI Search-ikon Azure AI Search Lägg till AI-baserad molnsökning i dina mobil- och webbappar. • Azure AI Search SDK för Python

• Azure AI Search PyPi-paket