Genieの会話IDを保存するData tableを構築する
このユースケースでは、data tableをGenieの永続的なメモリとして使用する方法を説明します。 Genieに割り当てられた各タスクは、デフォルトでは新しい会話として開始されます。 GenieがTelegramなどのインターフェースを介して複数ユーザーからメッセージを受信する際に、各ユーザーを既存のGenieの会話に対応付け、コンテキストを保持する方法が必要です。
このユースケースでは、Data tableを使用して各TelegramユーザーIDとGenieの会話IDとの対応関係を保存する方法を示します。レシピは各タスクの前にData tableで送信者を検索し、レコードが存在する場合は同じ会話を継続します。レシピは各タスクの後に会話IDをテーブルにアップサートします。
この会話メモリを利用するスキルをGenieに追加することで、今後の予定についての会話からカレンダー予定を登録するなど、複数のメッセージにまたがるタスクを実行できます。
このGenieは何をしますか
このGenieはWorkatoレシピを通じてTelegramメッセージを受信し、ユーザーと会話を対応付けてコンテキストを保持するためにData tableに会話IDを保存します。
会話IDにData tablesを使用する理由は何ですか?
このシナリオでは、次の理由からData tableが適しています。
- レシピジョブ間での永続性: 各レシピジョブは独立して実行されます。 Data tableはジョブ終了後も会話IDを保持するため、同じユーザーからの次のメッセージは前回のメッセージの続きから処理できます。
- キーによる高速ルックアップ: レシピは単一の
telegram-id列でテーブルを検索します。 - 外部データベースの運用不要: Data tableはスケーラブルかつ安全であるため、別途ストレージを用意したり管理したりする必要がありません。
- 容易な確認と編集: Data tablesインターフェースでテーブルを開き、保存された会話IDを確認したり、レコードを削除してユーザーの会話をリセットしたりできます。
DATA TABLEの制限事項
Data tableは、クレジットカード番号などの機微なPCIデータを保存したり、大規模なリレーショナルデータベースとして機能したりする用途には設計されていません。このユースケースでは、ユーザーIDと会話IDのみを保存します。機微な会話内容を保存する目的でData tableを使用しないでください。
会話ID用Data tableを使ってGenieを構築する
次の手順を完了して、Data tableを使用してユーザーごとの会話コンテキストを維持するTelegramベースのGenieを作成します。
ユースケースは例示のみを目的としています
ユースケースは例として使用することを目的としています。トリガー、アクション、Data tableの列、コネクションの権限などの変更は、環境に合わせて調整が必要になる場合があります。
Workatoにサインインします。
会話IDを保存するData tableを作成します。
会話IDを保存するData tableを作成する
このステップでは、各TelegramユーザーのIDに対してGenieの会話IDを永続化するData tableを作成します。これにより、Genieは同じユーザーからの複数のメッセージにわたってコンテキストを保持できます。
初回ユーザー
ユーザーが初めてTelegramボットにメッセージを送信した場合、ユーザーにはまだ会話IDがないため、Search recordsアクションはレコードを返しません。 Genieの会話IDは空のままにしておき、Genieが新しい会話を開始できるようにします。次のセクションのアップサートステップで、新しい会話IDが将来のメッセージ用に保存されます。
Data tableを保存する予定のプロジェクトに移動し、作成>Data tableをクリックするか、C+Tを押します。
Data table nameフィールドにData tableの名前を入力します。例: Telegram genie conversations。
Locationドロップダウンメニューを使用して、Data tableの保存場所を選択します。
ビルドを開始をクリックします。
Telegramユーザーの送信者IDを保存するために、ラベルtelegram-idの列を追加します。
Genieの会話IDを保存するために、ラベルgenie-conversation-idの2つ目の列を追加します。
Data tableに列を追加
保存をクリックします。
Telegramボットを設定します。
Telegramボットを設定
この手順では、新しいTelegramボットを作成し、それをWorkatoに接続するために必要なAPIトークンを取得します。
Telegramアプリにサインインし、@BotFatherアカウントを検索します。
@BotFatherとの会話を開始し、/newbotコマンドを入力します。
新しいTelegramボットを作成
プロンプトに従って、Telegramボットのわかりやすい名前を入力します。例: Workato PA genie。
プロンプトに従って、botで終わる一意のユーザー名を入力します。例: workato_bot。
確認メッセージで@BotFatherから提供されたシークレットAPIトークンをコピーします。 TelegramボットをWorkatoに接続するには、このトークンを使用する必要があります。
Telegramコネクションを作成します。
Telegramコネクションを作成
この手順では、Telegramコミュニティコネクターをインストールし、WorkatoとTelegramボット間のコネクションを作成します。
Workatoアカウントにサインインします。
コミュニティライブラリ>カスタムコネクターに移動します。
Telegramを検索し、アプリとして選択します。
インストールをクリックします。
Telegramコミュニティコネクターをインストール
名前フィールドにコネクションの名前を入力します。
コネクションの保存先ドロップダウンメニューを使用して、コネクションの場所を選択します。
APIトークンフィールドに、@BotFatherから受け取ったAPIトークンを入力します。
接続をクリックします。
受信したTelegramメッセージを処理するレシピを設定します。
受信したTelegramメッセージを処理するレシピを設定
この手順により、Telegramボットに送信されたメッセージがWorkatoに届き、正しく処理されるようになります。
レシピを保存する予定のプロジェクトに移動し、作成>レシピをクリックするか、C+Rを押します。
名前フィールドにレシピの名前を入力し、レシピの保存先ドロップダウンメニューを使用してプロジェクトの場所を選択します。
開始点を選択>アプリを選択をクリックします。
Telegramを検索し、アプリとして選択します。
新規イベントトリガーを選択し、前の手順で作成したTelegramコネクションを使用して接続します。
+ステップを追加をクリックし、Telegramを検索して選択します。
Telegramのメッセージを送信アクションを設定
メッセージを送信アクションを選択します。
Telegramメッセージ>チャットIDステップ 1データピルをチャットIDフィールドにマッピングします。
送信するメッセージフィールドにMessage receivedと入力します。
任意。テストレシピをクリックし、Telegramボットにメッセージを送信します。返信を受信した場合、レシピは正しく設定されています。
Genieをレシピに追加します。
Genieをレシピに追加
このステップでは、受信したTelegramメッセージを処理し、ユーザーに返信するGenieを作成します。
Genieを保存する予定のプロジェクトに移動し、作成>Genieをクリックするか、C+Gを押します。
Genieにどのような支援を求めますか?フィールドに、Genieへのリクエストまたは目標を入力します。例:
You are a personal assistant who responds to users' messages. If the message contains
information about an upcoming event, you can create a calendar event for the user
with the given information.Genieの保存先ドロップダウンメニューを使用して、Genieの場所を選択します。
新しいGenieを作成
ビルドを開始をクリックします。 Genieのビルドページが表示され、入力内容に基づいてジョブ説明が自動生成されます。これは要件に合わせて編集できます。
レシピエディターに戻り、Telegramのメッセージ送信アクションステップの前にある+ステップを追加をクリックします。
Telegramのメッセージ送信アクションステップの前に+ステップを追加をクリック
アプリ内のアクションを選択し、Workato Genieを検索して、アプリとして選択します。
Genieにタスクを割り当てアクションを選択します。
Genieドロップダウンメニューを使用して、前の手順で作成したGenieを選択します。
Genieに受信メッセージを処理するよう指示する説明文を、Task Descriptionフィールドに入力します。
タスク説明フィールドの説明の後に、Telegramトリガーのテキストステップ 1データピルをマッピングします。
タスク説明フィールドを設定
保存をクリックします。
送信者の会話IDをData tableで検索します。
送信者の会話IDをData tableで検索する
このステップでは、送信者のTelegram IDに対応する会話IDがData tableに存在するかどうかを確認する、Workato Data tablesのSearch recordsアクションを追加します。既存の会話IDは、Genieが継続できる過去の会話があることを示します。
初回ユーザー
ユーザーが初めてTelegramボットにメッセージを送信した場合、ユーザーにはまだ会話IDがないため、Search recordsアクションはレコードを返しません。 Genieの会話IDは空のままにしておき、Genieが新しい会話を開始できるようにします。次のセクションのアップサートステップで、新しい会話IDが将来のメッセージ用に保存されます。
レシピエディタに戻り、Assign task to genieアクションステップの前にある+ Add stepをクリックします。
アプリ内のアクションを選択し、Workato Data Tablesを検索して、アプリとして選択します。
レコードを検索アクションを選択します。
Data tableドロップダウンメニューを使用して、前の手順で作成したData tableを選択します。
フィルターセクションに移動し、フィルターを追加をクリックします。
列名ドロップダウンメニューを使用して、telegram-idを選択します。
オペランドドロップダウンメニューを使用して、次の値に等しいを選択します。
TelegramのIDステップ 1データピルを値フィールドにマッピングします。このデータピルはTelegram > Message > Fromの下にあります。
Telegramを検索するData tableを設定
保存をクリックします。
保存済みの会話IDをGenieに渡します。
保存済みの会話IDをGenieに渡す
このステップでは、Data tableの検索で返された会話IDをAssign task to genieアクションにマッピングします。これにより、Genieは毎回新しい会話を開始するのではなく、既存の会話を継続できるようになります。
レシピエディターでGenieにタスクを割り当てステップをクリックします。
Conversation IDフィールドに移動します。
Workato Data tablesのgenie-conversation-idステップ 2データピルを、Search recordsステップからConversation IDフィールドにマッピングします。検索結果の最初のレコードを使用します。
保存をクリックします。
会話IDをData tableに保存します。
会話IDをData tableに保存する
このステップでは、Genieが返した会話IDを保存するWorkato Data tablesのUpsert recordアクションを追加します。このアクションは、新規ユーザーにはレコードを作成し、既存ユーザーにはレコードを更新します。
Genieにタスクを割り当てアクションステップの後にある+ステップを追加をクリックします。
アプリ内のアクションを選択し、Workato Data Tablesを検索して、アプリとして選択します。
レコードをアップサートアクションを選択します。
Data tableドロップダウンメニューを使用して、前の手順で作成したData tableを選択します。
レコードをアップサートアクションを設定
プライマリキードロップダウンメニューを使用して、telegram-idを選択します。
レコードフィールドセクションに移動し、Telegramの差出人IDステップ 1データピルをtelegram-idフィールドにマッピングします。
Workato Genieの会話IDステップ 3データピルをgenie-conversation-idフィールドにマッピングします。
保存をクリックします。
Genieのメモリをテストします。
Genieのメモリをテストする
このステップでは、Data tableが会話IDを保存しており、Genieがそれらを利用していることを確認します。
Test recipeをクリックし、Telegramボットにメッセージを送信します。例: My dentist appointment is next Tuesday.
Data tableを開き、Telegram IDとGenieの会話IDを含む新しいレコードが作成されていることを確認します。
最初のメッセージに依存するフォローアップメッセージを送信します。例: Actually, make that 4 PM. Genieは先ほどの予約を考慮した応答を返す必要があります。
Data tableに戻り、重複レコードが作成されていないことを確認し、同じレコードが更新されていることを確認します。
任意。 GenieをGoogle Calendarスキルで拡張します。
GenieをGoogle Calendarスキルで拡張する
会話メモリが有効になっていれば、そのコンテキストを活用するスキルをGenieに付与できます。このステップでは、メッセージをGoogle Calendarイベントに変換するスキルを追加します。 Genieが以前のメッセージを記憶しているため、ユーザーは複数のメッセージにわたってイベント内容を細かく調整できます。
Google Calendarコネクションを作成
この手順では、WorkatoとGoogle Calendarアカウント間のコネクションを作成し、Genieがユーザーに代わってカレンダーイベントを作成できるようにします。
Google Calendarコネクションを設定するには、次のセクションを参照してください:
OAuth 2.0認証
OAuth 2.0を使用してGoogle Calendarコネクションを設定するには、次の手順を実行します:
OAuth 2.0認証手順を表示
作成 > コネクションをクリックするか、Cを2回押します。
新規コネクションページで、コネクションとしてGoogle Calendarを検索して選択します。
コネクション名フィールドにコネクションの名前を入力します。
場所ドロップダウンメニューから、コネクションを保存するプロジェクトを選択します。
Authentication typeとしてOAuth 2.0を選択します。
Googleでログインをクリックし、Googleアカウントにログインします。 Workatoで使用する予定のイベントおよびカレンダーを管理するための十分な権限がGoogleアカウントにあることを確認します。
Googleでログインをクリックします。
サービスアカウント認証
サービスアカウント認証手順を表示
Googleサービスアカウントは、Google Cloudプロジェクト(GCP)に関連付けられた専用のGoogleアカウントであり、ユーザーに代わってAPIリクエストを実行できます。
サービスアカウントには次の利点があります:
- 継続的な運用: サービスアカウントにより、個々のユーザー権限が変更された場合でも運用を継続できます。
- 専用の権限: サービスアカウントは、共有先として指定したプロジェクトにのみアクセスできます。
- 専用のAPIクォータ: GCPを通じてサービスアカウントのAPIクォータを管理し、Googleに直接クォータの引き上げをリクエストできます。
サービスアカウントの詳細については、Googleサービスアカウントのドキュメントを参照してください。
サービスアカウント認証は、次のアクションで構成されています:
サービスアカウントコネクションの最小スコープ
サービスアカウントを使用してGoogle Calendarに接続するには、次のスコープが必要です:
https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.eventshttps://www.googleapis.com/auth/admin.directory.resource.calendarhttps://www.googleapis.com/auth/taskshttps://www.googleapis.com/auth/userinfo.email
サービスアカウントでOwnerロールを使用している場合、または必要なスコープが不足している場合、401 Unauthorized errorが発生することがあります。 Google Cloud ConsoleでサービスアカウントにEditorロールを割り当て、上記の必要なスコープがすべて含まれていることを確認します。これにより、サービスアカウントが正常に認証され、Google Calendarにアクセスできるようになります。
サポートされているスコープの完全なリストについては、Google Calendar APIスコープのドキュメントを参照してください。
Googleサービスアカウントを設定する
Googleサービスアカウントの設定手順を表示
Googleサービスアカウントを設定するには、次の手順を実行します:
GCPプロジェクトでサービスアカウントを作成します。
IAMと管理>サービスアカウントに移動します。ダッシュボードのスコープが、サービスアカウントを含むプロジェクトに設定されていることを確認します。
ダッシュボードのスコープを確認します。
使用するサービスアカウントのメールをクリックします。
使用するサービスアカウントのメールをクリックします。
サービスアカウントのメールをコピーし、後でコネクションを設定するために保存します。
アカウントのメールをコピーします。
キータブに移動します。
秘密鍵を生成し、JSON形式でダウンロードします。キーは1回しかダウンロードできません。
JSONファイルを開き、秘密鍵全体を-----BEGIN PRIVATE KEY-----から-----END PRIVATE KEY-----\nまで(両端を含む)コピーして、後でコネクションを設定するために保存します。
Google Calendar APIを有効化
Google Calendar APIの有効化手順を表示
コネクションの設定を完了するためにWorkatoに戻る前に、Google Calendar APIを有効にする必要があります。
GoogleのAPIライブラリにサインインします。
Google Calendar APIを検索して選択します。
有効にするをクリックしてAPIを有効にします。 
Google Calendar APIを有効にする
Workatoでセットアップを完了
Workato設定手順を表示
サービスアカウントを使用してGoogle Calendarコネクションを設定するには、Workatoで次の手順を実行します:
作成 > コネクションをクリックするか、Cを2回押します。
新規コネクションページで、コネクションとしてGoogle Calendarを検索して選択します。
コネクション名フィールドにコネクションの名前を入力します。
ロケーションドロップダウンメニューを使用して、コネクションを保存するプロジェクトを選択します。
Authentication typeとしてService accountを選択します。
サービスアカウントの秘密鍵を入力します。
権限を借用する予定のアカウントのユーザーのメールアドレスを指定します。
ユーザーの権限借用により、サービスアカウントは指定したユーザーに代わって、そのユーザーのGoogle Calendarのイベントにアクセスして管理できます。ユーザーの権限を借用すると、データの正確性が確保され、Google Calendarでそのユーザーに設定された権限とアクセス制御が適用されます。詳細については、Googleのサービスアカウントの権限借用ガイドを参照してください。
設定を完了するには、Googleでログインをクリックします。
Google Calendarサービスアカウントコネクションの設定
メッセージをGoogle Calendarイベントに変換するスキルを作成する
この手順では、Google Calendarイベントに変換する必要があるメッセージをGenieが検出できるようにするカスタムスキルを作成します。
前の手順で作成したGenieのビルドページに移動します。
スキルセクションに移動し、+追加>スキルをクリックします。
新規スキルを選択し、新規スキルを作成をクリックします。
または、プロジェクトページで作成>スキルをクリックするか、C+Sを押してスキルを作成できます。
名前フィールドにスキルの名前を入力します。例: Create Google Calendar event。
ロケーションドロップダウンメニューを使用して、スキルのロケーションを選択します。
ビルドを開始をクリックします。レシピエディターが開き、ワークフローを開始トリガーと応答を返すアクションが自動的に選択されます。
ワークフローを開始トリガーを選択します。
このスキルを実行するためにGenieに必要な入力は何ですか?セクションに移動し、フィールドを手動で追加をクリックします。次のフィールドを追加します:
| ラベル | データ型 |
|---|---|
event_title | 文字列 |
event_date | 日付 |
event_time | 文字列 |
event_description | 文字列 |
このスキルの実行後にGenieへ返す内容は何ですか?セクションに移動し、次のフィールドを追加します:
| ラベル | データ型 |
|---|---|
created_event | ブーリアン |
入力と出力を設定
+ステップを追加をクリックし、Google Calendarを検索して、アプリとして選択します。
イベントを作成アクションを選択します。
イベントを作成アクションを設定
+ステップを追加をクリックし、カレンダーイベント作成の結果を処理するためにIF条件を選択します。
Google CalendarのIDステップ 2データピルをデータフィールドにマッピングします。
条件ドロップダウンメニューを使用して、存在するを選択します。
はいブランチに移動し、アプリとアクションを選択をクリックします。
Workato Genieを検索し、アプリとして選択します。
アクションとしてGenieに応答を返すを選択します。
結果セクションに移動し、作成済みイベントドロップダウンメニューを使用してはいを選択します。
IF条件を設定
いいえブランチに移動します。 Genieに応答を返すアクションはすでに存在しているはずです。
Genieに応答を返すアクションをクリックして開きます。
IFブロックのはいおよびいいえパスを設定し、適切なcreated_eventブール応答をGenieに返します。
保存をクリックします。
Genieのタスク説明を更新
この手順では、GenieがGoogle Calendarスキルを使用する方法に関する指示を含めるように、Genieのタスク説明を更新します。
レシピエディターでGenieにタスクを割り当てステップをクリックします。
タスク説明フィールドに移動し、次の指示を使用するように説明を更新します:
TELEGRAMデータピルを削除しないでください
前の手順でタスク説明フィールドにマッピングしたTelegramデータピルを削除しないでください。
Do the following based on the user's message and conversation history:
1. Identify if the message contains an event where you need to set up a calendar event.
2. If yes, then call the skill to create the event in Google Calendar.
3. If not, then respond normally.
4. When responding, you do not need to include your classification of whether it was a task.保存をクリックします。
タスク説明を更新
最終更新日: