チャネルサポート ​

GenieはSlackおよびMicrosoft Teamsチャネルへの参加をサポートしています。 チャネルサポートは、ITヘルプデスク、HRサポート、プロジェクト支援チャネルに使用できます。 Workato GOはチャネルサポートを提供していません。

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

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

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

チャネルモード ​

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

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

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

スレッド履歴 ​

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

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

@メンションのみが選択されている場合、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が会話で共有されたファイルを読み取れるようにします。 このスコープがないと、添付ファイルを処理できません。