Utiliser des connexions de projet

Effectué

Chaque projet Microsoft Foundry inclut des ressources connectées, qui sont définies à la fois au niveau parent (ressource Microsoft Foundry ou hub) et au niveau du projet . Chaque ressource est une connexion à un service externe, tel que stockage Azure, Recherche Azure AI, Azure OpenAI ou une autre ressource Microsoft Foundry.

Capture d’écran de la page des ressources connectées dans le portail Microsoft Foundry.

Avec le Kit de développement logiciel (SDK) Microsoft Foundry, vous pouvez vous connecter à un projet et récupérer des connexions ; que vous pouvez ensuite utiliser pour consommer les services connectés.

Par exemple, l’objet AIProjectClient dans Python a une propriété de connexion , que vous pouvez utiliser pour accéder aux connexions de ressources dans le projet. Les méthodes des connexions objet sont les suivantes :

  • connections.list(): retourne une collection d’objets de connexion, chacune représentant une connexion dans le projet. Vous pouvez filtrer les résultats en spécifiant un paramètre connection_type facultatif avec une énumération valide, par exemple ConnectionType.AZURE_OPEN_AI.
  • connections.get(connection_name, include_credentials): retourne un objet de connexion pour la connexion avec le nom spécifié. Si le paramètre include_credentials a la valeur True (valeur par défaut), les informations d’identification requises pour se connecter à la connexion sont retournées, par exemple sous la forme d’une clé API pour une ressource Foundry Tools.

Les objets de connexion retournés par ces méthodes incluent des propriétés spécifiques à la connexion, y compris les informations d’identification, que vous pouvez utiliser pour vous connecter à la ressource associée.

L’exemple de code suivant répertorie toutes les connexions de ressources qui ont été ajoutées à un projet :

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)