Vertex AI の最先端マルチモーダルモデルである Gemini 1.5 Pro をお試しになり、100 万トークンのコンテキストウィンドウで何を構築できるかご確認ください。Vertex AI の最先端マルチモーダルモデルである Gemini 1.5 Pro をお試しになり、100 万トークンのコンテキストウィンドウで何を構築できるかご確認ください。

Dialogflow と Google Chat の統合

Dialogflow を Google Chat と統合すると、両方のサービスの機能を利用できます。

Google Chat。1 対 1 の会話とチャットスペース用のフロントエンドユーザーインターフェースを備えたメッセージングプラットフォームを提供します。Google Chat では、アイコン、画像、ボタン、テキスト入力フィールド、Google マップなどのアプリを組み込んだカードを作成することで、ユーザーインターフェースを強化できます。
Dialogflow。自動会話と動的レスポンスのための自然言語理解プラットフォームを提供します。Dialogflow を使用すると、ユーザーのインテントを解釈してフルフィルメント（予約のスケジューリングや購入の処理など）を行うことができます。

Google Chat を使用してユーザーのリクエストを処理することもできますが、Dialogflow ではユーザーが通常の会話でリクエストを表現できます。

仕組み

Dialogflow 対応 Google Chat アプリを作成すると、次の対象がアプリを使用できるように設定可能です。

一般大衆。Google Workspace のライセンスを持つユーザーは、Google Workspace Marketplace からアプリをダウンロードできます。
Google Workspace ドメイン。Google Workspace 管理者は、ユーザーが Google Chat に追加できるアプリを指定できます。
アプリテスター。アプリのテスト中は、アプリへのアクセスを制限できます。

Google Chat では、ユーザーがアプリと直接会話したり、スペース内からアプリを呼び出したりできます。この場合、次のようになります。

ユーザーが Chat アプリにメッセージを送信します。
Google Chat は、Chat アプリに JSON リクエストを送信します。これは、Cloud Functions でホストできます。
Chat アプリが JSON リクエストを受信して解析します。この解析中に、Chat アプリは Dialogflow を呼び出します。
Chat アプリが Dialogflow に、ユーザーの自然言語メッセージテキストを含むリクエストを送信します。
Dialogflow がユーザーのテキストを解釈し、Chat アプリにレスポンスを送信します。
Chat アプリは Dialogflow のレスポンスを解析し、Google Chat に JSON レスポンスを送信します。
Google Chat は Chat アプリの JSON レスポンスを受信し、テキストメッセージ、カードメッセージ、UI のダイアログメッセージの形式でレスポンスをレンダリングします。
Google Chat はこのレスポンスをそのまま共有するか、カードベースの UI を使用してリッチレスポンスを提示します。

このページでは、Dialogflow を Google Chat と統合してリッチチャットレスポンスを構成する方法について説明します。

制限事項

Google Chat の統合では、Dialogflow エージェントがデフォルトのエージェント言語のみを使用できます。

始める前に

Google Chat アプリを使用できるのは、Google Workspace のライセンスを持つユーザーのみです。Google Workspace 管理者は、次のことを行う必要があります。

Dialogflow エージェントをビルドする

まだ Dialogflow エージェントを作成していない状態でエージェントが Google Chat を操作する方法を確認する必要がある場合は、こちらのクイックスタートに沿って簡単なエージェントを作成します。ただし、エージェントを削除しないでください。次に、Google Chat のインターフェースを使用してエージェントを設定します。

Google Chat を設定する

Google Chat で Dialogflow エージェントを設定するには、次のいずれかを使用します。

Dialogflow コンソール
Google Cloud コンソール

Dialogflow コンソールを使用して Google Chat を設定する

Dialogflow コンソールを使用して Google Chat を統合する手順は次のとおりです。

Dialogflow ES コンソールに移動します。
左側のメニューで、Dialogflow プロジェクトを選択します。
[Integrations] をクリックします。
[Google Chat] をクリックします。Google Chat が選択メニューに表示されない場合は、トラブルシューティングをご覧ください。
アプリにアクセスできるユーザーを選択します。
（省略可）エージェントを実行する環境を選択します。
[開始] をクリックします。

Google Chat アプリが公開され、選択したユーザーにご利用いただけるようになりました。

アプリを構成するには、[Google Chat] をもう一度クリックして、[bot の詳細を構成] をクリックします。これにより、Google Chat API の Google Cloud コンソールページが表示されます。このページでは、アプリのアバターなどのアプリパラメータを構成できます。

Google Cloud コンソールを使用して Google Chat を設定する

Google Cloud コンソールを使用して Google Chat を統合する手順は次のとおりです。

Dialogflow プロジェクトを選択します。

プロジェクトセレクタに移動
[] をクリックします。
[API とサービス] > [ライブラリ] をクリックします。
[Google Chat API] を見つけてクリックします。
[有効にする] をクリックします。
[構成] タブをクリックします。
アプリを構成します。
[Visibility] ペインで、アプリにアクセスできるユーザーを選択します。
- アプリテスター。[このチャットを特定のユーザーに許可する] を選択し、ユーザーのメールアドレスを入力します。
- 一般的なパブリックドメインまたはエンタープライズ Google Workspace ドメイン。アプリを公開します。
[保存] をクリックします。これで Google Chat アプリが公開され、選択したユーザーが使用できるようになります。

テスト

Chat アプリをテストする前に、Google Chat を設定するの説明に従って、チャットアプリを起動していることを確認してください。

次のいずれかの方法でアプリをテストできます。

アプリと直接チャットする
スペースからアプリを呼び出す

アプリと直接チャットする

Google Chatを開きます。
[チャット] ペインで [+] をクリックし、[アプリを探す] を選択します。
アプリを検索して選択します。Google Chat にアプリが表示されていない場合は、トラブルシューティングをご覧ください。
[チャット] をクリックします。
チャットエントリフィールドに自然言語フレーズを入力して、アプリをテストします。

スペースからアプリを呼び出す

Google Chatを開きます。
[スペース] ペインで、[+] をクリックし、[スペースを作成] を選択します。
スペース名「Test」を入力します。
[Create（作成）] をクリックします。
チャットエントリの項目に「@」と入力し、名前をオートコンプリートするアプリを選択します。
オートコンプリートされたアプリ名の後に、自然言語フレーズを入力してアプリをテストします。

トラブルシューティング

エラー	解決策
[Dialogflow ES コンソール] > [統合] ページに、Google Chat がオプションとして表示されません。	ページを更新してみてください。左側のメニューで [インテント] をクリックし、[統合] をクリックします。
アプリが Google Chat に利用可能として表示されていない。	Google Workspace 管理者が Google Workspace アカウントを追加し、ユーザーに Chat アプリのインストールを許可していることを確認します。次に、Google Chat を設定するの説明に従って、Chat アプリを起動していることを確認します。

リッチレスポンスメッセージ

この統合により、一部のリッチレスポンスメッセージが Google Chat のメッセージタイプに変換されます。

テキストのレスポンス

テキストレスポンスは、テキストメッセージとして Google Chat に送信されます。このフォーマットでは、テキストを特定の（マークダウンライト）記号で囲むことにより、太字や斜体にできます。

テキストメッセージのレスポンスは、Dialogflow コンソールのデフォルトのテキストレスポンスと同用の外観で表示されます。ただし、未加工の API レスポンスは少し異なります。また、プラットフォーム構成を GOOGLE_HANGOUTS に設定して、複数の統合用のエージェントをビルドする際に活用できる情報を提供します。

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

カード

カード形式のレスポンスは、カードメッセージとして Google Chat に送信されます。

画像

画像レスポンスは、Google Chat 画像ウィジェットとして Google Chat に送信されます。

カスタムペイロード

他の種類の Google Chat メッセージを送信するには、カスタムペイロードを使用します。

Google Chat のカスタムペイロードを使用すると、より高度なカードを作成できます。1 つのカードは 1 つ以上のセクションを持つことができます。各セクションにはヘッダーを含めることができます。Google Chat メッセージ形式カードのリファレンスガイドを参照して、これで作成できる組み合わせのいくつかを確認できます。ただし、カスタムペイロードを使用する場合は、JSON 形式を指定する必要があります。

カード v1 形式を使用したカスタムペイロードの例を次に示します。

{
  "hangouts": {
    "header": {
      "title": "Pizza Delivery Customer Support",
      "subtitle": "pizzadelivery@example.com",
      "imageUrl": "https://goo.gl/aeDtrS"
    },
    "sections": [{
      "widgets": [{
        "keyValue": {
          "icon": "TRAIN",
          "topLabel": "Order No.",
          "content": "12345"
        }
      },
      {
        "keyValue": {
          "topLabel": "Status",
          "content": "In Delivery"
        }
      }]
    },
    {
      "header": "Location",
      "widgets": [{
        "image": {
          "imageUrl": "https://dummyimage.com/600x400/000/fff"
        }
      }]
    },
    {
      "header": "Buttons - I could leave the header out",
      "widgets": [{
        "buttons": [{
          "textButton": {
            "text": "OPEN ORDER",
            "onClick": {
              "openLink": {
                "url": "https://example.com/orders/..."
              }
            }
          }
        }]
      }]
    }]
  }
}

Chat アプリを停止する

Google Chat アプリを利用不可にするには、次のいずれかを使用します。

Dialogflow コンソール
Google Cloud コンソール

Dialogflow コンソールを使用して Chat アプリを停止する

Dialogflow ES コンソールに移動します。
左側のメニューで、Dialogflow プロジェクトを選択します。
[Integrations] をクリックします。
[Google Chat] をクリックします。Google Chat が選択メニューに表示されない場合は、トラブルシューティングをご覧ください。
[Stop] をクリックします。

Google Cloud コンソールを使用して Chat アプリを停止する

Google Cloud コンソールで Dialogflow プロジェクトを選択します。

プロジェクトセレクタに移動
[] をクリックします。
[API とサービス] > [ライブラリ] をクリックします。
[Google Chat API] を見つけてクリックします。
[管理] をクリックします。
[構成] タブをクリックします。
[アプリのステータス] フィールドで、[無効] を選択します。

詳細情報

Google Chat の使用について詳しくは、以下をご覧ください。