프로젝트 연결 작업

  • 5분

각 Microsoft Foundry 프로젝트에는 부모(Microsoft Foundry 리소스 또는 허브) 수준과 프로젝트 수준에서 모두 정의된 연결된 리소스가 포함됩니다. 각 리소스는 Azure Storage, Azure AI Search, Azure OpenAI 또는 다른 Microsoft Foundry 리소스와 같은 외부 서비스에 대한 연결 입니다.

Microsoft Foundry 포털의 연결된 리소스 페이지 스크린샷

Microsoft Foundry SDK를 사용하면 프로젝트에 연결하고 연결을 검색할 수 있습니다. 그러면 연결된 서비스를 사용하는 데 사용할 수 있습니다.

예를 들어 Python의 AIProjectClient 개체에는 프로젝트의 리소스 연결에 액세스하는 데 사용할 수 있는 연결 속성이 있습니다. 연결 개체의 메서드는 다음과 같습니다.

  • connections.list(): 프로젝트의 연결을 나타내는 연결 개체의 컬렉션을 반환합니다. 같은 유효한 열거형을 사용하여 선택적 ConnectionType.AZURE_OPEN_AI 매개 변수를 지정하여 결과를 필터링할 수 있습니다.
  • connections.get(connection_name, include_credentials): 지정된 이름의 연결에 대한 연결 개체를 반환합니다. include_credentials 매개 변수가 True(기본값)이면 연결에 연결하는 데 필요한 자격 증명(예: Foundry Tools 리소스에 대한 API 키 형식)이 반환됩니다.

이러한 메서드에서 반환된 연결 개체에는 연결된 리소스에 연결하는 데 사용할 수 있는 자격 증명을 비롯한 연결 관련 속성이 포함됩니다.

다음 코드 예제에서는 프로젝트에 추가된 모든 리소스 연결을 나열합니다.

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)