次世代のコラボレーション！Microsoft TeamsにChatGPTを組み込む方法

<a href="https://azure-recipe.kc-cloud.jp/chatgpt_teams_transform/">以前の記事「TeamsにChatGPTを組み込むことで起こる業務変革4選」</a>では、Microsoft TeamsにChatGPTを組み込むことで生じる業務変革について説明しました。この度は、具体的な実装方法に焦点を当て、どのようにしてMicrosoft TeamsにChatGPTを組み込むかについて解説します。

本記事では、Microsoft Graph APIとPythonを活用し、Microsoft Teams内でChatGPTを活用する手順について説明します。この実装を通じて、社内コミュニケーションや業務効率の向上を実現することができます。

しかし、実装にはいくつかの課題や困難が伴います。それらに対処するために、適切なリソースやツールを利用することが重要です。本記事では、これらの課題にどのように対処するか、実践的な解決方法についても紹介していきます。

まず、実装にあたってMicrosoft Graph APIを利用する際の注意点やドキュメントの入手方法について触れます。その後、実際の実装プロセスについて、手順を追って説明していきます。また、途中で遭遇するであろう課題や問題に対処するためのアプローチについても取り上げます。

最後に、実装後に期待できる効果や改善点について検証し、今後の展望について言及します。これにより、Microsoft TeamsにChatGPTを組み込むことが、企業や組織にとってどのような価値をもたらすか、具体的なイメージを持つことができるでしょう。

それでは、次の章から具体的な手順について説明していきます。本記事を参考に、Microsoft TeamsにChatGPTを組み込み、業務効率やコミュニケーションの向上を実現しましょう。
<h2>はじめに</h2>
本記事では、OpenAI APIを利用して、Microsoft TeamsにChatGPTを組み込む方法を解説します。これにより、社内の様々な業務でChatGPTが役立ちます。以下の2つの内容について説明します。
なお、実際のコードを含めると非常に長くなるため、流れを解説します。
<ol>
 	<li>Microsoft Graphを使うための準備</li>
 	<li>プログラム概要
<ol>
 	<li>TeamsからChatGPTの回答をユーザーに対して投稿</li>
 	<li>Teamsに投稿される事をトリガーに処理実施</li>
 	<li>Teamsに投稿された内容を取得</li>
 	<li>回答への返信に対して更に投稿</li>
</ol>
</li>
</ol>
<h2>Microsoft Graphを使うためのAzure AD設定手順</h2>
Microsoft Graph APIを活用するためには、まずAzure Active Directory (Azure AD) でアプリケーションを登録し、適切な設定を行う必要があります。本章では、Azure ADの設定手順をわかりやすく説明します。

<img src="https://azure-recipe.kc-cloud.jp/wp-content/uploads/2023/04/graph.png" alt="" width="1006" height="259" class="alignnone size-full wp-image-18990" />
<ol>
 	<li>Azureポータルへのログイン Azure ADの設定を行うには、まずAzureポータル (<a href="https://portal.azure.com/" target="_new" rel="noopener">https://portal.azure.com</a>) にアクセスし、Microsoftアカウントでログインしてください。</li>
 	<li>Azure Active Directoryの選択 Azureポータルの左側のメニューから、「Azure Active Directory」をクリックしてください。</li>
 	<li>アプリの登録 「アプリの登録」タブを選択し、画面右上の「新しい登録」ボタンをクリックします。</li>
 	<li>アプリケーションの詳細を入力 以下の情報を入力し、画面下部の「登録」ボタンをクリックします。</li>
</ol>
<ol></ol>
<ul>
 	<li style="list-style-type: none;">
<ul>
 	<li>名前: アプリケーションの名前を入力（例: "TeamsChatGPTIntegration"）</li>
 	<li>サポートされているアカウントの種類: 組織ディレクトリのアカウント（例: "この組織ディレクトリ専用 - {your-organization-name} のみ"）</li>
 	<li>リダイレクトURI: 必要に応じてリダイレクトURIを設定（例: "<a href="https://localhost%22%29/" target="_new" rel="noopener">https://localhost"）</a></li>
</ul>
</li>
</ul>
<ol start="5">
 	<li>APIアクセス権の付与 アプリ登録後、「APIアクセス権」タブを選択し、「APIアクセス権の追加」ボタンをクリックします。</li>
 	<li>APIアクセス権の選択 「APIの選択」ウィンドウで、「Microsoft Graph」を選択し、「選択」ボタンをクリックします。</li>
 	<li>アクセス権の選択 「アクセス権の選択」ウィンドウで、「デリゲートされたアクセス権」または「アプリケーションアクセス権」タブを選択し、必要なアクセス権を選択して「追加」ボタンをクリックします。
<ul start="5">
 	<li>「デリゲートされたアクセス権」として以下を付与
<ul start="5">
 	<li>Chat.Read（チャットの読み取り）</li>
 	<li>Chat.ReadWrite（チャットの読み書き）</li>
 	<li>ChannelMessage.Read.All（すべてのチャネルメッセージの読み取り）</li>
 	<li>ChannelMessage.Send（チャネルメッセージの送信）</li>
</ul>
</li>
 	<li>設定の保存 「APIアクセス権」タブに戻り、画面下部の「保存」ボタンをクリックして設定を保存します。</li>
</ul>
</li>
 	<li>クライアントIDとシークレットの取得 「概要」タブを選択し、以下の情報をメモしておきます。</li>
</ol>
<ul>
 	<li style="list-style-type: none;">
<ul>
 	<li>アプリケーション (クライアント) ID: これは、アプリケーションを一意に識別するIDです。後でAPIリクエストを行う際に使用します。</li>
 	<li>ディレクトリ (テナント) ID: これは、Azure ADテナントを一意に識別するIDです。後でAPIリクエストを行う際に使用します。</li>
</ul>
</li>
</ul>
<ol start="9">
 	<li>クライアントシークレットの生成 「証明書とシークレット」タブを選択し、「新しいクライアントシークレット」ボタンをクリックします。</li>
 	<li>クライアントシークレットの詳細を入力 以下の情報を入力し、画面下部の「追加」ボタンをクリックします。</li>
</ol>
<ul>
 	<li style="list-style-type: none;">
<ul>
 	<li>説明: クライアントシークレットの説明（例: "ChatGPT Integration Secret"）</li>
 	<li>有効期間: シークレットの有効期間を選択（例: "1年間"）</li>
</ul>
</li>
</ul>
<ol start="10">
 	<li>クライアントシークレットの取得 生成されたクライアントシークレットの値をメモしておきます。後でAPIリクエストを行う際に使用します。注意: この値は、生成直後にしか表示されません。ページを離れると取得できなくなるため、必ずメモしておいてください。</li>
</ol>
<h2>Pythonを使ったTeams⇔OpenAI実装</h2>
Subscriptionを登録することで、指定したチャネルの更新情報を取得しています。Subscriptionの有効期限は1時間程度しかなく頻繁に更新する必要があります。他には一定時間間隔で取得する方法もありますが1回あたり0.1円（1ヶ月で4000円以上）発生し、さらにメッセージ取得分なども含めると数万円発生する可能性が高いです。

また、Subscriptionの更新をするためにはAccess Tokenが必要ですが、同じく1時間程度しか有効期限がないための対応方法が見つかりませんでした。<code>acquire_token_by_authorization_code</code>メソッドの戻り値にRefresh tokenが含まれていることがわかり、Refresh tokenを使ってAccess Tokenを更新させることで、無事動作させることが出来ました。
<ol>
 	<li>Access tokenの取得 <code>msal</code>ライブラリを利用して、Azure ADからAccess tokenを取得します。<code>msal.ConfidentialClientApplication</code>を使用して、アプリケーションのインスタンスを作成し、<code>acquire_token_by_authorization_code</code>メソッドを呼び出すことで、Access tokenとRefresh tokenが取得できます。</li>
 	<li>Access tokenの更新 Access tokenは通常1時間の有効期限があります。そのため、<code>refresh_token</code>を使って定期的にAccess tokenを更新することが必要です。</li>
 	<li>Microsoft Graphのsubscription Microsoft Graph APIを使って、Teamsチャネルの更新情報を取得するために、subscriptionを作成します。これにより、指定したチャネルで新しいメッセージが投稿されるたびに、通知が送られます。</li>
 	<li>通知の受信 設定したWebhookのエンドポイントに通知が送られます。通知が届いたら、チャネルからメッセージを取得するために、Microsoft Graph APIを使って、そのメッセージの詳細を取得します。</li>
 	<li>ChatGPTに投げる 取得したメッセージを、GPT-4に投げて解析や回答を求めます。OpenAI APIを使って、メッセージをGPT-4に送信し、生成された結果を受け取ります。</li>
 	<li>結果をTeamsに投稿 GPT-4から受け取った結果を、Microsoft Teamsのチャネルに投稿します。Microsoft Graph APIを使って、チャネルにメッセージを投稿するリクエストを行います。</li>
</ol>
この手順を踏むことで、Microsoft TeamsとChatGPTを統合し、チャネル内でのコミュニケーションや業務効率の向上が実現できます。これにより、情報検索や意思決定、新入社員のオンボーディング支援など、さまざまな業務効率化が期待できます。

さらにユーザーからの投稿に対して、投稿が届いたことを確認するいいね「👍」でのリアクション、返信に対してさらに回答などを組み込むことでユーザビリティをあげる事が出来ます。
<h2>まとめ</h2>
<span>本記事では、Microsoft TeamsとChatGPTを統合する方法について、具体的な実装方法を解説しました。Azure ADの設定手順やPythonを使用した実装プロセスについて詳しく説明し、さらに潜在的な課題や問題への対処法も紹介しました。記事を参考に、Microsoft TeamsにChatGPTを組み込んで業務効率やコミュニケーションの向上を実現しましょう。また、ユーザビリティを向上させるために、リアクションや返信に対する追加の回答などを組み込むことも検討してください。</span>