Arbeiten mit Projektverbindungen

Jedes Microsoft Foundry-Projekt enthält verbundene Ressourcen, die sowohl auf der übergeordneten Ebene (Microsoft Foundry-Ressource oder Hubebene) als auch auf Projektebene definiert sind. Jede Ressource ist eine Verbindung mit einem externen Dienst, z. B. Azure Storage, Azure AI Search, Azure OpenAI oder eine andere Microsoft Foundry-Ressource.

Mit dem Microsoft Foundry SDK können Sie eine Verbindung mit einem Projekt herstellen und Verbindungen abrufen. die Sie dann verwenden können, um die verbundenen Dienste zu nutzen.

Beispielsweise verfügt das AIProjectClient-Objekt in Python über eine Connections-Eigenschaft , die Sie verwenden können, um auf die Ressourcenverbindungen im Projekt zuzugreifen. Zu den Methoden der Verbindungen Objekts gehören:

• connections.list(): Gibt eine Auflistung von Verbindungsobjekten zurück, die jeweils eine Verbindung im Projekt darstellen. Sie können die Ergebnisse filtern, indem Sie einen optionalen connection_type-Parameter mit einer gültigen Aufzählung angeben, z. B. ConnectionType.AZURE_OPEN_AI.
• connections.get(connection_name, include_credentials): Gibt ein Verbindungsobjekt für die Verbindung mit dem angegebenen Namen zurück. Wenn der parameter "include_credentials" "True" ist (Standardwert), werden die zum Herstellen einer Verbindung erforderlichen Anmeldeinformationen zurückgegeben , z. B. in Form eines API-Schlüssels für eine Ressource "Foundry Tools".

Die von diesen Methoden zurückgegebenen Verbindungsobjekte umfassen verbindungsspezifische Eigenschaften, einschließlich Anmeldeinformationen, die Sie zum Herstellen einer Verbindung mit der zugehörigen Ressource verwenden können.

Im folgenden Codebeispiel werden alle Ressourcenverbindungen aufgelistet, die einem Projekt hinzugefügt wurden:

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

try:

    # Get project client
    project_endpoint = "https://....."
    project_client = AIProjectClient(            
            credential=DefaultAzureCredential(),
            endpoint=project_endpoint,
        )
    
    ## List all connections in the project
    connections = project_client.connections
    print("List all connections:")
    for connection in connections.list():
        print(f"{connection.name} ({connection.type})")

except Exception as ex:
    print(ex)