Microsoft Foundry SDKs und Schnittstellen (klassisch)

Zurzeit wird folgendes angezeigt:Foundry (klassische) Portalversion - Wechseln zur Version für das neue Foundry-Portal

Eine Foundry-Ressource bietet einen einheitlichen Zugriff auf Modelle, Agents und Tools. In diesem Artikel wird erläutert, welches SDK und welcher Endpunkt für Ihr Szenario verwendet werden soll.

Das Foundry SDK ist ein Thin-Client-SDK, das alle Foundry-Projekt-APIs über einen einzelnen Projektendpunkt verfügbar macht. SdKs auf höherer Ebene bauen darauf auf – z. B. hängt das Agent Framework-Paket foundry vom Foundry SDK ab, um auf Foundry-Modelle, -Tools und -Projektkonfiguration zuzugreifen.

SDK Wozu es dient Endpunkt
Foundry SDK Thin-client SDK für alle Foundry-Projekt-APIs. Zugriff auf Foundry Models und Plattformtools (Dateisuche, Codedolmetscher, Websuche, Speicher, SharePoint, WorkIQ, Fabric IQ, MCP). https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
Agent Framework Erstellen Sie gehostete Agenten und Multi-Agent-Systeme mithilfe von Code. Das foundry Paket hängt vom Foundry SDK für den Projektzugriff ab. Führen Sie eine Ausführung in Ihrem eigenen Prozess durch. Antwort-API im Projektendpunkt über FoundryChatClient.
OpenAI SDK Vollständige OpenAI-API-Oberfläche, einschließlich Einbettungen. Optimale Latenz und maximale OpenAI-Kompatibilität. https://<resource-name>.openai.azure.com/openai/v1
Anthropic SDK In Foundry bereitgestellte Anthropic Claude-Modelle. https://<resource-name>.services.ai.azure.com/anthropic
Foundry-Tools-SDKs Vorgefertigte Lösungen (Vision, Speech, Content Safety und mehr). Toolspezifische Endpunkte.

Wählen Sie Ihr SDK aus:

  • Verwenden Sie das Foundry SDK beim Erstellen von Apps mit Agents, Auswertungen oder Foundry-spezifischen Features
  • Verwenden des Agent-Frameworks beim Erstellen von gehosteten Agents oder Multi-Agent-Systemen im Code mithilfe der Antwort-API
  • Verwenden Sie openAI SDK , wenn maximale OpenAI-Kompatibilität oder niedrigste Latenz erforderlich ist, wenn Einbettungen generiert werden oder wenn Foundry Direct Models über Chat-Fertigstellungen verwendet werden.
  • Verwenden sie Anthropic SDK beim Arbeiten mit Anthropic Claude Modellen, die in Foundry bereitgestellt wurden
  • Verwenden von Foundry Tools SDKs beim Arbeiten mit bestimmten KI-Diensten (Vision, Spracherkennung, Sprache usw.)

Hinweis

Ressourcentypen: Eine Foundry-Ressource stellt alle zuvor aufgeführten Endpunkte bereit. Eine Azure OpenAI-Ressource stellt nur den endpunkt /openai/v1 bereit.

Authentication: Beispiele verwenden hier Microsoft Entra ID (DefaultAzureCredential). API-Schlüssel arbeiten mit /openai/v1. Übergeben Sie den Schlüssel als api_key anstelle eines Tokenanbieters.

Voraussetzungen

  • Ein Azure Konto mit einem aktiven Abonnement. Wenn Sie kein Konto haben, erstellen Sie ein free Azure Konto, das ein kostenloses Testabonnement enthält.

  • Führen Sie eine der folgenden Azure RBAC-Rollen zum Erstellen und Verwalten von Foundry-Ressourcen aus:

    • Foundry-Benutzer (Rolle mit minimalen Berechtigungen für Entwicklungsaufgaben)

      Wichtig

      Die Foundry-RBAC-Rollen wurden kürzlich umbenannt. Foundry User, Foundry Owner, Foundry Account Owner und Foundry Project Manager wurden zuvor Azure KI-Benutzer, Azure KI-Besitzer, Azure KI-Kontobesitzer und Azure AI Project Manager benannt. Möglicherweise werden die vorherigen Namen an einigen Stellen weiterhin angezeigt, während der Umbenennungsrollout ausgeführt wird. Die Rollen-IDs und Kernberechtigungen bleiben durch die Umbenennung unverändert.

    • Foundry Project Manager (für die Verwaltung von Foundry-Projekten)

    • Mitwirkender oder Besitzer (für Berechtigungen auf Abonnementebene)

    Ausführliche Informationen zu den Berechtigungen der einzelnen Rollen finden Sie unter Role-basierte Zugriffssteuerung für Microsoft Foundry.

  • Installieren Sie die erforderlichen Sprachlaufzeiten, globalen Tools und VS-Codeerweiterungen, wie unter "Vorbereiten Der Entwicklungsumgebung" beschrieben.

Wichtig

Bevor Sie beginnen, stellen Sie sicher, dass Ihre Entwicklungsumgebung bereit ist.
Dieser Artikel konzentriert sich auf szenariospezifische Schritte wie SDK-Installation , Authentifizierung und Ausführen von Beispielcode.

Überprüfen der Voraussetzungen

Bevor Sie fortfahren, bestätigen Sie Folgendes:

  • Azure Abonnement ist aktiv: az account show
  • Sie verfügen über die erforderliche RBAC-Rolle: Überprüfen sie Azure Portal → Foundry-Ressource → Zugriffssteuerung (IAM)
  • Installierte Sprachlaufzeit:
    • Python: python --version (≥3.8)
  • Installierte Sprachlaufzeit:
    • Node.js: node --version (≥18)
  • Installierte Sprachlaufzeit:
    • .NET: dotnet --version (≥6.0)
  • Installierte Sprachlaufzeit:
    • Java: java --version (≥11)

Foundry SDK

Das Foundry SDK stellt eine Verbindung mit einem einzelnen Projektendpunkt her, der Zugriff auf die beliebtesten Foundry-Funktionen bietet:

https://<resource-name>.services.ai.azure.com/api/projects/<project-name>

Hinweis

Wenn Ihre Organisation eine benutzerdefinierte Unterdomäne verwendet, ersetzen Sie <resource-name> durch <your-custom-subdomain> in der Endpunkt-URL.

Dieser Ansatz vereinfacht die Anwendungskonfiguration. Anstatt mehrere Endpunkte zu verwalten, konfigurieren Sie einen.

Installieren des SDK

Hinweis

Dieser Artikel bezieht sich auf ein Foundry-Projekt. Der hier gezeigte Code funktioniert nicht für ein hubbasiertes Projekt. Weitere Informationen finden Sie unter Projekttypen.

Hinweis

SDK-Versionen: In diesem Artikel wird die Installation des 1.x SDK behandelt. Stellen Sie sicher, dass die folgenden Beispiele ihrem installierten Paket entsprechen. Wechseln Sie zur neuen Dokumentation des Foundry-Portals, um Artikel für 2.x anzuzeigen.

SDK-Version Portalversion Status Python-Paket
2.x Gießerei (neu) Stabil azure-ai-projects>=2.0.0
1.x Gießerei (klassisch) Stabil azure-ai-projects==1.0.0

Die Azure AI Projects-Clientbibliothek für Python ist eine einheitliche Bibliothek, mit der Sie mehrere Clientbibliotheken zusammen verwenden können, indem Sie eine Verbindung mit einem einzelnen Projektendpunkt herstellen.

Führen Sie diesen Befehl aus, um die 1.x-Pakete für klassische Foundry-Projekte zu installieren.

pip install openai azure-identity azure-ai-projects==1.0.0
SDK-Version Portalversion Status Java-Paket
2.0.0 Gießerei (neu) Stabil azure-ai-projects
azure-ai-agents
SDK-Version Portalversion Status JavaScript-Paket
2.0.1 Gießerei (neu) Stabil @azure/ai-projects
1.0.1 Foundry Classic Stabil @azure/ai-projects
SDK-Version Portalversion Status .NET-Paket
2.0.0-beta.1 (Vorschau) Gießerei (neu) Vorschau Azure.AI.Projects
Azure.AI.Projects.OpenAI
1.1.0 (GA) Foundry Classic Stabil Azure.AI.Projects

Die Azure AI Projects-Clientbibliothek für Java ist eine einheitliche Bibliothek, mit der Sie mehrere Clientbibliotheken zusammen verwenden können, indem Sie eine Verbindung mit einem einzelnen Projektendpunkt herstellen.

Wichtig

Das paket "Java azure-ai-projects" verfügt nicht über eine 1.x GA-Version. Die Codebeispiele in den Abschnitten Java verwenden das azure-ai-inference-Paket direkt, das veraltet ist und am 30. Mai 2026 eingestellt wird. Wechseln Sie für das 2.x Projects SDK zur neuen Dokumentation des Foundry-Portals.

Fügen Sie diese Abhängigkeiten zu Ihren klassischen Projekten von Maven pom.xml für Foundry hinzu.

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

Die Azure AI Projects-Clientbibliothek für JavaScript ist eine einheitliche Bibliothek, mit der Sie mehrere Clientbibliotheken zusammen verwenden können, indem Sie eine Verbindung mit einem einzelnen Projektendpunkt herstellen.

Führen Sie diesen Befehl aus, um die 1.x JavaScript-Pakete für klassische Foundry-Projekte zu installieren.

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

Die Azure AI Projects-Clientbibliothek für .NET ist eine einheitliche Bibliothek, mit der Sie mehrere Clientbibliotheken zusammen verwenden können, indem Sie eine Verbindung mit einem einzelnen Projektendpunkt herstellen.

Führen Sie diese Befehle aus, um die 1.x Azure AI SDK-Pakete für klassische Foundry-Projekte hinzuzufügen.

# 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

Verwenden des Foundry SDK

Das SDK macht zwei Clienttypen verfügbar, da Foundry und OpenAI unterschiedliche API-Shapes haben:

  • Project client – Wird für Foundry-native Vorgänge verwendet, bei denen OpenAI keine Entsprechung hat. Beispiele: Auflisten von Verbindungen, Abrufen von Projekteigenschaften, Aktivieren von Tracing.
  • OpenAI-kompatibler Client – Verwendung für Foundry-Funktionen, die auf OpenAI-Konzepten basieren. Die Responses-API, Agents, Auswertungen und Feinabstimmungen verwenden alle Anforderungs-/Antwortmuster im OpenAI-Stil. Mit diesem Client haben Sie auch Zugriff auf direkte Foundry Models (in Foundry gehostete Nicht-Azure-OpenAI-Modelle). Der Projektendpunkt leitet diesen Datenverkehr über die /openai Route.

Die meisten Apps verwenden beide Clients. Verwenden Sie den Projektclient für die Einrichtung und Konfiguration, und verwenden Sie dann den OpenAI-kompatiblen Client zum Ausführen von Agenten, Bewertungen und zum Aufrufen von Modellen (einschließlich Foundry-Direct-Modelle).

Erstellen eines Projektclients:

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

Erstellen Sie einen openAI-kompatiblen Client aus Ihrem Projekt:

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)

Erstellen eines Projektclients:

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

Erstellen eines Projektclients:

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

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

Erstellen Sie einen openAI-kompatiblen Client aus Ihrem Projekt:

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

Erstellen eines Projektclients:

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

Erstellen Sie einen openAI-kompatiblen Client aus Ihrem Projekt:

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

Was Sie mit dem Foundry SDK tun können

Problembehandlung

Authentifizierungsfehler

Wenn Sie Folgendes sehen: DefaultAzureCredential failed to retrieve a token

  1. Verify Azure CLI wird authentifiziert:

    az account show
    az login  # if not logged in
    
  2. Überprüfen der RBAC-Rollenzuweisung:

    • Bestätigen Sie, dass Sie mindestens über die Rolle "Foundry User" im Foundry-Projekt verfügen.

      Wichtig

      Die Foundry-RBAC-Rollen wurden kürzlich umbenannt. Foundry User, Foundry Owner, Foundry Account Owner und Foundry Project Manager wurden zuvor Azure KI-Benutzer, Azure KI-Besitzer, Azure KI-Kontobesitzer und Azure AI Project Manager benannt. Möglicherweise werden die vorherigen Namen an einigen Stellen weiterhin angezeigt, während der Umbenennungsrollout ausgeführt wird. Die Rollen-IDs und Kernberechtigungen bleiben durch die Umbenennung unverändert.

    • Siehe Zuweisen von Azure-Rollen

  3. Für verwaltete Identität in der Produktion:

Endpunktkonfigurationsfehler

Wenn Connection refused oder 404 Not Found angezeigt wird:

  • Überprüfen, ob Ressourcen- und Projektnamen ihrer tatsächlichen Bereitstellung entsprechen
  • Endpunkt-URL-Format überprüfen: Sollte sein https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
  • Für benutzerdefinierte Unterdomänen: Ersetzen Sie <resource-name> durch Ihre benutzerdefinierte Unterdomäne

Nichtübereinstimmungen der SDK-Version

Wenn Codebeispiele mit AttributeError oder ModuleNotFoundError fehlschlagen:

  • SDK-Version überprüfen:

    pip show azure-ai-projects  # Python
    npm list @azure/ai-projects  # JavaScript
    dotnet list package  # .NET
    
  • Neuinstallation mit korrekten Versionskennzeichnungen: Siehe Installationsbefehle in den einzelnen Sprachabschnitten oben

OpenAI SDK

Verwenden Sie das OpenAI SDK, wenn Sie die vollständige OpenAI-API-Oberfläche und maximale Clientkompatibilität benötigen. Dieser Endpunkt bietet Zugriff auf Azure OpenAI-Modelle und Foundry Direct-Modelle (über die Chat-Abschluss-API). Es bietet keinen Zugriff auf Foundry-spezifische Features wie Agents und Auswertungen.

Der folgende Codeausschnitt zeigt, wie Sie den Azure OpenAI /openai/v1 Endpunkt direkt verwenden.

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

Weitere Informationen finden Sie unter Azure OpenAI unterstützte Programmiersprachen. Erwartete Ausgabe:

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

Weitere Informationen finden Sie unter Azure OpenAI unterstützte Programmiersprachen

Wichtig

In diesem Artikel markierte Elemente (Vorschau) befinden sich derzeit in der öffentlichen Vorschau. Diese Vorschau wird ohne Vereinbarung auf Serviceebene bereitgestellt und wird für Produktionsworkloads nicht empfohlen. Bestimmte Features werden möglicherweise nicht unterstützt oder weisen eingeschränkte Funktionen auf. Weitere Informationen finden Sie unter Supplementale Nutzungsbedingungen für Microsoft Azure Previews.

Der folgende Codeausschnitt zeigt, wie Sie den Azure OpenAI /openai/v1 Endpunkt direkt verwenden.

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

Weitere Informationen zur Verwendung des OpenAI SDK finden Sie unter Azure OpenAI unterstützte Programmiersprachen.

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

Weitere Informationen zur Verwendung des OpenAI SDK finden Sie unter Azure OpenAI unterstützte Programmiersprachen.

  1. Installieren Sie das OpenAI-Paket: Führen Sie diesen Befehl aus, um Ihrem .NET Projekt die OpenAI-Clientbibliothek hinzuzufügen.
    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
    

Weitere Informationen zur Verwendung des OpenAI SDK finden Sie unter Azure OpenAI unterstützte Programmiersprachen.

Agenten-Framework

Microsoft Agent Framework ist ein Open-Source SDK (Python und .NET) zum Erstellen von Agents und Multi-Agent-Systemen im Code. Es ist der empfohlene Pfad für Hosted Agents (Vorschau) für Microsoft Foundry.

Ihren Code auf einem gehosteten Agenten ausführen

Das Hauptthema für codebasierte Agenten in Foundry ist Gehostete Agenten (Vorschau). Schreiben Sie Ihren Agent mit Agent Framework, packen Sie ihn als Containerimage oder zip-Datei Ihres Quellcodes, und lassen Sie Foundry ihn mit einem verwalteten Endpunkt, einer automatischen Skalierung auf isolierten Micro-VMs, einer dedizierten Microsoft Entra-Agent-Identität, einem Status auf Sitzungsebene und End-to-End-Observability ausführen.

Gehostete Agents sind der empfohlene Pfad, wenn Sie einen von Foundry verwalteten, netzwerkadressierbaren Endpunkt benötigen, den andere Apps oder Agents anrufen können. Siehe Bereitstellen Ihres ersten gehosteten Agents.

Erstellen Sie Agenten im Code außerhalb von Foundry mit der Responses API

Wenn Sie Ihren Agent außerhalb von Foundry hosten – in Ihrem eigenen Prozess oder ihrer eigenen Infrastruktur – können Sie auch Agent Framework verwenden, um die Antwort-API direkt in Ihrem Projektendpunkt aufzurufen. Agent Framework stellt über den FoundryChatClient-Anbieter eine Verbindung her, der auf Folgendes abzielt:

{project_endpoint}/openai/v1/responses

Das Durchlaufen des Projektendpunkts – anstelle eines OpenAI-Endpunkts auf Ressourcenebene – gibt Ihrem Agent Folgendes:

  • Foundry-Modelle aus dem Katalog (Azure OpenAI und direkte Foundry-Modelle) über eine einzige API.
  • Plattformtools, die über den OpenAI-Toolsatz hinausgehen, einschließlich Dateisuche, Codedolmetscher, Arbeitsspeicher, Websuche, MCP-Server, SharePoint, WorkIQ und Fabric IQ.
  • Projektbezogene Daten, On-Behalf-Of-Toolauthentifizierung (OBO) sowie die Ablaufverfolgung, Inhaltsfilter und Identitätskonfiguration des Projekts.

Dieses Muster ist additiv für gehostete Agents, nicht eine Alternative – derselbe Agent Framework-Code kann die Antwort-API heute aus Ihrem eigenen Prozess aufrufen und später als gehosteter Agent verpackt werden, wenn Sie einen Foundry-verwalteten Endpunkt benötigen. Siehe Schnellstart: Erstellen von Agents mithilfe der Antwort-API.

Einen vollständigen Vergleich der Agenttypen und Hostingoptionen finden Sie unter What is Microsoft Foundry Agent Service?.

Foundry Tools SDKs

Foundry Tools (früher Azure AI Services) sind vorgefertigte Point-Lösungen mit dedizierten SDKs. Verwenden Sie die folgenden Endpunkte, um mit Foundry Tools zu arbeiten.

Welchen Endpunkt sollten Sie verwenden?

Wählen Sie einen Endpunkt basierend auf Ihren Anforderungen aus:

Verwenden Sie den Azure AI Services-Endpunkt, um auf Maschinelles Sehen, Inhaltssicherheit, Dokumentintelligenz, Sprache, Übersetzung und Token foundry Tools zuzugreifen.

Endpunkt Foundry Tools: https://<your-resource-name>.cognitiveservices.azure.com/

Hinweis

Endpunkte verwenden entweder Ihren Ressourcennamen oder eine benutzerdefinierte Unterdomäne. Wenn Ihre Organisation eine benutzerdefinierte Unterdomäne eingerichtet hat, ersetzen Sie your-resource-name durch your-custom-subdomain in allen Endpunktbeispielen.

Wenn Ihre Workloads ablaufende Azure KI Language Features verwenden, z. B. Stimmungsanalyse, Extraktion von Schlüsselbegriffen, Zusammenfassung, Entitätsverknüpfung, CLU oder CQA, sollten Sie den Wechsel zu Foundry-Lösungen von Microsoft planen. Für neue Entwicklung sollten Sie das Foundry SDK oder den openAI-kompatiblen Endpunkt verwenden, wie weiter oben in diesem Artikel beschrieben. Siehe Migrate von Language Studio zu Microsoft Foundry.

Verwenden Sie für Foundry Tools für Sprache und Übersetzung die Endpunkte in den folgenden Tabellen. Ersetzen Sie Platzhalter durch Ihre Ressourceninformationen.

Speech Endpunkte

Gießerei-Werkzeug Endpunkt
Sprache zu Text (Standard) https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com
Text-to-Speech (neuronal) https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com
Benutzerdefinierte Stimme https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/

Übersetzungsendpunkte

Gießerei-Werkzeug Endpunkt
Textübersetzung https://api.cognitive.microsofttranslator.com/
Dokumentübersetzung https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/

Sprachendpunkte

Gießerei-Werkzeug Endpunkt
Textanalyse https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com

Wichtig

Am 20. März 2027 wird Azure Language Studio eingestellt und zu Microsoft Foundry migriert. Alle Funktionen und zukünftigen Verbesserungen werden in Microsoft Foundry verfügbar sein.

Am 31. März 2029 werden die folgenden Azure Sprachfunktionen eingestellt (Ende des Supports). Vor diesem Datum sollten Benutzer vorhandene Arbeitslasten migrieren und neue Projekte in Microsoft Foundry-Modelle integrieren, um das Verständnis der natürlichen Sprache und die vereinfachte Anwendungsintegration zu verbessern:

  • Schlüsselphrasenextraktion
  • Stimmungsanalyse und Meinungs-Mining
  • Benutzerdefinierte Textklassifizierung
  • Konversationelles Sprachverständnis (CLU)
  • Benutzerdefinierte Frageantwort (CQA)
  • Orchestrierungs-Workflow
  • Zusammenfassung (extraktiv und abstraktiv, für Dokumente und Unterhaltungen)
  • Entitätsverknüpfung

Kernfunktionen mit fortgesetzter Unterstützung: Spracherkennung, PII-Erkennung, Textanalysen für Gesundheit, Vordefinierter NER und Benutzerdefinierter NER.

Migrationsoptionen finden Sie unter Migrate from Language Studio to Microsoft Foundry.

C# unterstützt Foundry Tools

Gießerei-Werkzeug Beschreibung Schnellstarts und Referenzdokumentation
Sprachsymbol Sprache Fügen Sie Sprach-zu-Text-, Text-zu-Sprache-, Übersetzungs- und Sprechererkennungsfunktionen zu Anwendungen hinzu. Schnellstart für Sprache in Text

Schnellstart für Text-zu-Sprache

Schnellstart für die Sprachübersetzung

Speech SDK für .NET

Speech NuGet-Paket (Speech CLI)
Sprachsymbol Sprache Erstellen Sie Anwendungen mit Funktionen für natürliches Sprachverständnis. Unterstützte Features: Spracherkennung, PII-Erkennung, Textanalyse für das Gesundheitswesen, vorgefertigter NER und benutzerdefinierter NER. Wird zum 31. März 2029 eingestellt: Stimmungsanalyse und Opinion Mining, Extraktion von Schlüsselbegriffen, Zusammenfassung, Entitätsverknüpfung, CQA und CLU. Schnellstart zur Benutzerdefinierten Fragebeantwortung (CQA)(eingestellt am 31. März 2029)

Schnellstart: Entitätsverknüpfung(wird zum 31. März 2029 eingestellt)

Schnellstart zur Spracherkennung

Schnellstart zur Schlüsselausdruckextraktion(wird am 31. März 2029 eingestellt)

Schnellstart zum Erkennen benannter Entitäten (NER)

Schnellstart zum Erkennen von personenbezogenen Informationen (PII)

Schnellstart: Stimmungsanalyse und Opinion Mining(wird zum 31. März 2029 eingestellt)

Schnellstart: Verwenden der Text-, Dokument- und Konversationszusammenfassung(wird zum 31. März 2029 eingestellt)

Verwenden von Textanalyse for Health – Schnellstart

Language SDK für .NET (Textanalyse)

Language NuGet-Paket (Textanalyse)

Language SDK für .NET (Frageantwort)

Language NuGet-Paket (Fragebeantwortung)

Migrieren Sie von Language Studio zu Microsoft Foundry, um Anleitungen zum Migrieren von Workloads mit eingestellten Funktionen zu erhalten.
Übersetzersymbol Verwenden Sie KI-gestützte Übersetzungstechnologie, um mehr als 100 aktuell genutzte, bedrohte und gefährdete Sprachen und Dialekte zu übersetzen. Translator SDK für .NET (Text)

Translator NuGet-Paket (Text)

Translator SDK für .NET (batch)

Translator NuGet-Paket (Batch)
Azure KI-Suche icon Azure KI-Suche Bringen Sie KI-gestützte Cloudsuche zu Ihren mobilen und Web-Apps. Agentenabruf-Quickstart verwenden

Schnellstart für die Vektorsuche

Klassische generative Suche (RAG) mithilfe von Erdungsdaten – Schnellstart

Schnellstart für die Volltextsuche

Schnellstart zur semantischen Rangfolge

Chatten Sie mit Azure OpenAI-Modellen unter Verwendung Ihrer eigenen Daten im Schnellstart

Azure KI-Suche SDK für .NET

Azure KI-Suche NuGet-Paket
Symbol Erkennen von schädlichen Inhalten in Anwendungen und Diensten. Schnellstart zum Analysieren von Textinhalten

Verwenden einer Textblockliste – Schnellstart

Schnellstart zum Analysieren von Bildinhalten

Content Safety SDK für .NET

Content Safety NuGet-Paket
Dokumentintelligenzsymbol Dokumentintelligenz Verwandeln Sie Dokumente in intelligente datengesteuerte Lösungen. Schnellstart für Dokumentintelligenz

Document Intelligence SDK für .NET

Document Intelligence NuGet-Paket
Vision-Symbol Analysieren Sie Inhalte in digitalen Bildern und Rich-Media-Ressourcen. Azure Vision in Foundry Tools v3.2 GA Schnellstartanleitung lesen

Schnellstart zur Bildanalyse

Nutzen Sie den Schnellstart zu Face Service

Vision SDK für .NET

Vision NuGet-Paket

Java unterstützte Foundry Tools

Gießerei-Werkzeug Beschreibung Schnellstarts und Referenzdokumentation
Sprachsymbol Sprache Fügen Sie Sprach-zu-Text-, Text-zu-Sprache-, Übersetzungs- und Sprechererkennungsfunktionen zu Anwendungen hinzu. Schnellstart für Sprache in Text

Schnellstart für Text-zu-Sprache

Schnellstart für die Sprachübersetzung

Speech SDK für Java

Speech Maven-Paket
Sprachsymbol Sprache Erstellen Sie Anwendungen mit Funktionen für natürliches Sprachverständnis. Unterstützte Features: Spracherkennung, PII-Erkennung, Textanalyse für das Gesundheitswesen, vorgefertigter NER und benutzerdefinierter NER. Wird zum 31. März 2029 eingestellt: Stimmungsanalyse und Opinion Mining, Extraktion von Schlüsselbegriffen, Zusammenfassung, Entitätsverknüpfung, CQA und CLU. Schnellstart: Entitätsverknüpfung(wird zum 31. März 2029 eingestellt)

Schnellstart zur Spracherkennung

Schnellstart zur Schlüsselausdruckextraktion(wird am 31. März 2029 eingestellt)

Schnellstart zum Erkennen benannter Entitäten (NER)

Schnellstart zum Erkennen von personenbezogenen Informationen (PII)

Schnellstart: Stimmungsanalyse und Opinion Mining(wird zum 31. März 2029 eingestellt)

Schnellstart: Verwenden der Text-, Dokument- und Konversationszusammenfassung(wird zum 31. März 2029 eingestellt)

Verwenden von Textanalyse for Health – Schnellstart

Language SDK für Java (Textanalyse)

Maven-Sprachpaket

Migrieren Sie von Language Studio zu Microsoft Foundry, um Anleitungen zum Migrieren von Workloads mit eingestellten Funktionen zu erhalten.
Übersetzersymbol Verwenden Sie KI-gestützte Übersetzungstechnologie, um mehr als 100 aktuell genutzte, bedrohte und gefährdete Sprachen und Dialekte zu übersetzen. Translator SDK für Java (Text)

Translator Maven-Paket (Text)
Azure KI-Suche icon Azure KI-Suche Bringen Sie KI-gestützte Cloudsuche zu Ihren mobilen und Web-Apps. Agentenabruf-Quickstart verwenden

Schnellstart für die Vektorsuche

Klassische generative Suche (RAG) mithilfe von Erdungsdaten – Schnellstart

Schnellstart für die Volltextsuche

Schnellstart zur semantischen Rangfolge

Chatten Sie mit Azure OpenAI-Modellen unter Verwendung Ihrer eigenen Daten im Schnellstart

Azure KI-Suche SDK für Java

Azure KI-Suche Maven-Paket
Symbol Erkennen von schädlichen Inhalten in Anwendungen und Diensten. Schnellstart zum Analysieren von Textinhalten

Verwenden einer Textblockliste – Schnellstart

Schnellstart zum Analysieren von Bildinhalten

Content Safety SDK für Java

Content Safety Maven-Paket
Dokumentintelligenzsymbol Dokumentintelligenz Verwandeln Sie Dokumente in intelligente datengesteuerte Lösungen. Schnellstart für Dokumentintelligenz

Document Intelligence SDK für Java

Document Intelligence Maven-Paket
Vision-Symbol Analysieren Sie Inhalte in digitalen Bildern und Rich-Media-Ressourcen. Schnellstart zur Bildanalyse

Nutzen Sie den Schnellstart zu Face Service

Vision SDK für Java

Vision Maven Paket

JavaScript unterstützte Foundry Tools

Gießerei-Werkzeug Beschreibung Schnellstarts und Referenzdokumentation
Sprachsymbol Sprache Fügen Sie Sprach-zu-Text-, Text-zu-Sprache-, Übersetzungs- und Sprechererkennungsfunktionen zu Anwendungen hinzu. Schnellstart für Sprache in Text

Schnellstart für Text-zu-Sprache

Schnellstart für die Sprachübersetzung

Speech SDK für JavaScript

Npm-Spracherkennungspaket
Sprachsymbol Sprache Erstellen Sie Anwendungen mit Funktionen für natürliches Sprachverständnis. Unterstützte Features: Spracherkennung, PII-Erkennung, Textanalyse für das Gesundheitswesen, vorgefertigter NER und benutzerdefinierter NER. Wird zum 31. März 2029 eingestellt: Stimmungsanalyse und Opinion Mining, Extraktion von Schlüsselbegriffen, Zusammenfassung, Entitätsverknüpfung, CQA und CLU. Schnellstart: Entitätsverknüpfung(wird zum 31. März 2029 eingestellt)

Schnellstart zur Spracherkennung

Schnellstart zur Schlüsselausdruckextraktion(wird am 31. März 2029 eingestellt)

Schnellstart zum Erkennen benannter Entitäten (NER)

Schnellstart zum Erkennen von personenbezogenen Informationen (PII)

Schnellstart: Stimmungsanalyse und Opinion Mining(wird zum 31. März 2029 eingestellt)

Schnellstart: Verwenden der Text-, Dokument- und Konversationszusammenfassung(wird zum 31. März 2029 eingestellt)

Verwenden von Textanalyse for Health – Schnellstart

Language SDK für JavaScript (Textanalyse)

Npm-Sprachpaket

Migrieren Sie von Language Studio zu Microsoft Foundry, um Anleitungen zum Migrieren von Workloads mit eingestellten Funktionen zu erhalten.
Übersetzersymbol Verwenden Sie KI-gestützte Übersetzungstechnologie, um mehr als 100 aktuell genutzte, bedrohte und gefährdete Sprachen und Dialekte zu übersetzen. Translator SDK für JavaScript (Text)

Übersetzer npm-Paket (Text)
Azure KI-Suche icon Azure KI-Suche Bringen Sie KI-gestützte Cloudsuche zu Ihren mobilen und Web-Apps. Agentenabruf-Quickstart verwenden

Schnellstart für die Vektorsuche

Klassische generative Suche (RAG) mithilfe von Erdungsdaten – Schnellstart

Schnellstart für die Volltextsuche

Schnellstart zur semantischen Rangfolge

Chatten Sie mit Azure OpenAI-Modellen unter Verwendung Ihrer eigenen Daten im Schnellstart

Azure KI-Suche SDK für JavaScript

Npm-Paket für Azure KI-Suche
Symbol Erkennen von schädlichen Inhalten in Anwendungen und Diensten. Schnellstart zum Analysieren von Textinhalten

Verwenden einer Textblockliste – Schnellstart

Schnellstart zum Analysieren von Bildinhalten

Npm-Paket zur Inhaltssicherheit
Dokumentintelligenzsymbol Dokumentintelligenz Verwandeln Sie Dokumente in intelligente datengesteuerte Lösungen. Schnellstart für Dokumentintelligenz

Document Intelligence SDK für JavaScript

Npm-Paket für Die Dokumentintelligenz
Vision-Symbol Analysieren Sie Inhalte in digitalen Bildern und Rich-Media-Ressourcen. Azure Vision in Foundry Tools v3.2 GA Schnellstartanleitung lesen

Schnellstart zur Bildanalyse

Nutzen Sie den Schnellstart zu Face Service

Vision SDK für JavaScript

Vision npm-Paket

Python-unterstützte Foundry Tools

Gießerei-Werkzeug Beschreibung Schnellstarts und Referenzdokumentation
Sprachsymbol Sprache Fügen Sie Sprach-zu-Text-, Text-zu-Sprache-, Übersetzungs- und Sprechererkennungsfunktionen zu Anwendungen hinzu. Schnellstart für Sprache in Text

Schnellstart für Text-zu-Sprache

Schnellstart für die Sprachübersetzung

Speech SDK für Python

PyPi-Sprachpaket
Sprachsymbol Sprache Erstellen Sie Anwendungen mit Funktionen für natürliches Sprachverständnis. Unterstützte Features: Spracherkennung, PII-Erkennung, Textanalyse für das Gesundheitswesen, vorgefertigter NER und benutzerdefinierter NER. Wird zum 31. März 2029 eingestellt: Stimmungsanalyse und Opinion Mining, Extraktion von Schlüsselbegriffen, Zusammenfassung, Entitätsverknüpfung, CQA und CLU. Schnellstart zur Benutzerdefinierten Fragebeantwortung (CQA)(eingestellt am 31. März 2029)

Schnellstart: Entitätsverknüpfung(wird zum 31. März 2029 eingestellt)

Schnellstart zur Spracherkennung

Schnellstart zur Schlüsselausdruckextraktion(wird am 31. März 2029 eingestellt)

Schnellstart zum Erkennen benannter Entitäten (NER)

Schnellstart zum Erkennen von personenbezogenen Informationen (PII)

Schnellstart: Stimmungsanalyse und Opinion Mining(wird zum 31. März 2029 eingestellt)

Schnellstart: Verwenden der Text-, Dokument- und Konversationszusammenfassung(wird zum 31. März 2029 eingestellt)

Verwenden von Textanalyse for Health – Schnellstart

Language SDK für Python (Textanalyse)

PyPi-Sprachpaket (Textanalyse)

Language SDK für Python (Frageantwort)

PyPi-Sprachpaket (Frageantwort)

Language SDK für Python (Sprachunterhaltungen)(Einstellung am 31. März 2029)

PyPi-Sprachpaket (Sprachgespräche)(wird zum 31. März 2029 eingestellt)

Migrieren Sie von Language Studio zu Microsoft Foundry, um Anleitungen zum Migrieren von Workloads mit eingestellten Funktionen zu erhalten.
Übersetzersymbol Verwenden Sie KI-gestützte Übersetzungstechnologie, um mehr als 100 aktuell genutzte, bedrohte und gefährdete Sprachen und Dialekte zu übersetzen. Translator SDK für Python (Text)

Übersetzer PyPi-Paket (Text)

Translator SDK für Python (Batch)

Translator PyPi-Paket (Stapelverarbeitung)
Azure KI-Suche icon Azure KI-Suche Bringen Sie KI-gestützte Cloudsuche zu Ihren mobilen und Web-Apps. Herstellen einer Verbindung mit einem Suchdienst – Schnellstart

Agentenabruf-Quickstart verwenden

Schnellstart für die Vektorsuche

Klassische generative Suche (RAG) mithilfe von Erdungsdaten – Schnellstart

Schnellstart für die Volltextsuche

Schnellstart zur semantischen Rangfolge

Chatten Sie mit Azure OpenAI-Modellen unter Verwendung Ihrer eigenen Daten im Schnellstart

Azure KI-Suche SDK für Python

Azure KI-Suche PyPi-Paket
Symbol Erkennen von schädlichen Inhalten in Anwendungen und Diensten. Schnellstart zum Analysieren von Textinhalten

Verwenden einer Textblockliste – Schnellstart

Schnellstart zum Analysieren von Bildinhalten

Content Safety SDK für Python

Content Safety PyPi-Paket
Dokumentintelligenzsymbol Dokumentintelligenz Verwandeln Sie Dokumente in intelligente datengesteuerte Lösungen. Schnellstart für Dokumentintelligenz

Document Intelligence SDK für Python

Document Intelligence PyPi-Paket
Vision-Symbol Analysieren Sie Inhalte in digitalen Bildern und Rich-Media-Ressourcen. Azure Vision in Foundry Tools v3.2 GA Schnellstartanleitung lesen

Schnellstart zur Bildanalyse

Nutzen Sie den Schnellstart zu Face Service

Vision SDK für Python

Vision PyPi Paket