Was ist das Microsoft Foundry SDK?

  • 5 Minuten

Microsoft Foundry stellt eine REST-API bereit, mit der Sie mit AI Foundry-Projekten und den darin enthaltenen Ressourcen arbeiten können. Darüber hinaus stehen mehrere sprachspezifische SDKs zur Verfügung, sodass Entwickler Code schreiben können, der Ressourcen in einem Microsoft Foundry-Projekt in ihrer bevorzugten Entwicklungssprache verwendet. Mit einem Microsoft Foundry SDK können Entwickler Anwendungen erstellen, die eine Verbindung mit einem Projekt herstellen, auf die Ressourcenverbindungen und -modelle in diesem Projekt zugreifen und diese verwenden, um KI-Vorgänge auszuführen, z. B. das Senden von Eingabeaufforderungen an ein generatives KI-Modell und die Verarbeitung der Antworten.

Das Kernpaket für das Arbeiten mit Projekten ist die Azure AI Projects-Bibliothek , mit der Sie eine Verbindung mit einem Microsoft Foundry-Projekt herstellen und auf die darin definierten Ressourcen zugreifen können. Die verfügbaren sprachspezifischen Pakete für die Azure AI Projects-Bibliothek umfassen:

Anmerkung

In diesem Modul verwenden wir Python-Codebeispiele für allgemeine Aufgaben, die ein Entwickler möglicherweise mit Microsoft Foundry-Projekten ausführen muss. Sie können auf die andere sprachspezifische SDK-Dokumentation verweisen, um den entsprechenden Code für Ihre bevorzugte Sprache zu finden. Jedes SDK wird unabhängig entwickelt und verwaltet, sodass einige Funktionen in verschiedenen Phasen der Implementierung für jede Sprache vorhanden sein können.

Um die Azure AI Projects-Bibliothek in Python zu verwenden, können Sie das Pip-Paketinstallationsprogramm verwenden, um das Azure-ai-Projects-Paket aus PyPi zu installieren:

pip install azure-ai-projects

Verwenden des SDK zum Herstellen einer Verbindung mit einem Projekt

Die erste Aufgabe in den meisten Microsoft Foundry SDK-Code besteht darin, eine Verbindung mit einem Microsoft Foundry-Projekt herzustellen. Jedes Projekt verfügt über einen eindeutigen Endpunkt, den Sie auf der Seite "Übersicht " des Projekts im Microsoft Foundry-Portal finden können.

Screenshot der Projektübersichtsseite im Microsoft Foundry-Portal.

Anmerkung

Das Projekt stellt mehrere Endpunkte und Schlüssel bereit, einschließlich:

  • Ein Endpunkt für das Projekt selbst; die für den Zugriff auf Projektverbindungen, Agents und Modelle in der Microsoft Foundry-Ressource verwendet werden können.
  • Ein Endpunkt für Azure OpenAI-Dienst-APIs in der Microsoft Foundry-Ressource des Projekts.
  • Ein Endpunkt für Foundry Tools-APIs (z. B. Azure Vision und Azure Language) in der Microsoft Foundry-Ressource.

Sie können den Projektendpunkt in Ihrem Code verwenden, um ein AIProjectClient-Objekt zu erstellen, das einen programmgesteuerten Proxy für das Projekt bereitstellt, wie in diesem Python-Beispiel gezeigt:

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

project_endpoint = "https://......"
project_client = AIProjectClient(            
    credential=DefaultAzureCredential(),
    endpoint=project_endpoint)

Anmerkung

Der Code verwendet die standardmäßigen Azure-Anmeldeinformationen, um sich beim Zugriff auf das Projekt zu authentifizieren. Um diese Authentifizierung zu aktivieren, müssen Sie zusätzlich zum Azure-ai-projects-Paket das Azure-Identity-Paket installieren:

pip install azure-identity

Trinkgeld

Um erfolgreich auf das Projekt zuzugreifen, muss der Code im Kontext einer authentifizierten Azure-Sitzung ausgeführt werden. Sie können z. B. die Azure-Befehlszeilenschnittstelle (CLI) az-login Befehl verwenden, um sich anzumelden, bevor Sie den Code ausführen.