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 패키지 중 하나 이상을 설치해야 합니다.

번들 설치

파일에서 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를 설정합니다.

자세한 내용은 애플리케이션 설정 작업을 참조하세요.