チャットインターフェイス ​

チャットインターフェイスは、エンドユーザーに表示されるGenieコンポーネントです。 チャットインターフェイスは、Slack、Microsoft Teams、Workato GO、カスタムチャットボットを使用する内部システムなど、組織が業務を行うプラットフォームに統合できます。 設定可能な認証を備えたカスタムチャットインターフェースを追加することもできます。 チャットインターフェイスには、次の機能が含まれます。

• 従業員がGenieとやり取りするためのユーザーフレンドリーなインターフェイス
• ブランドとユーザーエクスペリエンスの設定に合わせてカスタマイズ可能なUI要素
• ユーザーとGenie間のリアルタイムコミュニケーション

選択したインターフェースによって、ユーザーがGenieを見つけて操作できる場所、利用可能な機能、および会話の動作が決まります。 SlackおよびMicrosoft Teamsのチャットインターフェースには、チャンネルサポートが含まれます。 Workato GOは、検索、アクションボード、KPIダッシュボードを備えた専用のエンタープライズAIインターフェースを提供します。

ダイレクトメッセージサポート ​

Slack、Microsoft Teams、およびWorkato GOはダイレクトメッセージング（DMs）をサポートしています。 GenieはDMs内のすべてのメッセージに応答します。 DMsは、選択したチャネルモードに関係なく同じように動作します。

チャネルサポート ​

Genieは、DMに加えてSlackおよびMicrosoft Teamsチャンネルへの参加をサポートします。 これにより、ITヘルプデスク、HRサポート、およびプロジェクト支援チャネルのユースケースが可能になります。 Workato GOはチャネルサポートを提供していません。

チャネルサポートオプション ​

チャネルの動作は、Slackインターフェース設定の一部としてGenieビルダーで設定します。 詳細はチャネル応答を有効にするを参照してください。

チャネルドロップダウンメニューには、公開チャネルと、Genieが追加済みのプライベートチャネルのみが表示されます。 Genieが応答を許可される各チャネルを明示的に選択する必要があります。 チャネルがGenieチャットインターフェースに明示的に追加されていない場合、Genieはメッセージを黙って無視するのではなく、エラーメッセージを表示します。

チャネルモード ​

Genieをチャネルにデプロイする前に、Every message postedまたは@mentions onlyチャネルモードを選択して、Genieが応答するタイミングを制御できます。

Every message postedは、ユーザーがすべてのメッセージにGenieが応答することを期待するサポートチャネルを対象としています。 Genieはチャネル内のすべての新規メッセージに応答し、スレッドを作成します。 Genieは、そのスレッド内の任意のユーザーからの後続のすべてのメッセージに応答します。

@mentions onlyは、@mentionで明示的に呼び出された場合にのみGenieが参加する必要があるチャネルを対象としています。 Genieは、メインチャネル内かスレッド内かに関係なく、@mentionedされた場合にのみ応答し、他のすべてのメッセージを無視します。

スレッド履歴 ​

Genieはチャネルでトリガーされたとき、完全なスレッド履歴をコンテキストとして受け取ります。 履歴内の各メッセージには、Genieが送信者とそのメッセージを識別できるように、送信者の名前とメールアドレスがタグ付けされます。 以前のGenie応答もスレッド履歴に含まれます。

完全な履歴がモデルのコンテキストウィンドウを超えるスレッドでは、古いメッセージは自動的に要約され、最近のメッセージはそのまま含まれます。

@mentions onlyが選択され、長いスレッド内でGenieが複数回メンションされた場合、Genieは各新規応答のコンテキストとして、前回のメンション以降に追加されたメッセージのみを使用します。

同時リクエスト ​

Genieがスレッド内のリクエストをすでに処理していて、最初のリクエストが完了する前に別のメッセージがGenieをトリガーした場合、Genieは後続のトリガーに対して次のように応答します: I'm still working on something. Please give me a moment. ユーザーは最初のリクエストが完了した後に別のメッセージを送信できます。 以前にキューに入れられたすべてのメッセージが新しいコンテキストに含まれます。

チャネルでの認証 ​

GenieがWorkato Identity認証を必要とする場合、認証されていないユーザーはGenieをトリガーしたときにログインを求められます。

• Slack: Genieはスレッド内でログインプロンプトを送信します。 トリガーしたユーザーにのみプロンプトが表示されます。 ユーザーは認証後に操作を続行できます。

チャネルでのユーザー確認 ​

アクションに確認が必要な場合、Genieは確認ボタンをスレッドに送信します。 ボタンをクリックすると、確認の詳細を含むモーダルが開きます。 モーダルはユーザーのIDを検証します。 アクションの確認を求められていないユーザーがボタンをクリックすると、エラーメッセージを受け取ります。

確認モーダルは、テキスト、boolean、datetimeなどの標準入力タイプをサポートしています。 ユーザーは確認する前にフィールドを更新できます。

必須スコープ ​

チャットインターフェースアプリでチャネル内で応答するには、適切なスコープを有効にしておく必要があります。

Slack ​

新しいGenieを作成する場合、Slackには次のスコープが必要です:

Botスコープ ​

Slackには次のbotスコープが必要です:

• app_mentions:read
• assistant:write
• channels:history
• channels:read
• chat:write
• files:read
• files:write
• groups:history
• groups:read
• im:history
• im:write
• users:read
• users:read.email

ユーザースコープ ​

Slackには次のユーザースコープが必要です:

• users:read
• users:read.email

イベントサブスクリプションスコープ ​

Every message postedを使用する予定の場合、Slackには次のイベントサブスクリプションスコープが必要です:

• app_mention
• message.im
• assistant_thread_started
• message.channels

Microsoft Teams ​

Microsoft Teamsでは、次のスコープが必要です：

• AppCatalog.Read.All: GET /appCatalogs/teamsApps 用。 これにより、コネクション設定中にマニフェストのexternalIdからTeamsカタログアプリIDを解決します。 Connectedステータスに到達するために必要です。

• User.Read.All: ディレクトリ/ユーザー読み取り用。 これにより、メッセージ作成者と呼び出し元ユーザーを、会話に表示されるアイデンティティまたは表示名にマッピングします。 これはベースラインの読み取りスコープです。

• Team.ReadBasic.All: GET /teams 用。 これにより、ボットが属するチームを一覧表示し、チャネルのドロップダウンメニューとラベル付けを有効にします。

• Channel.ReadBasic.All: GET /teams/{team}/channels およびGET /teams/{team}/channels/{channel} 用。 これにより、チャネルを一覧表示し、チャネルの表示名を解決します。

• ChannelMessage.Read.All: GET /teams/{team}/channels/{channel}/messages/{id} (+ /replies) 用。 これにより、ルートメッセージと返信を含むチャネルスレッドを読み取り、Genieがチャネルで@mentionedされたときにGenieに会話コンテキストを提供します。

• Files.Read.All: GET /shares/{url}/driveItem 用。 これにより、添付ファイルの共有URLをdriveItemまたはダウンロードURLおよびサイズに解決し、Genieが会話で共有されたファイルを読み取れるようにします。 このスコープがないと、添付ファイルを処理できません。

中間メッセージ ​

Intermediate messagesは、サポートされているすべてのチャットインターフェースで自動的に有効になります。

各Genieは、最終応答を返す前にタスクを処理する中で、リアルタイムのステータス更新や部分的な結果を含む中間メッセージを送信します。 たとえば、ユーザーがGenieにナレッジベースの要約を依頼した場合、Genieは最終的な2文の要約を返す前に、I'll search the knowledge base and provide you with a summaryなどの中間メッセージを最初に送信します。

中間メッセージを無効にする ​

プロジェクトレベルでGenieの中間メッセージを無効にできます。

プロジェクト内でGenieの中間メッセージを無効にするには、次の手順を実行します。

チャットインターフェイスの使用開始 ​

ジョブの説明、AIモデル、チャットインターフェース、ナレッジベース、ナレッジベースレシピ、およびスキルを含むGenieの作成手順全体については、最初のGenieを作成するを参照してください。

Genieを作成し、そのチャットインターフェイスを設定するには、次の手順を実行します。

チャットインターフェイスを設定するには、次の手順を完了します: