App Events
App Eventsを使用すると、ユーザーが会話を開始するのを待つ代わりに、SalesforceやZoomなどの外部システムからのトリガーに応答して、Genieがプロアクティブに動作できます。 これらのイベントは、Genieを既存のワークフローに直接組み込むのに役立ち、Genieがユーザーのニーズを予測して、求められる前に支援を提供できるようにします。
App Eventsでは、次のことが可能です。
- レシピで定義することが難しい複雑なタスクを自動化します。
- 適切なタイミングで関連するタスクをユーザーに表示します。
- タスクの整理、管理、完了を支援して、ユーザーの負担を軽減します。
- プロセスの早い段階でコンテキストを提供し、Genieの有効性を高めます。
短い動画ガイドを視聴する：Agent StudioでApp Eventを作成する
たとえば、ITチームによって自分のNetSuiteアクセスの新しいリクエストが承認されたという通知をITGenieが受信します。 ITGenieはこのApp Eventを自動的に処理し、次のステップが必要かどうかを判断します。
App Eventの例
App Eventsの会話
App Eventsには2つのモードがあります。 Continue Conversationモードでは、ユーザーがGenieとの会話スレッドを再開できます。New Conversationモードでは、ユーザーがGenieとの新しい会話を開始できます。
Continue conversation
Continue conversationでは、ユーザーが最初にGenieとやり取りした同じスレッドで新しいイベント情報を受け取り、会話のコンテキスト全体を維持できます。 このモードを使用するには、Conversation IDをData tableにマッピングし、スキルでConversation IDをGenieに戻して渡す必要があります。
次の場合はContinue conversationを使用します。
- イベントが、ユーザーが作成したチケットや送信したリクエストなど、ユーザーがGenieを通じて開始した項目を更新する場合。
- ユーザーが、やり取りを開始した同じ会話ウィンドウまたはスレッドで更新を受け取ることを期待している場合。
- 元のセッションの会話コンテキストが、ユーザーによる更新への応答方法に関連している場合。
Conversation IDマッピングを使用したContinue conversation
会話IDを保存するData tableを作成します。
会話IDを保存するData tableを作成
このステップでは、JiraチケットIDやTelegramメッセージIDなどのサードパーティアプリ識別子に対して、GenieのConversation IDを保持するData tableを作成します。 これにより、Genieはイベントに関連する複数のメッセージにわたってコンテキストを保持できます。
Data tableを保存する予定のプロジェクトに移動し、作成>Data tableをクリックするか、C+Tを押します。
NameフィールドにData tableの名前を入力します。
Save inドロップダウンメニューを使用して、Data tableの場所を選択します。
作成 > データテーブルをクリックするか、C+Tを押します。
外部ビジネスIDを格納するためのラベル付き列を追加します。 例：telegram-id
Genieの会話IDを保存するために、ラベルgenie-conversation-idの2つ目の列を追加します。
Data tableに列を追加
リクエスト者のメールアドレス用に、ラベルemailの3番目の列を追加します。
会話開始時のタイムスタンプ用に、ラベルCreated atの4番目の列を追加します。
保存をクリックします。
会話IDをレシピに追加します。
会話IDをレシピに追加
このステップでは、TelegramやJiraなどの外部ビジネスIDに対応するConversation IDがData tableにあるかどうかを判断するために、レシピがData tableを参照できるWorkato Data tablesのSearch recordsアクションを追加します。 既存の会話IDは、Genieが参照できる以前の会話があることを示します。
レシピエディターに戻り、+ Add stepをクリックします。
アプリ内のアクションを選択し、Workato Data Tablesを検索して、アプリとして選択します。
レコードを検索アクションを選択します。
Search recordsアクションを選択する
Data tableドロップダウンメニューを使用して、新しく作成したData tableを選択します。
フィルターセクションに移動し、フィルターを追加をクリックします。
Column nameドロップダウンメニューを使用して、前のステップで設定した外部ビジネスIDを選択します。
オペランドドロップダウンメニューを使用して、次の値に等しいを選択します。
レシピエディターで+ Add stepをクリックします。
アプリ内のアクションを選択し、Workato Data Tablesを検索して、アプリとして選択します。
レコードをアップサートアクションを選択します。
Data tableドロップダウンメニューを使用して、前の手順で作成したData tableを選択します。
Primary keyドロップダウンメニューを使用して、前のステップで設定したIDを選択します。
Record fieldsセクションに移動し、IDStep 1データピルを前のステップで作成したIDフィールドにマッピングします。
Workato Genieの会話IDStep 3データピルをgenie-conversation-idフィールドにマッピングします。
保存をクリックします。
一致するConversation IDが見つかりません
一致するConversation IDが見つからない場合は、レシピがNew Conversationモードにフォールバックするか、ログに記録してスキップするように設計することをWorkatoは推奨しています。
New conversation
New conversationは、ユーザーがチャットインターフェイスで新しいメッセージを受け取る、事前コンテキストのない新しいGenie会話を開始します。
次の場合はNew conversationを使用します。
- イベントに関連付けられた以前のGenie会話がない場合。
- 以前のやり取りとは完全に無関係に発生したイベントをユーザーに通知する必要がある場合。
- Genieがユーザーとの新しいタスクを最初から開始する必要がある場合。
アプリイベントを作成する
GenieのApp Eventを作成するには、次のステップを実行します。
Workatoにサインインします。
AI Hubに移動し、Geniesタブをクリックします。 既存のGenieのリストが表示されます。
App Eventを追加するGenieを選択します。
App eventsに移動し、+ Addをクリックします。
App events
Create app eventをクリックします。
NameフィールドにApp Eventの名前を入力します。
ビルドを開始をクリックします。 レシピエディターが開き、Send business eventアクションが自動的に選択されます。 入力と出力のフィールドレベルの説明については、Send business eventアクションリファレンスを参照してください。
レシピエディターのSend business eventアクション
Send business eventアクションをクリックします。
Genieフィールドで正しいGenieが選択されていることを確認します。
Send business eventアクションの設定
User emailフィールドに、通知を受け取るユーザーのメールアドレスを入力します。
ユーザーアクセス
選択するユーザーは有効であり、このGenieへのアクセス権が割り当てられている必要があります。
Notification to userフィールドに移動し、Genieがイベントの処理を開始する前に送信する通知を入力します。
Business event dataフィールドに移動し、Genieに実行内容を伝えるプロンプトを入力します。 例:
Complete the following steps to process this lead:
- Search Salesforce for leads and then create or update the lead.
- Search Salesforce for matching accounts. Create or update the account and attach the lead.
- Research the company and lead on the internet.
- Provide a summary for the SDR by adding it to the lead in Salesforce.
- Prepare an agenda for the prospective call for the SDR.任意です。 Genieがユーザーとの以前の会話を継続できるようにする場合は、Conversation IDフィールドにConversation IDを入力します。
トリガーを設定します。
レシピをテストして、ワークフローがGenieと互換性があることを確認します。
保存をクリックします。
App EventsとAssign task to genieの比較
このセクションでは、ユースケースに適したツールがApp EventsかAssign task to genieアクションかを判断します。
次の点を確認してください: ユーザーがメッセージを受信し、場合によってはアクションを実行する必要がありますか。
- はい: App Eventsを使用
- いいえ: Assign task to genieアクションを使用
App Eventsにはユーザーが必要です。 Genieはチャットインターフェイスを通じて、特定の識別済みユーザーに連絡します。 ユーザーはメッセージを受信して応答し、会話が続行されます。
Assign task to genieにはユーザーは必要ありません。 Genieは推論し、スキルを呼び出し、構造化された結果をレシピに返すことで、バックグラウンドでタスクを処理します。 会話スレッドは作成されません。
App Eventsを使用する場合
App Eventsは次の場合に使用します:
- ユーザーに通知する必要があり、ユーザーがアクションを実行する必要がある場合があります。 たとえば、そのユーザーが作成したチケットが更新された場合や、更新商談の期限が近づいている場合です。
- プロセスの途中でユーザーの判断が必要です。 Genieはコンテキストとオプションを提示し、ユーザーが判断します。
- ダウンストリームのスキルにVerified User Accessが必要です。 Verified User Accessにはアクティブなユーザーセッションが必要です。
- フローにBusiness Approvalsが含まれています。 承認通知はユーザーのチャットインターフェイスに表示され、ユーザー操作が必要です。
- Genieがプロアクティブに会話を開始する必要があります。 たとえば、スケジュールされたリマインダーやイベントトリガー型アラートです。
App Eventsは構造化された値をレシピに返すことはできません。 レシピはイベントの送信後、Genieの完了を待たずにすぐに続行されます。
Assign task to genieを使用する場合
Assign task to genieアクションは次の場合に使用します:
- 処理が自動化され、結果がレシピにフィードバックされます。 たとえば、チケットの分類、ドキュメントの要約、請求書データの抽出です。
- ユーザーが存在しない、または必要ありません。 たとえば、バックグラウンドジョブやシステム間連携です。
- Genieの出力は、ユーザーへのメッセージではなく構造化データです。
- 複数のGenieがパイプライン内で連携する必要があります。 オーケストレーションを行うレシピは、専門のGenieに順番にタスクを割り当て、それぞれから構造化出力を収集できます。
Assign task to genieアクションは次とは併用できません:
- Verified User Access。ヘッドレス呼び出しにはユーザーコンテキストがないためです。
- Business Approvals。承認通知はユーザーのチャットインターフェイスを通じて配信されるためです。
- 権限認識型ナレッジベース。ユーザースコープの権限で取り込まれたナレッジベースは、ユーザーコンテキストがないとそれらの権限を適用しないためです。
これらはプラットフォームの制約であり、設定上の選択肢ではありません。
App EventsとAssign task to genieの比較
使用する機能を判断するには、次の比較を参照してください:
| App Events | Assign task to genie | |
|---|---|---|
| ユーザー必須 | はい ✅ | いいえ ❌ |
| レシピの一時停止と待機 | いいえ ❌ | はい ✅ |
| レシピへの構造化出力 | いいえ ❌ | はい ✅ |
| Verified User Access対応 | はい ✅ | いいえ ❌ |
| Business Approvals | はい ✅ | いいえ ❌ |
| 会話でのフォローアップ | はい ✅ | いいえ ❌ |
両方の機能の組み合わせ
最も強力なアーキテクチャでは、両方の機能を順番に組み合わせます。
レシピは、チケットの分類やエスカレーション基準の評価などの自動推論にAssign task to genieを使用します。 構造化された結果により、レシピはApp Eventsを使用して関連ユーザーに通知し、会話を開始できます。 推論は自動化され、判断はユーザーによって決定されます。
一般的なミス
Assign task to genieを使用すべき場面でApp Eventsを使用する: ビルダーは受信サポートチケットを自動的に分類する必要があります。 ビルダーはApp Eventsを使用して各チケットをエージェントに送信し、分類応答を待ちます。 これにより、チケットごとに会話スレッドが作成され、エージェントのチャットインターフェイスがGenieメッセージで埋まります。 この場合は、ユーザーの関与を必要としないAssign task to genieアクションを使用する必要があります。
App Eventsを使用すべき場面でAssign task to genieを使用する: ビルダーは更新商談が近づいたときに営業担当者に通知する必要があります。 ビルダーはAssign task to genieアクションを使用して更新イベントを処理し、要約をデータピルとして返します。 営業担当者は通知を受信しません。これは、Assign task to genieアクションがApp Eventsのようにチャットインターフェイスで会話を開始しないためです。
ユースケースの推奨事項
ワークフローに適した機能を選択するには、次のユースケースの推奨事項を参照してください:
| ユースケース | 機能 | 理由 |
|---|---|---|
| メールWebhookからチケットを分類 | Assign task to genie | ユーザー操作を必要としない自動出力 |
| 30日前に更新について営業担当者に通知 | App Events | 担当者がメッセージを受信する必要があり、対応する場合があります |
| 契約を要約し、主要条項を抽出 | Assign task to genie | 自動出力がダウンストリームのレシピにフィード |
| P1インシデントについてITエンジニアにアラートを送信 | App Events | エンジニアがエスカレーションするかどうかを判断 |
| チケットがエスカレーション基準を満たしているかどうかを評価 | Assign task to genie | 条件ロジックにフィードする出力を伴う自動推論 |
| ユーザーのチケットが更新されたことをユーザーに通知 | App Events | 特定のユーザーがメッセージを受信する必要があります |
| 担当者ごとに週次パイプライン要約を生成 | App Events | 各担当者がチャットインターフェイスでパーソナライズされたメッセージを受信 |
| 請求書PDFから構造化データを抽出 | Assign task to genie | レシピへの構造化出力を伴う自動抽出 |
ベストプラクティス
Genieワークフローが目標を満たすように調整されていることを確認するため、Workatoは次のベストプラクティスを推奨しています。
大量処理にEvent streamsを使用する
同期App Eventsは、管理可能なレートでイベントが到着し、各イベントがSend App Eventアクションを直接実行するレシピをトリガーするほとんどのユースケースに適しています。
同期処理では、大量処理のシナリオでパフォーマンスとコストのリスクが発生する可能性があります。 Event streamsを使用してイベントの取り込みとイベント処理を分離し、パフォーマンスを向上させることができます。
Event取り込みレシピを作成する。
プロジェクトでEvent取り込みレシピを作成し、次の規則に従って名前を付けます：Agentic | [Descriptive Name]。 例：Agentic | Jira Escalations。 このレシピは、Send App Eventを直接呼び出す代わりに、外部システムからイベントを受信します。
Send App EventアクションをPublish to Event Streamアクションに置き換える。
これにより、レシピは外部システムからイベントを受信し、イベントの処理を待たずに各イベントをEvent streamsトピックに公開できます。
Event streams topicは、公開されたイベントを消費されるまで永続キューに保存します。 処理レシピが遅い場合や一時的に利用できない場合でも、イベントは失われるのではなく、トピック内でキューに入れられます。
Event処理サブスクライバーレシピを作成する。
プロジェクトで2つ目のレシピを作成します。 トリガーをNew event in Event streamに設定し、トピックを選択します。 このレシピは、最初のレシピのEvent streamsトピックにサブスクライブし、キューから各イベントを読み取り、適切なGenieおよびユーザーでSend App Eventを呼び出します。
Last updated: