LAMP自動応答Agentforceで応答したい

Agentforceで応答したい

このガイドを読むと、以下のことが理解できるようになります

  • 応答種別「Agentforce」の動き
  • LAMPから呼び出すためのAgentforce側の準備
  • 自動応答へのつなぎ方

「Agentforce」とは

応答種別「Agentforce」は、Salesforce の Agentforce で作成したエージェントが、LINEの友だちに返信します。Agentforce のアクション(Apex・フローなど)やナレッジをそのままLINEの応対に使えます。

LAMPが受信したメッセージを Agentforce に渡し、返ってきた回答をLINEに送ります。会話は Agentforce のセッションとして続き、LAMPの会話が終わるまで同じセッションでやり取りします。

自動応答で Agentforce を使うのに、Agentforce拡張パッケージは必要ありません。拡張パッケージは、エージェントにLINEのメッセージ履歴を読ませたいときなどに追加します(Agentforce連携)。

事前に準備するもの

  • Igness LAMPがインストールされ、初期設定・公式アカウントの接続が完了しているSalesforce組織
  • Agentforce が使えるSalesforce組織と、顧客向けのエージェント(サービスエージェント)。ライセンスと権限はSalesforce側でご準備ください

1. エージェントで友だちのIDを受け取る

LAMPは Agentforce を呼び出すとき、質問文と一緒に、友だちを特定する値を渡します。SocialFriendId は友だちのレコードIDで、いつも渡します。友だちに取引先責任者やリードが紐づいていれば、そのレコードIDを Contact と Lead という名前で渡します。エージェントのアクションで友だち本人のレコードを使う場合は、エージェントにこの名前の変数を用意してください。

LAMPが質問文と友だちIDを渡し、エージェントのメッセージングセッション変数 SocialFriendId に入った値をアクションが使う。カスタム変数で作ると値は入らない(クリックで拡大)

変数は 「メッセージングセッション変数」 として作ります。「カスタム変数」で作ると、「API 更新アクセス権を有効化」にチェックを入れても、LAMPが渡した値は入らず空のままになります。メッセージングセッション変数はメッセージングセッションの項目から作るので、先に Salesforce の設定で項目を1つ用意します。

項目を作る

[設定]の[オブジェクトマネージャー]で「メッセージングセッション」を開き、[項目とリレーション]から[新規]をクリックします。データ型は「テキスト」を選びます。

詳細の入力では、項目名を SocialFriendId にします。この項目名が、そのまま変数の名前になります。表示ラベルは「LINE友だちID」など分かりやすい名前で構いません。文字数は 18 です。項目レベルセキュリティとページレイアウトは既定のまま保存します。

メッセージングセッションのカスタム項目の新規作成。項目の表示ラベル「LINE友だちID」、文字数 18、項目名 SocialFriendId(クリックで拡大)

この項目に値が保存されることはありません。変数を作るための足場として使います。

変数を追加する

Agentforce Builder で対象のエージェントを開きます。有効なバージョンは編集できないので、[新しいバージョン]で下書きを作ってから進めます。エクスプローラーの「変数」を開き、[新規]から [メッセージングセッション変数を追加] を選びます。

Agentforce Builder の変数。新規メニューから「メッセージングセッション変数を追加」を選ぶ(クリックで拡大)

一覧の検索は表示ラベルで行います。作った項目(例では「LINE友だちID」)を探してチェックを入れ、[エージェントに追加]をクリックします。API の列が SocialFriendId__c になっていることを確かめてください。

メッセージングセッション変数を追加。LINE友だちID(API SocialFriendId__c)にチェックを入れて「エージェントに追加」をクリックする(クリックで拡大)

変数一覧の「名前」には表示ラベルが出ます。変数の名前そのものは、編集エリア右上の切り替え(</>)でスクリプト表示にすると確認できます。SocialFriendId: linked string となっていれば正しく作れています。

スクリプト表示の variables。SocialFriendId: linked string と、source: @MessagingSession.SocialFriendId__c が表示される(クリックで拡大)

あとは、友だちのレコードを読むアクションの入力にこの変数を割り当てます。取引先責任者やリードのIDも受け取りたい場合は、同じ手順で項目名 Contact、Lead の項目を作って変数を追加してください。友だちのIDがあれば、アクションの中で紐づく取引先責任者やリードを調べることもできます。

エージェントスクリプトを直接編集する場合は、variables に次のように書いても同じです。

variables:
    SocialFriendId: linked string
        label: "LINE友だちID"
        source: @MessagingSession.SocialFriendId__c
⚠️

値が届かないときは、変数の種類と名前を確かめてください。 カスタム変数で作った変数や、名前が SocialFriendId と大文字・小文字まで一致しない変数には、エラーにならないまま値が入りません。以前の手順に沿ってカスタム変数で作っている場合は、メッセージングセッション変数で作り直してください。値が入るのは会話の始めだけなので、会話の途中で友だちの紐づけを変えても、その会話には反映されません。

💡

メッセージングセッション変数は、エージェントのすべてのバージョンで共有されます。下書きで削除すると、有効なバージョンにも影響することがあります。作り直すときは、新しいバージョンを有効化するところまで続けて行ってください。

2. API参照名を確認して有効化する

エクスプローラーの「エージェントの詳細」で API 参照名 を確認し、控えておきます。LAMPにはエージェント名ではなく、この API 参照名を設定します。

編集が終わったら[バージョンを確定]をクリックし、続けて[有効化]をクリックします。有効になっていないエージェントは、LAMPから呼び出せません。

エージェントの詳細。API参照名を確認する。画面上部にバージョンと有効の状態が表示される(クリックで拡大)

💡

「言語設定」を Japanese に変更した後にコンパイルエラーが出る場合は、Agentforceでメッセージ履歴を取得するの手順2にある直し方をご覧ください。

3. 自動応答にエージェントをつなぐ

[自動応答]タブで自動応答を作成し、応答種別を「Agentforce」にします(作成の手順は自動応答の設定)。

保存すると、「設定」タブに次の欄が表示されるので設定します。

  • 「AI応答設定」のAgentforce エージェントAPI名: 2で控えた API 参照名
  • 「AI応答設定」の送信元: Agentforce の返信に使う名前・アイコン(任意)
  • 「反応テンプレート」のテンプレート: 会話の始まりに送るテンプレート(「常に反応」以外では必須)
  • 「AI応答終了設定」の会話終了までの時間(h): 会話を自動で終える目安。詳しくはAIとの会話終了時の設定をしたい

最後に[状況を完了としてマーク]で状況を「有効」にします。

応答種別「Agentforce」の自動応答。AI応答設定に Agentforce エージェントAPI名を入力する(クリックで拡大)

会話の始まり方と注意点

会話の始まり方はエージェントと同じです。AND・OR・アクションからの呼出では反応テンプレートを送り、次に届いたメッセージから Agentforce が返信します。「常に反応」では、届いたメッセージにすぐ返信します。

  • Agentforce に渡すのはテキストです。友だちが送った画像は「[画像メッセージ]」という文字に置き換えて渡します。
  • Agentforce の返信はテキストとしてLINEに送ります。
  • 返信を作れなかったときは、LAMPが用意した固定のお詫びメッセージを送ります。エージェントの「詳細」タブのエラーメッセージ(応答種別「エージェント」用)は使いません。
  • エージェントのアクションは、エージェントの「エージェントアクセス」で指定したユーザーの権限で動きます。アクションで読み書きするオブジェクト・項目の権限を、そのユーザーに付与してください。
⚠️

公開前に、テスト用のキーワードで動きを確かめてください。 「常に反応」で有効にすると、すべての友だちのメッセージに Agentforce が返信します。