Add call-center

1.call-center/.gitignore

@@ -0,0 +1,132 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+.github
+.old

1.call-center/README.md

@@ -0,0 +1,194 @@
+# コールセンター向け AI アシスタント
+
+## 概要
+
+コールセンターのスタッフを支援する Microsoft AI の機能を活用したソリューションとなります。機能を拡張しリアルタイムに取得した会話データをストレージやデーターベースに収集する事で、顧客とのコミュニケーション分析の基盤システムへの展開も想定しています。
+
+### 主な機能  
+
+1. リアルタイムに会話の`文字起こし`が出来ます。
+2. 同時に他言語に`翻訳`します。
+3. リアルタイムに会話内容の`感情分析`をします。
+4. 会話が終了した際、全体の会話内容を`要約`し、重要な`トピック`をリストアップします。
+
+### アプリケーション画面
+
+![Demo](assets/demo.jpg)
+
+### クラウド実行環境
+
+WEB アプリケーションを Azure App Service でホストしたソリューション・ダイアグラムとなります。
+
+![Solution](assets/diagram.jpg)
+
+こちらは "検証用途の構成" を示しています。運用環境として構成する場合には後半で示されている "ランディングゾーン構成" をご検討ください。
+
+|  サービス名  |  SKU  | Note |
+| ---- | ---- | ---- |
+| Azure App Service  |  Standard (S1) | Python 3.11 |
+| Azure OpenAI Service |  Standard  | text-davinci-003 |
+| Speech Services |  Standard  | |
+| Language Services |  Standard  | |
+
+## 開発環境の準備
+
+### ローカル開発環境
+
+- Python 3.11
+- Visual Studio Code
+    - Azure App Service 拡張機能 
+    - Python 拡張機能
+
+クラウドに下記サービスがデプロイされている必要があります。
+
+|  サービス名  |  SKU  | Note |
+| ---- | ---- | ---- |
+| Azure OpenAI Service |  Standard  | text-davinci-003 |
+| Speech Services |  Standard  | |
+| Language Services |  Standard  | |
+
+### Azure AI サービス群のデプロイ
+
+[Azure Cloud Shell](https://learn.microsoft.com/ja-jp/azure/cloud-shell/quickstart?tabs=azurecli) から、以下のコマンドを実行する事でデプロイ出来ます。
+
+※ 現時点で OpenAI サービスをデプロイ可能なリージョンが限定されています。利用可能なリージョンの詳細は、[モデルの概要テーブルとリージョンの可用性](https://learn.microsoft.com/ja-jp/azure/cognitive-services/openai/concepts/models#model-summary-table-and-region-availability)をご確認ください。
+
+```bash
+# 環境変数
+export RESOURCE_GROUP=<Your resource group>
+export SPEECHSERVICE_NAME=<Your speech service name>
+export LANGUAGE_SERVICE=<Your language service name>
+export OEPNAI_NAME=<Your OpenAI service name>
+
+export REGION="japaneast"
+export REGION_OPENAI="eastus"
+
+# RESOURCE GROUP
+az group create --location $REGION --resource-group $RESOURCE_GROUP
+
+# SPEECH SERVICE
+az cognitiveservices account create --name $SPEECHSERVICE_NAME --resource-group $RESOURCE_GROUP \
+ --kind SpeechServices --sku S0 --location $REGION --yes
+
+# LANGUAGE_SERVICE
+az cognitiveservices account create --name $LANGUAGE_SERVICE --resource-group $RESOURCE_GROUP \
+ --kind TextAnalytics --sku S --location $REGION --yes
+
+# OPENAI
+az cognitiveservices account create --name $OEPNAI_NAME --resource-group $RESOURCE_GROUP \
+ --kind OpenAI --sku S0 --location $REGION_OPENAI --yes
+```
+
+### 1. アクセス制御 (IAM) の構成
+
+VSCode の Azure 拡張機能で Azure へサインインする事で、サインインしているユーザーがデバッグ実行の際の DefaultAzureCredential となります。 
+
+Azure ポータルで各バックエンドサービスの [アクセス制御 (IAM)] メニューを開き、サインインユーザーに対して以下の権限（ロール）を割り当てます。 
+
+|  サービス名  |  ロール  | 
+| ---- | ---- |
+| Azure OpenAI Service |  Cognitive Services OpenAI User  | 
+| Speech Services |  Cognitive Services Speech ユーザー  |
+| Language Services |  Cognitive Services Language 閲覧者  |
+
+### 2. ローカルデバッグ用の環境変数設定
+
+call-center フォルダ配下の `app` フォルダを VSCode で開きます。`.vscode/launch.json` ファイルで <Your ...> の値を環境に合わせて設定します。
+
+```json
+"env": {
+    "FLASK_APP": "${workspaceFolder}/app.py",
+    "FLASK_DEBUG": "1",
+    "STT_REGION": "<Your Service Region>",
+    "STT_RESOURCE_ID": "/subscriptions/<Your Subscription GUID>/resourceGroups/<Your ResourceGroup Name>/providers/Microsoft.CognitiveServices/accounts/<Your Service Name>",
+    "TEXT_ANALYTICS_ENDPOINT": "https://<Your Service Name>.cognitiveservices.azure.com",
+    "AOAI_ENDPOINT": "https://<Your Service Name>.openai.azure.com",
+    "AOAI_MODEL": "<<Your Model Name>>"
+}
+```
+
+※ `STT_RESOURCE_ID` は、デプロイした Speech Service の [プロパティ] メニューで確認できます。
+
+### 3. モジュールのインストール
+
+```bash
+pip install -r requirements.txt
+```
+
+※ VSCode で textanalytics など一部モジュールの解決が出来ない場合は、Python インタープリタを切り替える事で解決する場合があります。Ctrl+Shift+P または [View] > [Command Palette] メニューから、出てきた検索ウィンドウにPython: Select Interpreterと入力することで設定できます。
+
+### 4. デバッグ実行
+
+VSCode からデバッグ実行を開始します。
+
+Running on http://127.0.0.1:5000
+
+
+## Azure へのデプロイ
+
+### 1. Azure App Servce の作成
+
+[Azure Cloud Shell](https://learn.microsoft.com/ja-jp/azure/cloud-shell/quickstart?tabs=azurecli) から、以下のコマンドを実行します。
+
+```bash
+# 環境変数
+export RESOURCE_GROUP=<Your resource group>
+export APPSERVICE_PLAN=<Your appservice plan>
+export APPSERVICE=<Your appservice>
+
+export REGION="japaneast"
+
+# RESOURCE GROUP
+az group create --location $REGION --resource-group $RESOURCE_GROUP
+
+# APP SERVICE PLAN
+az appservice plan create --name $APPSERVICE_PLAN --resource-group $RESOURCE_GROUP --is-linux --sku S1
+
+# APP SERVICE
+az webapp create --name $APPSERVICE --resource-group $RESOURCE_GROUP --plan $APPSERVICE_PLAN \
+                --runtime PYTHON:3.11 --assign-identity [system] --https-only
+```
+
+### 2. App Service 構成 - 環境変数の設定
+
+Azure ポータルで App Service の [構成] メニューを選択し、開発環境の launch.json に定義してある環境変数を設定します。
+
+![App Service 構成](assets/appservice_configuration.jpg)
+
+
+### 3. アクセス制御 (IAM) の構成
+
+Azure ポータルで、各バックエンドサービスの [アクセス制御 (IAM)] メニューを開き App Service の Managed ID に以下の権限（ロール）を割り当てます。 
+
+|  サービス名  |  ロール  | 
+| ---- | ---- |
+| Azure OpenAI Service |  Cognitive Services OpenAI User  | 
+| Speech Services |  Cognitive Services Speech ユーザー  |
+| Language Services |  Cognitive Services Language 閲覧者  |
+
+### 4. WEB アプリケーションを App Service へデプロイ
+
+VSCode の左側ペインより Azure アイコンを選択し、該当する [App Service] に対して [Deploy to Web App...] にてアプリケーションを展開します。
+
+![Deploy](assets/deploy.jpg)
+
+## ランディングゾーン
+
+完全な閉域構成で利用するためのランディングゾーンとなります。インターネットを経由した外部通信が一切発生しない内部通信のみで利用できる構成となります。
+
+![Landingzone](assets/landing_zone.jpg)
+
+ランディングゾーンで利用する SKU の参考例となります。App Service に関しては SLA の観点で最低2つのインスタンスが必要となります。
+
+|  サービス名  |  SKU  | Note |
+| ---- | ---- | ---- |
+| Azure App Service  |  I1v2  | Python 3.11 |
+| Azure OpenAI Service |  Standard  | text-davinci-003 |
+| Speech Services |  Standard  | |
+| Language Services |  Standard  | |
+
+参考資料：[ハブアンドスポーク ネットワーク内の Azure Private Link](https://learn.microsoft.com/ja-jp/azure/architecture/guide/networking/private-link-hub-spoke-network)
+
+## Credit
+
+Special thanks to [Jixin Jia (Gin)](https://github.com/jixjia) and [Nobu Tanahashi](https://github.com/notanaha) for his ingenious Conversation Transcription source code and idea used in this demo.

1.call-center/app/.vscode/launch.json

@@ -0,0 +1,26 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+
+        {
+            "name": "Python: Flask",
+            "type": "python",
+            "request": "launch",
+            "module": "flask",
+            "env": {
+                "FLASK_APP": "${workspaceFolder}/app.py",
+                "FLASK_DEBUG": "1",
+                "STT_REGION": "<Your Service Region>",
+                "STT_RESOURCE_ID": "/subscriptions/<Your Subscription GUID>/resourceGroups/<Your ResourceGroup Name>/providers/Microsoft.CognitiveServices/accounts/<Your Service Name>",
+                "TEXT_ANALYTICS_ENDPOINT": "https://<Your Service Name>.cognitiveservices.azure.com",
+                "AOAI_ENDPOINT": "https://<Your Service Name>.openai.azure.com",
+                "AOAI_MODEL": "<<Your Model Name>>"
+            },
+            "args": [
+                "run"
+            ],
+            "jinja": true,
+            "justMyCode": true
+        }
+    ]
+}

1.call-center/app/LICENSE

@@ -0,0 +1,22 @@
+    MIT License
+
+    Copyright (c) Jixin Jia (Gin).
+    Copyright (c) 2023 Yuichi Ikeda.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE