Trabalhar com conexões de projeto

Cada projeto do Microsoft Foundry inclui recursos conectados, que são definidos no nível pai (recurso ou hub do Microsoft Foundry) e no nível do projeto . Cada recurso é uma conexão com um serviço externo, como armazenamento do Azure, Azure AI Search, Azure OpenAI ou outro recurso do Microsoft Foundry.

Com o SDK do Microsoft Foundry, você pode se conectar a um projeto e recuperar conexões; que você pode usar para consumir os serviços conectados.

Por exemplo, o objeto AIProjectClient no Python tem uma propriedade de conexões , que você pode usar para acessar as conexões de recurso no projeto. Os métodos do objeto conexões 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 a conexão serão retornadas 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 recurso 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)