このチュートリアルでは、Google Chat で リアルタイムでインシデントに対応しますインシデントに対応する際、アプリは Chat スペースを作成して入力し、インシデントが メッセージ、スラッシュ コマンド、ダイアログで解決し、AI を使用して要約を ドキュメントを Google ドキュメントに保存します
インシデントとは、チームの即時対応を必要とするイベントである 人によって異なります。インシデントの例:
- 時間的制約のあるケースが顧客管理(CRM)で作成される サービスチームは問題解決に向けて協力する必要があります
- システムがオフラインになり、サイト信頼性エンジニア(SRE)のグループにアラートが発生 オンラインに復帰できるようにします
- マグニチュードの強い地震が起き、緊急作業員に 対応を調整する必要があります
このチュートリアルでは、インシデント アラートは、誰かが ウェブページでボタンをクリックするだけでインシデントを報告できます。ウェブページは ユーザーに基本的なインシデント情報(タイトル、 回答者のメールアドレスもわかります
Chat アプリのインシデント管理の動作を確認します。
-
図 1: インシデントを報告できるウェブサイトです。 -
図 2.インシデントの Chat スペースが作成されたという通知。 -
図 3.インシデント対応の Chat スペース。 -
図 4.スラッシュ コマンドを使用してインシデントを解決する。 -
図 5.インシデント解決ダイアログ -
図 6.スペースで共有された、インシデント解決のための Google ドキュメント ドキュメント。 -
図 7.インシデント解決の AI サマリーに関する Google ドキュメント ドキュメント。
前提条件
組織でこれらの前提条件のいずれかを有効にする必要がある場合は、 Google Workspace 管理者に依頼して有効にしてください。
- 企業または大企業 以下へのアクセス権を持つ Google Workspace アカウント Google Chat。
- 目的 ディレクトリ (連絡先の共有)がオンになっていることを確認します。インシデントアプリでは インシデント対応担当者のログを連絡先情報(名前など) 入力します。インシデント対応担当者は、Google Chat と Google Workspace 組織の ユーザーアカウントにもアクセスできます
目標
- インシデントに対応する Chat アプリを構築する。
- ユーザーがインシデントに対応できるようサポートするには、次の操作を行います。
<ph type="x-smartling-placeholder">
- </ph>
- インシデント対応のためのスペースを作成する。
- インシデントと対応をまとめたメッセージを投稿する。
- インタラクティブな要素によるコラボレーションのサポート Chat アプリの機能。
- Vertex AI で会話と解決策を要約します。
アーキテクチャ
次の図は、Google Workspace と Compute Engine の インシデント対応で使用される Google Cloud リソース Google Chat アプリ。
このアーキテクチャは、インシデント対応が Google Chat アプリはインシデントと解決を処理します。
あるユーザーが、Google Cloud でホストされている外部ウェブサイトから Apps Script。
ウェブサイトが非同期の HTTP リクエストを Google Chat アプリ。Apps Script でもホストされています。
インシデント対応の Google Chat アプリは次のリクエストを処理します。
Apps Script Admin SDK サービスがチームメンバーを取得する ユーザー ID やメールアドレスなどの情報も含まれます。
Chat API への一連の HTTP リクエストを使用すると、 高度なチャット サービスである インシデント対応を Google Chat アプリがインシデントの Chat を作成する スペースにメンバーを追加して、スペースにメッセージを送信します。
チームメンバーが Chat スペースでインシデントについて話し合っています。
チームメンバーがスラッシュ コマンドを呼び出して、 できます。
Apps Script を使用した Chat API への HTTP 呼び出し 高度なチャット サービスを使用すると、 メッセージが表示されます。
Vertex AI は、リストされたメッセージを受信して要約を生成します。
Apps Script
DocumentApp
サービスは、 ドキュメント ドキュメントに追加され、Vertex AI の要約が ドキュメントをご覧くださいGoogle Chat アプリからの Chat API を使用して、要約へのリンクを共有するメッセージを送信します ドキュメント。
環境を準備する
このセクションでは、Google Cloud プロジェクトを作成して構成する方法について説明します。 Chat アプリ。
Google Cloud プロジェクトを作成する
Google Cloud コンソール
- Google Cloud コンソールで、メニュー > IAM と管理 > [プロジェクトを作成] をクリックします。 に移動します。
-
[プロジェクト名] フィールドに、プロジェクト用のわかりやすい名前を入力します。
省略可: プロジェクト ID を編集するには、[編集] をクリックします。プロジェクト ID は変更できません そのため、有効期間中にニーズを満たす ID を選択してください。 できます。
- [場所] フィールドで [参照] をクリックして、 できます。[選択] をクリックします。 <ph type="x-smartling-placeholder">
- [作成] をクリックします。Google Cloud コンソールで [ダッシュボード] ページに移動し、プロジェクトが作成される 示されます
gcloud CLI
次のいずれかの開発環境で、Google Cloud コンソールに CLI(gcloud):
-
Cloud Shell: gcloud CLI でオンライン ターミナルを使用する
Cloud Shell をアクティブにします。
Cloud Shell をアクティブにする -
ローカルシェル: ローカル開発環境を使用するには、
インストールと
初期化
使用できます。
Cloud プロジェクトを作成するには、gcloud projects create コマンドを使用します。gcloud projects create PROJECT_ID
Cloud プロジェクトの課金を有効にする
<ph type="x-smartling-placeholder">Google Cloud コンソール
- Google Cloud コンソールで [お支払い] に移動します。[ メニュー > [お支払い] > [マイ プロジェクト] を選択します。
- [組織を選択] で、関連付けられている組織を選択します。 Google Cloud プロジェクトです
- プロジェクトの行で、[アクション] メニューを開く ( ), [お支払い情報を変更] をクリックし、 Cloud 請求先アカウント。
- [アカウントを設定] をクリックします。
gcloud CLI
- 使用可能な請求先アカウントを一覧表示するには、次のコマンドを実行します。
gcloud billing accounts list
- 請求先アカウントを Google Cloud プロジェクトにリンクします。
gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID
次のように置き換えます。
PROJECT_ID
は、プロジェクトのプロジェクト ID です。 課金を有効にする Cloud プロジェクト。BILLING_ACCOUNT_ID
は、リンクする請求先アカウント ID です。 Google Cloud プロジェクトです
API を有効にする
Google Cloud コンソール
Google Cloud コンソールで、Google Chat API、Google Docs API を有効にする Admin SDK API、Vertex AI API です。
正しい [次へ] をクリックします。
正しい API を有効にしていることを確認し、[有効にする] をクリックします。
gcloud CLI
必要に応じて、作成した Cloud プロジェクトを現在の Cloud プロジェクトに設定します。
gcloud config set project
コマンドを使用します。gcloud config set project PROJECT_ID
PROJECT_ID は、プロジェクトのプロジェクト ID に置き換えます。 作成しました。
Google Chat API、Google Docs API、Admin SDK API、Vertex AI API を有効にする
gcloud services enable
コマンドを使用します。gcloud services enable chat.googleapis.com docs.googleapis.com admin.googleapis.com aiplatform.googleapis.com
認証と権限付与の設定
認証と認可によって、 Google Workspace と Google Workspace の Chat 用アプリ アクセス リソース Google Cloud でインシデント対応を処理する。
このチュートリアルではアプリを内部で公開するため、プレースホルダを使用しても問題はありません 情報です。アプリを外部に公開する前に、プレースホルダを置き換えます 実際の情報とともに同意画面の情報を表示します。
Google Cloud コンソールで メニュー > API とサービス > OAuth 同意画面。
[ユーザーの種類] で [内部] を選択し、[作成] をクリックします。
[アプリ名] に「
Incident Management
」と入力します。[User support email] で、自分のメールアドレスまたは適切な できます。
[デベロッパーの連絡先情報] にメールアドレスを入力します。
[保存して次へ] をクリックします。
[スコープを追加または削除] をクリックします。パネルが表示され、スコープのリストが表示されます。 Cloud プロジェクトで有効にした各 API の Cloud Identity ドメインです。
[スコープを手動で追加] に、次のスコープを貼り付けます。
https://www.googleapis.com/auth/chat.spaces.create
https://www.googleapis.com/auth/chat.memberships
https://www.googleapis.com/auth/chat.memberships.app
https://www.googleapis.com/auth/chat.messages
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/admin.directory.user.readonly
https://www.googleapis.com/auth/script.external_request
https://www.googleapis.com/auth/userinfo.email
https://www.googleapis.com/auth/cloud-platform
[Add to Table] をクリックします。
[更新] をクリックします。
[保存して次へ] をクリックします。
アプリ登録の概要を確認し、[ダッシュボードに戻る] をクリックします。
Chat アプリを作成してデプロイする
次のセクションでは、Terraform Registry の 必要なアプリケーションをすべて含む Apps Script プロジェクト 作成されるため、コードをコピーして使用する必要はありません。 各ファイルを貼り付けます。
関数によっては、名前の末尾にアンダースコアが含まれていることがあります。例:
ChatApp.gs
から processSlashCommand_()
。アンダースコアは関数を
インシデントの初期化のウェブページをブラウザで開いてから、詳細
詳しくは、
非公開関数。
Apps Script では、.gs
スクリプトと .html
の 2 つのファイル形式がサポートされています。
できます。このサポートを遵守するため、アプリのクライアントサイドの JavaScript がインクルードされています。
<script />
タグ内に指定し、その CSS を <style />
タグ内に指定
作成します
必要に応じて、GitHub でプロジェクト全体を表示できます。
各ファイルの概要は次のとおりです。
Consts.gs
他のコードファイルによって参照される定数を定義します。 (Cloud プロジェクト ID、Vertex AI ロケーション ID、 スラッシュ コマンド ID を使用します。
Consts.gs
コードを表示ChatApp.gs
チャット インタラクション イベントを処理します。 メッセージ、カードのクリック、スラッシュ コマンド、ダイアログなどです。次に対応します: インシデントを収集するダイアログを開いて、
/closeIncident
スラッシュ コマンド 表示されます。次の呼び出しによって、スペース内のメッセージを Chat API のspaces.messages.list
メソッド。 Admin SDK Directory サービスを使用してユーザー ID を取得します。 Apps Script。ChatApp.gs
コードを表示ChatSpaceCreator.gs
ユーザーがインシデントで入力したフォームデータを受け取る 確認しました。このウェブページを使用して、Chat の スペースを作成して入力し、スペースに関するメッセージを できます。
ChatSpaceCreator.gs
コードを表示DocsApi.gs
Google Docs API を呼び出して、Google ドキュメント ドキュメントを ユーザーの Google ドライブに書き込まれ、インシデント情報の概要が書き込まれます。
VertexAiApi.gs
で作成されたドキュメントへの移動。DocsApi.gs
コードを表示VertexAiApi.gs
Chat 内の会話を要約します 構築しました。この要約は特別に作成された
DocsAPI.gs
内のドキュメント。VertexAiApi.gs
コードを表示WebController.gs
インシデント初期化ウェブサイトを提供します。
WebController.gs
コードを表示Index.html
インシデント初期化ウェブサイトを構成する HTML。
Index.html
コードを表示JavaScript.html
フォームの送信、送信、 インシデント初期化ウェブサイトのエラーを表示し、クリアします。含まれる
WebController.gs
のカスタムinclude
関数によってIndex.html
に格納します。JavaScript.html
コードを表示Stylesheet.html
インシデント初期化ウェブサイトの CSS。です。 カスタム
include
関数によってIndex.html
に含まれているWebController.gs
。Stylesheet.html
コードを表示
Cloud プロジェクト番号と ID を確認する
Google Cloud コンソールで、Cloud プロジェクトに移動します。
[設定とユーティリティ] をクリックします。 > [プロジェクト設定]。
[プロジェクト番号] フィールドと [プロジェクト ID] フィールドの値をメモします。マイページ 以降のセクションで使用します。
Apps Script プロジェクトを作成する
Apps Script プロジェクトを作成して、 Cloud プロジェクト:
- 次のボタンをクリックして、Apps Script プロジェクト「Respond to incidents with Google Chat」を開きます。
プロジェクトを開く - [概要] をクリックします。
- 概要ページで
[コピーを作成] をクリックします。
Apps Script プロジェクトのコピーに名前を付けます。
[Respond toIncident to Google Chat] をクリックします。
[プロジェクト タイトル] に「
Incident Management Chat app
」と入力します。[名前を変更] をクリックします。
Apps Script プロジェクトのコピーで、
Consts.gs
に移動します。YOUR_PROJECT_ID
を実際の ID に置き換えます。 できます。
Apps Script プロジェクトの Cloud プロジェクトを設定する
- Apps Script プロジェクトで、
[
プロジェクトの設定] をクリックします。
- [Google Cloud Platform(GCP)プロジェクト] で、[プロジェクトを変更] をクリックします。
- [GCP プロジェクト番号] に、Cloud プロジェクトのプロジェクト番号を貼り付けます。
- [プロジェクトを設定] をクリックします。Cloud プロジェクトと Apps Script プロジェクトが接続されました。
Apps Script デプロイメントを作成する
すべてのコードが配置されたので、Apps Script をデプロイします。 できます。デプロイ ID は、サービスを構成するときに Google Cloud の Chat アプリ。
Apps Script で、インシデント対応アプリのプロジェクトを開きます。
[デプロイ] >新しいデプロイ。
[アドオン] と [ウェブアプリ] がまだ選択されていない場合は、 [タイプを選択] でデプロイタイプ
をクリックし、[アドオン] と [ウェブアプリ] を選択します。
[説明] に、このバージョンの説明を入力します(例:
Complete version of incident management app
。[Execute as] で [User access the web app] を選択します。
[アクセスできるユーザー] で [Workspace 組織内のすべてのユーザー] を選択します。 「Workspace 組織」はは名前です。 Google Workspace の組織。
[デプロイ] をクリックします。Apps Script レポートが正常に作成されました そのインシデントのデプロイ ID と URL が示されます。 のウェブページをご覧ください。
後でインシデントを開始したときに参照できるように、ウェブアプリの URL をメモしておきます。 [Deployment ID] をコピーします。この ID は、サービス アカウント Google Cloud コンソールの Chat アプリ。
[完了] をクリックします。
Google Cloud コンソールで Chat 用アプリを構成する
このセクションでは、Google Cloud コンソールで Google Chat API を構成する方法について説明します。 Chat 用アプリに関する情報が表示されます。 Apps Script から作成したデプロイの ID できます。
Google Cloud コンソールで [メニュー] をクリックします。 > その他のプロダクト > Google Workspace > プロダクト ライブラリ > Google Chat API > [管理] > [構成]。
[アプリ名] に「
Incident Management
」と入力します。[アバターの URL] に「
https://developers.google.com/chat/images/quickstart-app-avatar.png
」と入力します。[説明] に「
Responds to incidents.
」と入力します。[インタラクティブ機能を有効にする] をクリックしてオンにします。
[機能] で、[1:1 のメッセージを受信する]、[スペースとグループの会話に参加する] を選択します。
[Connection settings] で、[Apps Script project] を選択します。
[デプロイ ID] に、Apps Script のデプロイ ID を貼り付けます。 先ほど Apps Script プロジェクトからコピーした 説明します。
スラッシュ コマンドを登録し、 完全実装された Chat 用アプリでは以下を使用します。
[スラッシュ コマンド] で [スラッシュ コマンドを追加] をクリックします。
[名前] に「
/closeIncident
」と入力します。[コマンド ID] に「
1
」と入力します。[説明] に次のように入力します。
Closes the incident being discussed in the space.
[ダイアログを開く] を選択します。
[完了] をクリックします。スラッシュ コマンドが登録され、一覧表示されます。
[公開設定] で [ この Chat 用アプリを、 [Workspace Domain] に移動してメールアドレスを入力します。
[ログ] で、[エラーを Logging にロギング] を選択します。
[保存] をクリックします。構成が保存されているというメッセージが表示され、アプリが テストの準備が整いました
Chat アプリをテストする
インシデント管理の Chat 用アプリをテストするには、 Chat 用アプリが 次のように機能します。
Apps Script デプロイ ウェブアプリの URL に移動します。
Apps Script からデータへのアクセス許可を求められた場合は、 [権限を確認] をクリックし、適切な Google アカウントでログインします。 [許可] をクリックします。
インシデントの初期化に関するウェブページが開きます。テスト情報を入力します。
- [Incident title] に「
The First Incident
」と入力します。 - 必要に応じて、[インシデント対応者] に、 他のインシデント対応担当者に提供できます対象となるのは、次のいずれかの属性を持つ Google Workspace 組織の Google Chat アカウント、または 失敗します。ご自身のメールアドレスは入力しないでください。 自動的に含まれます。
- [最初のメッセージ] に「
Testing the incident management Chat app.
」と入力します。
- [Incident title] に「
[Create Chat Space] をクリックします。
creating space
というメッセージが表示されます。スペースが作成されると、
Space created!
メッセージが表示されます。[ スペースを開く: Chat のスペースが新しいタブで開きます。必要に応じて、お客様と他のインシデント対応担当者は、 選択します。このアプリは Vertex AI を使用してこれらのメッセージを要約し、 作成しました。
インシデント対応を終了して解決プロセスを開始するには、 Chat スペースの場合は、「
/closeIncident
」と入力します。インシデント管理 ダイアログが開きます。[インシデントを閉じる] に、インシデントの解決の説明を入力します。 (例:
Test complete
)。[Close Incident](インシデントを閉じる)をクリックします。
Incident Management アプリでは、スペース内のメッセージが一覧表示され、要約されます。 要約を Google ドキュメント ドキュメントに貼り付けて、 スペースでドキュメントを作成できます。
クリーンアップ
サービス アカウントに対する Google Cloud アカウントへの課金を回避するために、 リソースがある場合は、その Terraform 構成ファイルを できます。
-
Google Cloud コンソールで、[リソースの管理] ページに移動します。[
メニュー > IAM と管理者
> [リソースの管理] をクリックします。
<ph type="x-smartling-placeholder"></ph> Resource Manager に移動
- プロジェクト リストで、削除するプロジェクトを選択し、[ を削除します。
- ダイアログでプロジェクト ID を入力し、[シャットダウン] をクリックして削除します。 できます。
関連トピック
- Gemini AI Chat アプリを使用して、Chat での会話に基づいて質問に回答する
- Google Chat、Vertex AI、Firestore でプロジェクトを管理する
- インシデント対応アプリは、API を呼び出すためにユーザー認証情報で認証を行います。
Chat API や Vertex AI API などの Google Cloud サービスを呼び出すことができます。
つまり、インシデントを初期化するユーザーには、これらの情報に
提供します。アプリの堅牢性を高めるには、Vertex AI API の呼び出しを検討してください。
ユーザー認証情報を使用する代わりに、サービス アカウントとして
/closeIncident
スラッシュ コマンドを使用します。サービス アカウントの設定については、 詳細については、以下をご覧ください。 カスタム サービス アカウントを使用する。