AOAI WebApp SDKv1

Azure OpenAI 통합이 포함된 Python Flask 웹앱

이 가이드에서는 Azure Web App에 대한 Azure OpenAI의 GPT 통합을 통해 최소한의 Flask 애플리케이션을 배포하는 과정을 안내합니다.

1단계. Azure OpenAI에서 GPT 모델 프로비저닝:

• Azure OpenAI/AI Studio에서 필요한 GPT-x 모델을 배포합니다.
• Azire OpenAI 리소스의 엔드포인트, GPT 모델의 배포 이름 및 사용하려는 API 버전을 기록해 두세요.

2단계. Azure 웹앱 리소스 준비:

• Azure에서 새 웹앱을 만들고 Python을 대상 언어 플랫폼으로 선택합니다.
• 웹앱의 환경 변수 설정에서 다음 변수를 만들고 1단계에서 수집한 값으로 설정합니다. AZURE_OPENAI_API_BASE , AZURE_OPENAI_API_DEPLOY 및 AZURE_OPENAI_API_VERSION .
• 웹 앱의 환경 변수 설정에서 SCM_DO_BUILD_DURING_DEPLOYMENT 변수를 만들고 해당 값을 " true "로 설정합니다.

참고: SCM_DO_BUILD_DURING_DEPLOYMENT 설정은 웹 앱이 제공된 요구사항.txt 파일에 나열된 필수 Python 패키지를 다운로드하도록 보장합니다.

• 올바르게 설정된 경우 웹 앱 설정은 다음과 유사해야 합니다.

3단계. 인증 구성:

• 웹앱의 ID 설정에서 시스템 할당 관리 ID의 상태를 ON 으로 설정합니다.

참고: 이 데모에서는 관리 ID로 인증하는 방법을 보여줍니다. 다른 잠재적 옵션에 대한 구현 세부 정보는 여기에서 확인할 수 있습니다.

• Azure OpenAI의 IAM(액세스 제어) 설정에서 웹앱의 관리 ID를 Cognitive Services OpenAI 사용자 역할에 할당합니다.

4단계. Flask 웹 앱 배포:

• 제공된 app.py , requirements.txt 및 static 폴더와 templates 폴더의 콘텐츠(총 4개 파일)를 ZIP으로 압축하세요.
• 다음 Azure CLI 명령을 사용하여 ZIP 파일을 배포합니다. 올바른 리소스 그룹, 웹앱 및 ZIP 파일 이름을 사용하고 있는지 확인하세요.

az webapp deploy --resource-group < Web_App_RG > --name < Web_App_Name > --src-path < Source_ZIP_file >

• 2단계에서 "배포 중 빌드"를 활성화했으므로 웹앱 로그에서 필요한 Python 패키지를 대상 Python 가상 환경으로 가져온 것을 확인할 수 있습니다.

5단계. 웹 앱 UI:

• Flask 웹 앱의 홈 페이지는 매우 단순합니다. 질문을 입력하고 질문 버튼을 클릭하면 웹 앱이 웹 페이지에 새로운 질문/답변 쌍을 추가합니다.