Azure Functions용 Azure OpenAI 확장
Important
Azure Functions용 Azure OpenAI 확장은 현재 미리 보기 상태입니다.
Azure Functions용 Azure OpenAI 확장은 Azure OpenAI Service의 기능과 동작을 함수 코드 실행에 쉽게 통합할 수 있는 트리거 및 바인딩 집합을 구현합니다.
Azure Functions는 다른 Azure 서비스와 쉽게 연결할 수 있도록 일련의 트리거 및 바인딩을 제공하는 이벤트 기반 컴퓨팅 서비스입니다.
Azure OpenAI와 Functions 간의 통합을 통해 다음을 수행할 수 있는 함수를 빌드할 수 있습니다.
작업 | 트리거/바인딩 형식 |
---|---|
콘텐츠 완성을 위해 표준 텍스트 프롬프트 사용 | Azure OpenAI 텍스트 완성 입력 바인딩 |
도우미 요청에 응답하여 함수 호출 | Azure OpenAI 도우미 트리거 |
도우미 만들기 | Azure OpenAI 도우미가 출력 바인딩 만들기 |
도우미에게 메시지 보내기 | Azure OpenAI 도우미 사후 입력 바인딩 |
도우미 기록 가져오기 | Azure OpenAI 도우미 쿼리 입력 바인딩 |
텍스트 embedding 읽기 | Azure OpenAI embedding 입력 바인딩 |
벡터 데이터베이스에 쓰기 | Azure OpenAI embedding 출력 저장 바인딩 |
벡터 데이터베이스에서 읽기 | Azure OpenAI 의미 체계 검색 입력 바인딩 |
확장 설치
설치하는 확장 NuGet 패키지는 함수 앱에서 사용 중인 C# 모드 진행 중 또는 격리된 작업자 프로세스에 따라 달라집니다.
.NET CLI를 사용하여 수행할 수 있는 Microsoft.Azure.Functions.Worker.Extensions.OpenAI NuGet 패키지를 설치하여 프로젝트에 Azure OpenAI 확장을 추가합니다.
dotnet add package Microsoft.Azure.Functions.Worker.Extensions.OpenAI --prerelease
콘텐츠를 저장하기 위해 벡터 데이터베이스를 사용하는 경우 다음 NuGet 패키지 중 하나 이상을 설치해야 합니다.
- Azure AI Search: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.AzureAISearch
- Azure Cosmos DB for MongoDB: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.CosmosDBSearch
- Azure Data Explorer: Microsoft.Azure.Functions.Worker.Extensions.OpenAI.Kusto
번들 설치
파일에서 host.json
다음 코드를 추가하거나 바꿔 미리 보기 확장을 추가할 수 있습니다. 이 코드는 특히 OpenAI 확장이 포함된 4.x 번들의 미리 보기 버전을 대상으로 합니다.
{
"version": "2.0",
"extensionBundle": {
"id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
"version": "[4.*, 5.0.0)"
}
}
애플리케이션 설정
Azure OpenAI 바인딩 확장을 사용하려면 OpenAI 리소스에 연결하는 데 사용되는 이러한 설정 중 하나 이상을 추가해야 합니다. 로컬 개발 중에 이러한 설정을 파일에 추가해야 합니다 local.settings.json
.
설정 이름 | 설명 |
---|---|
AZURE_OPENAI_ENDPOINT |
필수입니다. 바인딩에서 사용하는 OpenAI 리소스의 엔드포인트를 설정합니다. |
AZURE_OPENAI_KEY |
Azure OpenAI 리소스에 액세스하는 데 사용되는 키를 설정합니다. |
OPENAI_API_KEY |
비 Azure OpenAI 리소스에 액세스하는 데 사용되는 키를 설정합니다. |
AZURE_CLIENT_ID |
Azure OpenAI 리소스에 액세스하는 데 사용되는 사용자 할당 관리 ID를 설정합니다. |
자세한 내용은 애플리케이션 설정 작업을 참조하세요.