https://github.com/karamem0/commistant
Commistant は Microsoft Teams 会議によるコミュニティ イベントをサポートするアシスタント ボットです。
https://github.com/karamem0/commistant
azure-openai-service function-calling m365dev microsoft-teams microsoft-teams-app microsoft-teams-bot microsoft-teams-meeting productivity react teams-app
Last synced: 4 months ago
JSON representation
Commistant は Microsoft Teams 会議によるコミュニティ イベントをサポートするアシスタント ボットです。
- Host: GitHub
- URL: https://github.com/karamem0/commistant
- Owner: karamem0
- License: mit
- Created: 2022-02-09T12:37:16.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2026-01-29T05:16:59.000Z (4 months ago)
- Last Synced: 2026-01-29T20:12:24.815Z (4 months ago)
- Topics: azure-openai-service, function-calling, m365dev, microsoft-teams, microsoft-teams-app, microsoft-teams-bot, microsoft-teams-meeting, productivity, react, teams-app
- Language: C#
- Homepage:
- Size: 16.1 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Commistant
Commistant は Microsoft Teams 会議によるコミュニティ イベントをサポートするアシスタント ボットです。
[](https://github.com/karamem0/commistant/actions/workflows/trigger-on-main.yml)
[](https://codecov.io/gh/karamem0/commistant)
[](https://github.com/karamem0/commistant/blob/main/LICENSE)
## 機能
Commistant は会議の開始時、終了時、または会議中に定型のメッセージ通知を送信します。通知にはテキストおよび QR コードつきの URL を添付することができます。
## プレビュー
## 利用シーン
新型コロナウイルスの流行によりコミュニティ イベントはオンライン開催することが主流になりました。開催者は参加者に対して定型のメッセージを送ることがありますが、定期的にメッセージを送ることは開催者の負担となります。Commistant を使うことで、会議中に slido などの Q&A サービスに誘導することや、会議の最初や最後にアンケートの URL を送ることなどが簡単に実現できるようになります。
## インストール方法
### Microsoft Entra ID アプリケーションの登録
1. [Azure ポータル](https://portal.azure.com) に移動します。
2. **≡** - **Microsoft Entra ID** をクリックします。
3. **アプリの登録** - **新規登録** をクリックします。
4. 情報を入力して **登録** をクリックします。
|項目|値|
|-|-|
|名前|Commistant|
|サポートされているアカウントの種類|シングル テナント|
5. **証明書とシークレット** をクリックしてシークレットを追加します。
6. **API の公開** をクリックしてスコープとクライアント アプリケーションを追加します。
**スコープ**
|項目|値|
|-|-|
|アプリケーション ID URL|api://**Azure Web アプリ のドメイン名**/**アプリケーション ID**|
|スコープ名|user_impersonation|
|同意できるユーザー|管理者とユーザー|
|管理者の同意の表示名|Commistant へのアクセス|
|管理者の同意の説明|サインインしたユーザーの代わりに Commistant にアクセスすることをアプリケーションに許可します。|
|ユーザーの同意の表示名|Commistant へのアクセス|
|ユーザーの同意の説明|サインインしたユーザーの代わりに Commistant にアクセスすることをアプリケーションに許可します。|
|状態|有効|
**クライアント アプリケーション**
|アプリケーション|スコープ|
|-|-|
|1fec8e78-bce4-4aaf-ab1b-5451cc387264|user_impersonation|
|5e3ce6c0-2b1f-4285-8d4b-75ee78787346|user_impersonation|
### Azure リソースの作成
1. Azure CLI でリソースをデプロイします。
```
az deployment group create --template-file ./bicep/main.bicep --resource-group <リソース グループ名> --parameters name=<アプリケーション名> microsoftAppId=<アプリケーション ID> microsoftAppPassword=<アプリケーション シークレット> microsoftAppTenantId=<テナント ID>
```
### アプリケーションのビルド
#### Web アプリ
1. `source/client` フォルダーに移動します。
2. `.env` ファイルを編集します。
|プレースホルダー|置換|
|-|-|
|`{{AZURE_FUNCTION_APP_DOMAIN_NAME}}`|**関数アプリのドメイン名**|
|`{{VITE_TELEMETRY_CONNECTION_STRING}}`|**Application Insights の接続文字列**|
3. `source/server/Karamem0.Commistant.Web` フォルダーに移動します。
4. アプリケーションをビルドします。
```
dotnet publish --configuration Release
```
5. `publish` フォルダーの中身を圧縮します。
```
Compress-Archive -Path ./bin/Release/net10.0/publish/* -DestinationPath ../../build.zip
```
6. Azure CLI で ZIP ファイルをアップロードします。
```
az webapp deploy --name --resource-group <リソース グループ名> --src-path
```
#### 関数アプリ
1. `source/server/Karamem0.Commistant.Function` フォルダーに移動します。
2. アプリケーションをビルドします。
```
dotnet publish --configuration Release
```
2. `publish` フォルダーの中身を圧縮します。
```
Compress-Archive -Path ./bin/Release/net10.0/publish/* -DestinationPath ../../build.zip
```
3. Azure CLI で ZIP ファイルをアップロードします。
```
az webapp deploy --name <関数アプリの名前> --resource-group <リソース グループ名> --src-path
```
### マニフェストのアップロード
1. `manifest` フォルダーに移動します。
2. `manifest.json` ファイルを編集します。
|プレースホルダー|置換|
|-|-|
|`{{AZURE_WEB_APP_DOMAIN_NAME}}`|**Web アプリのドメイン名**|
|`{{MICROSOFT_TEAMS_APP_ID}}`|**アプリケーション ID**|
|`{{MICROSOFT_365_AGENT_ID}}`|**アプリケーション ID**|
3. `manifest` フォルダーの中身を圧縮します。
```
Compress-Archive -Path ./* -DestinationPath ../manifest.zip
```
4. [Microsoft Teams 管理センター](https://admin.teams.microsoft.com/) に移動します。
5. **Teams のアプリ** - **アプリを管理** をクリックします。
6. **アップロード** をクリックして `manifest.zip` を選択します。
## 使用方法
### コマンドによる設定
事前に通知する内容を設定します。**@Commistant** と入力するとコマンドの一覧が表示されます。
|コマンド名|説明|
|-|-|
|会議開始後|会議が開始した後に通知する内容を設定します。|
|会議終了前|会議が終了する前に通知する内容を設定します。|
|会議中|会議中に通知する内容を設定します。|
|初期化|この会議のすべての設定を初期状態に戻します。|
#### 会議開始後
会議の開始時刻の後に 1 回だけ通知を送信します。
**@Commistant 会議開始後** と入力すると設定を変更できます。
|項目|内容|
|-|-|
|スケジュール|通知するタイミングを指定します。|
|メッセージ|送信するメッセージを指定します。|
|URL|送信する URL を指定します。|
スケジュールの選択肢は以下の通りです。
|項目|内容|
|-|-|
|なし|通知を送信しません。|
|予定時刻|スケジュールで設定されている開始時刻に送信します。|
|5 分後|スケジュールで設定されている開始時刻の 5 分後に送信します。|
|10 分後|スケジュールで設定されている開始時刻の 10 分後に送信します。|
|15 分後|スケジュールで設定されている開始時刻の 15 分後に送信します。|
#### 会議終了前
会議の終了時刻の前に 1 回だけ通知を送信します。
**@Commistant 会議終了前** と入力すると設定を変更できます。
|項目|内容|
|-|-|
|スケジュール|通知するタイミングを指定します。|
|メッセージ|送信するメッセージを指定します。|
|URL|送信する URL を指定します。|
スケジュールの選択肢は以下の通りです。
|項目|内容|
|-|-|
|なし|通知を送信しません。|
|予定時刻|スケジュールで設定されている終了時刻に送信します。|
|5 分後|スケジュールで設定されている終了時刻の 5 分前に送信します。|
|10 分後|スケジュールで設定されている終了時刻の 10 分前に送信します。|
|15 分後|スケジュールで設定されている終了時刻の 15 分前に送信します。|
#### 会議中
会議中に繰り返し通知を送信します。
**@Commistant 会議中** と入力すると設定を変更できます。
|項目|内容|
|-|-|
|スケジュール|通知するタイミングを指定します。|
|メッセージ|送信するメッセージを指定します。|
|URL|送信する URL を指定します。|
スケジュールの選択肢は以下の通りです。
|項目|内容|
|-|-|
|なし|通知を送信しません。|
|15 分|スケジュールで設定されている開始時刻から 15 分おきに送信します。|
|30 分|スケジュールで設定されている開始時刻から 30 分おきに送信します。|
|60 分|スケジュールで設定されている開始時刻から 60 分おきに送信します。|
#### 初期化
この会議のすべての設定を初期化します。
**@Commistant 初期化** と入力すると初期化できます。
### AI による設定
特定のコマンド以外でもチャットの内容を AI に理解させて設定を変更できます。いくつか例を示します。
- 会議開始後 5 分経ったら「こんにちは」と表示してください。
- 会議中 30 分おきに「アンケートにご協力ください」と表示してください。URL は「`https://www.example.com`」です。
- 設定を初期化してください。
### タブによる設定
チャットによる設定変更のほかにタブを使用して設定を変更できます。
## 注意事項
- 設定は会議ごとに識別されます。複数日にわたるイベントで会議が別になる場合はそれぞれに設定してください。
- 参加者が途中で退出した場合は通知が参加者に表示されない場合があります。
# 素材
アプリで使用している素材は [unDraw](https://undraw.co/illustrations) にライセンスされています。