Azure OpenAI 웹앱 사용

아티클
05/09/2024

Azure OpenAI Studio, API 및 SDK와 함께 사용 가능한 독립 실행형 웹앱을 사용하여 그래픽 사용자 인터페이스를 사용하여 Azure OpenAI 모델과 상호 작용할 수도 있습니다. 이 인터페이스는 Azure OpenAI 스튜디오 또는 수동 배포를 사용하여 배포할 수 있습니다.

웹앱 인터페이스 스크린샷.

중요 사항

게시하면 구독에 Azure App Service가 만들어집니다. 선택한 계획에 따라 비용이 발생할 수 있습니다. 앱 사용이 완료되면 Azure Portal에서 삭제할 수 있습니다.
gpt-4 비전 미리 보기 모델은 지원되지 않습니다.
기본적으로 앱은 이미 구성된 Microsoft ID 공급자와 함께 배포되어 앱에 대한 액세스를 Azure 테넌트 멤버로 제한합니다. 인증을 추가하거나 수정하려면 다음을 수행합니다.
1. Azure Portal로 이동하여 게시 중에 지정한 앱 이름을 검색합니다. 웹앱을 선택하고 왼쪽 탐색 메뉴에서 인증 탭으로 이동합니다. 그런 다음 ID 공급자 추가를 선택합니다.
2. Microsoft를 ID 공급자로 선택합니다. 이 페이지의 기본 설정은 앱을 테넌트로만 제한하므로 여기에서 다른 항목을 변경할 필요가 없습니다. 그런 다음 추가를 선택합니다.
사용자가 앱에 액세스하려면 Microsoft Entra ID 계정으로 로그인하라는 메시지가 표시됩니다. 원하는 경우 유사한 프로세스에 따라 다른 ID 공급자를 추가할 수 있습니다. 앱은 사용자가 테넌트의 멤버인지 확인하는 것 이외의 다른 방법으로 사용자의 로그인 정보를 사용하지 않습니다.

웹앱 사용자 지정

앱의 프런트 엔드 및 백 엔드 논리를 사용자 지정할 수 있습니다. 앱은 앱의 아이콘 변경과 같은 일반적인 사용자 지정 시나리오에 몇 가지 환경 변수를 제공합니다. 웹앱의 소스 코드와 자세한 내용은 GitHub을 참조하세요.

앱을 사용자 지정할 때 다음을 권장합니다.

사용자가 설정을 변경하면 채팅 세션을 초기화합니다(채팅 지우기). 사용자에게 채팅 기록이 손실된다는 사실을 알립니다.
구현하는 각 설정이 사용자 환경에 미치는 영향을 명확하게 전달합니다.
Azure OpenAI 또는 Azure AI Search 리소스에 대한 API 키를 회전하는 경우 새 키를 사용하도록 배포된 각 앱에 대한 앱 설정을 업데이트해야 합니다.

웹앱에 대한 샘플 소스 코드는 GitHub에서 사용할 수 있습니다. 소스 코드는 "있는 그대로" 샘플로만 제공됩니다. 고객은 웹앱의 모든 사용자 지정 및 구현을 담당합니다.

웹앱 업데이트

참고 항목

2024년 2월 1일 이후에 웹앱은 앱 시작 명령을 python3 -m gunicorn app:app으로 설정해야 합니다. 2024년 2월 1일 이전에 게시된 앱을 업데이트하는 경우 App Service 구성 페이지에서 시작 명령을 수동으로 추가해야 합니다.

웹앱의 소스 코드에 대한 main 분기에서 변경 내용을 자주 끌어와 최신 버그 수정, API 버전 및 개선 사항을 갖추는 것이 좋습니다. 또한 사용 중인 API 버전이 사용 중지될 때마다 웹앱을 동기화해야 합니다.

웹앱의 GitHub 리포지토리에서 watch 또는 star 단추를 클릭하여 소스 코드의 변경 및 업데이트에 대한 알림을 받을 수 있습니다.

앱을 사용자 지정하지 않은 경우:

아래 동기화 단계를 따를 수 있습니다.

앱의 소스 코드를 사용자 지정하거나 변경한 경우:

앱의 소스 코드를 수동으로 업데이트하고 다시 배포해야 합니다.
- 앱이 GitHub에서 호스트되는 경우 코드 변경 내용을 리포지토리에 푸시하고 아래 동기화 단계를 사용합니다.
- 앱을 수동으로 다시 배포하는 경우(예: Azure CLI) 배포 전략의 단계를 따릅니다.

웹앱 동기화

앱을 사용자 지정한 경우 앱의 소스 코드를 업데이트합니다.
Azure Portal에서 해당 웹앱으로 이동합니다.
탐색 메뉴의 배포 아래에서 배포 센터를 선택합니다.
화면 맨 위에서 동기화를 선택하고 앱이 다시 배포되는지 확인합니다.

채팅 기록

웹앱 사용자에 대해 채팅 기록을 사용하도록 설정할 수 있습니다. 이 기능을 사용하도록 설정하면 사용자는 이전의 개별 쿼리 및 응답에 액세스할 수 있습니다.

채팅 기록을 사용하도록 설정하려면 Azure OpenAI Studio를 사용하여 모델을 웹앱으로 배포하거나 다시 배포합니다.

Important

채팅 기록을 사용하도록 설정하면 리소스 그룹에 Cosmos DB 인스턴스가 생성되고 사용된 스토리지에 대한 추가 요금이 발생합니다.

채팅 기록을 사용하도록 설정하면 앱의 오른쪽 위 모서리에서 채팅 기록을 표시 및 숨길 수 있습니다. 기록이 표시되면 대화의 이름을 바꾸거나 삭제할 수 있습니다. 앱에 로그인하면 대화가 자동으로 최신에서 가장 오래된 것까지 정렬되고 대화의 첫 번째 쿼리에 따라 이름이 지정됩니다.

Cosmos DB 인스턴스 삭제

웹앱을 삭제해도 Cosmos DB 인스턴스가 자동으로 삭제되지는 않습니다. 모든 저장된 채팅과 함께 Cosmos DB 인스턴스를 삭제하려면 Azure Portal에서 연결된 리소스로 이동한 후 삭제해야 합니다. Cosmos DB 리소스를 삭제하지만 스튜디오에서 채팅 기록 옵션을 사용하도록 설정한 상태로 유지하면 연결 오류 알림이 표시되지만 채팅 기록에 액세스하지 않고 웹앱을 계속 사용할 수 있습니다.

다음을 통해 공유