Trabalhar com conexões de projeto

Cada projeto Microsoft Foundry inclui recursos ligados, que são definidos tanto ao nível principal (recurso ou hub Microsoft Foundry), como ao nível do projeto . Cada recurso é uma ligação a um serviço externo, como Azure storage, Azure AI Search, Azure OpenAI ou outro recurso da Microsoft Foundry.

Com o Microsoft Foundry SDK, pode ligar-se a um projeto e recuperar ligações; que depois podes usar para consumir os serviços ligados.

Por exemplo, o objeto AIProjectClient em Python tem uma propriedade connections , que você pode usar para acessar as conexões de recursos no projeto. Os métodos das conexões objeto incluem:

• connections.list(): Retorna uma coleção de objetos de conexão, cada um representando uma conexão no projeto. Você pode filtrar os resultados especificando um parâmetro connection_type opcional com uma enumeração válida, como ConnectionType.AZURE_OPEN_AI.
• connections.get(connection_name, include_credentials): Retorna um objeto de conexão para a conexão com o nome especificado. Se o parâmetro include_credentials for True (o valor padrão), as credenciais necessárias para conectar à conexão são devolvidas – por exemplo, na forma de uma chave de API para um recurso do "Foundry Tools".

Os objetos de conexão retornados por esses métodos incluem propriedades específicas da conexão, incluindo credenciais, que você pode usar para se conectar ao recurso associado.

O exemplo de código a seguir lista todas as conexões de recursos que foram adicionadas a um projeto:

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)