LAMPAgentforce連携Agentforceでメッセージ履歴を取得する

Agentforceでメッセージ履歴を取得する

LAMPのAgentforce拡張パッケージには、友だちやグループとのメッセージ履歴を扱うサブエージェント「LINE履歴の確認」が含まれます。Agentforceのエージェントに追加すると、履歴の要約や、過去のやり取りについての質問に答えられるようになります。

この記事では、Salesforceを利用する担当者向けのエージェントに、このサブエージェントを追加する例を紹介します。

アセットライブラリで検索する名称は「LINE履歴の確認」です。

サブエージェントには、履歴を取得するアクション「会話タイムラインを取得」と、回答のしかたを決める推論指示が設定済みです。アクションを個別に作成する必要はありません。

事前に準備するもの

  • Igness LAMP 1.163.0.3以降がインストールされ、初期設定・公式アカウントの接続が完了しているSalesforce組織。
  • Igness LAMP - Agentforce Extension Package 1.1.0.2以降。Einstein生成AIが有効な組織でのみインストールできます。
  • Agentforceが有効で、編集・テストできる担当者向けのエージェント。Agentforceに必要なライセンス・権限はSalesforce側でご準備ください。
  • LAMPのチャットでメッセージ履歴を確認できる、テスト用の友だちレコード。

バージョンはSalesforceの「設定」→「インストール済みパッケージ」で確認できます。

1. 拡張パッケージをインストールする

Agentforce拡張パッケージ(バージョン1.1.0.2以降)をインストールします。インストール方法と必要な環境は、「Agentforce拡張パッケージ」とは?をご覧ください。

2. エージェントにサブエージェントを追加する

  1. Agentforce Builderで対象の担当者向けエージェントを開きます。
  2. エクスプローラーの「リソースを追加」(+)→「アセットライブラリから追加」を開きます。
  3. 「LINE」で検索し、「LINE履歴の確認」の「選択」をクリックしてから、「エージェントに追加」をクリックします。

アセットライブラリで「LINE履歴の確認」を検索した画面

追加すると、サブエージェントに推論指示と「会話タイムラインを取得」アクションが設定された状態で表示されます。

推論指示とアクションが設定された「LINE履歴の確認」サブエージェント

  1. 日本語で利用する場合は、「言語設定」のデフォルト言語を「Japanese」にします。
  2. 「保存」をクリックします。
⚠️

言語を変更した後、プレビューで「コンパイルエラーが発生しました」と表示される場合があります。

エラーの内容が「Missing value for ‘additional_locales’」などLanguageに関するものであれば、Builderの右上の表示切り替えで「スクリプト」を開き、language: の部分を次のように1行ずつに直して保存してください。

language:
    default_locale: "ja"
    additional_locales: ""
    all_additional_locales: False

推論指示は、エージェント内で自由に書き換えられます。回答の形式や、未回答の質問の扱いなどを業務に合わせて調整してください。

⚠️

拡張パッケージをアップグレードしたら、「LINE履歴の確認」を追加し直してください。

サブエージェントの推論指示とアクションの設定は、エージェントに追加したときにエージェントへ写し取られます。そのため、拡張パッケージをアップグレードしても、追加済みのサブエージェントは新しい内容になりません。アップグレードした後は、エージェントから「LINE履歴の確認」を削除し、アセットライブラリから追加し直してください。追加し直すと、自社で書き換えた推論指示は元に戻るので、書き換えた内容を事前に控えておき、追加し直した後にもう一度反映してください。

3. 友だちレコードIDを指定して試す

  1. LAMPの「友だち」から、メッセージ履歴があるテスト用レコードを開きます。
  2. URLの /igns__SocialFriend__c/ と /view の間にある、15桁または18桁のレコードIDをコピーします。
  3. Agentforce Builderの会話プレビューで、次のように依頼します。<友だちレコードID> はコピーしたIDに置き換えてください。

新しいBuilderでは「Preview」タブの「ライブテスト」を使います。

友だちレコードID「<友だちレコードID>」のメッセージ履歴を要約してください。

続けて「この履歴の中で、まだ回答していない質問はありますか?」などと質問できます。期間を区切って聞くこともできます。

友だちレコードID「<友だちレコードID>」の、先週のやり取りを要約してください。

プレビューの実行内容で、履歴取得アクションが呼ばれたこと、入力の友だちレコードIDが正しいこと、errorMessage が空で transcript に内容が返っていることを確認してください。期間を区切って聞いた場合は、入力の after・before に期間が入っていることも確認します。回答が元のチャットの内容と一致することも確認します。

以下は、検証用の架空の会話5件を取得して要約した例です。在庫・価格・ギフト包装には回答済みで、金曜日までの配送についての質問は未回答であることを、取得した履歴から確認できています。

取得したメッセージ履歴を要約し、回答済みと未回答の質問を区別したライブテストの画面

実運用でIDを毎回入力したくない場合は、表示中のレコードや関連レコードから対象の友だちIDを渡す設定を別途行います。LAMPのチャットコンポーネントを配置するだけでは、Agentforceに対象の友だちIDは渡りません。

グループの履歴を確認する

Igness LAMP 1.165 以降と Agentforce 拡張パッケージ 1.3 以降では、公式アカウントが参加しているグループのやり取りも取得できます。友だちレコード ID の代わりにグループ(igns__SocialGroup__c)のレコード ID を渡すと、発言者の名前付きでグループの履歴を返します。それより前のバージョンからアップグレードした場合は、上の注意のとおり、エージェントから「LINE履歴の確認」を削除し、アセットライブラリから追加し直してください。画面での使い方は グループトークでメッセージをやり取りしたい をご覧ください。

アクションの入力と出力

「会話タイムラインを取得」アクションは、次の値を受け取ります。

入力API名内容
友だち・グループのレコードIDsocialFriendId必須。友だち(igns__SocialFriend__c)またはグループ(igns__SocialGroup__c)のレコードID
最大件数maxMessages通常は指定しません
この時点以降after期間の始まり。日付(YYYY-MM-DD)または日時(YYYY-MM-DDTHH:mm)
この時点より前before期間の終わり。日付または日時、または前回の出力の nextBefore

次の値を返します。

出力API名内容
会話履歴transcript日時と話者の付いた、古い順のテキスト
件数messageCount会話履歴に含まれるメッセージの件数
さらに古い履歴ありhasMore取得した範囲より古い履歴が残っていれば true
続きの取得位置nextBeforeさらに古い履歴を取得するときに before へ渡す値
最古の日時oldestDatetime会話履歴の中で一番古いメッセージの日時
現在日時currentDatetime実行した時点の日時
エラーerrorMessage取得できなかったときの理由。取得できたときは空

取得できる履歴の範囲

このアクションは、指定した友だちまたはグループのメッセージ履歴を、新しいものから順に、約12,000文字の上限に収まるところまで1回でまとめて取得します。範囲は件数ではなく文字数で決まるため、短いメッセージが多い会話ほど多くの件数をさかのぼれます(最大500件)。メッセージの本文は途中で切らずに1件ずつ丸ごと入れ、担当者側から同じ文面を何度も送っている場合(定型の自動返信など)は、最新の1件だけを残して文字数を節約します。

取得した履歴は、古い順のテキストで返ります。日付が変わるところに「■2026-10-01」のような見出しが入り、各行の先頭には「14:05 お客さま:」「14:07 担当者:」のように時刻と話者が付きます。グループの履歴では、「お客さま」の代わりに発言した人の名前が入ります。お客様が引用して返信したメッセージには引用元の日時・話者・本文の先頭が、ケースなどのレコードに紐づいたメッセージ(Igness LAMP 1.166 以降)にはそのレコードの種類・名前・IDが、行末に付きます。このため、「1週間前の件」のように日付を手がかりにした質問にも答えられます。

期間を区切って取得することもできます。入力の「この時点以降」(after)に期間の始まりを、「この時点より前」(before)に期間の終わりを渡します。「この時点より前」に指定した時点ちょうどのメッセージは含まないので、たとえば9月中のやり取りなら、after に 2026-09-01、before に 2026-10-01 を渡します。サブエージェントの推論指示には、「先週」「9月中」のような言い方を、実行した日を基準にこの2つへ換算する指示が入っています。担当者は、ふだんの言葉で期間を伝えるだけで構いません。

文字数の上限に達して、それより古い履歴が残っている場合は、出力の「さらに古い履歴あり」(hasMore)が true になり、「続きの取得位置」(nextBefore)に値が入ります。この値を次の実行の「この時点より前」に渡すと、続きの古い履歴を取得できます。推論指示では、担当者がさらに古い履歴の確認を求めたときだけ続きを取得し、それ以外のときは、取得した中で一番古い日時(oldestDatetime)より前は確認していないことを回答に添えるようにしています。

画像・動画・添付ファイルの中身は読み取りません。返された本文を回答の根拠にします。また、複数の友だちやグループをまたいだ検索には対応していません。

見つからない・取得できない場合

状況確認すること
アセットライブラリに「LINE履歴の確認」が出てこない「インストール済みパッケージ」で、Agentforce Extension Packageが1.1.0.2以降か確認します。インストール・アップグレード後はBuilderを開き直してください。
「レコードIDの形式が正しくありません」(1.164 以前は「友だちレコードIDの形式が正しくありません」)LINEのユーザーID、ケースID、取引先責任者IDではなく、igns__SocialFriend__c(グループの場合は igns__SocialGroup__c)のレコードIDを渡します。
「対象の友だちレコードが見つからないか、アクセス権がありません」「対象のグループレコードが見つからないか、アクセス権がありません」実行ユーザーのオブジェクト・項目・レコード共有権限と、友だち(またはグループ)の公式アカウントとの紐づけを確認します。
「会話履歴を取得できませんでした」対象のチャットに履歴があるか、LAMPの接続・認証設定と実行ユーザーの外部ログイン情報へのアクセス権を確認します。期間を指定せずに実行して履歴が1件もなかった場合も、このメッセージになります。このメッセージだけで、履歴が存在しないと断定しないでください。
「指定した期間の会話履歴はありません」期間(after・before)の中にメッセージがありません。プレビューの実行内容で、渡された期間が質問の意図どおりかを確認します。before に指定した時点ちょうどのメッセージは含まれません。
履歴取得が呼ばれない「LINE履歴の確認」がエージェントに追加・保存されているか、質問に友だちレコードIDが含まれているかを確認します。プレビューの実行内容で、どのサブエージェントに振り分けられたかを確認できます。

管理者向け:実行ユーザーの権限

権限は、エージェントを設定する管理者だけでなく、実際にアクションを実行するユーザーに必要です。エージェントの種類や実行場所に応じて、ログイン中の担当者またはエージェント実行ユーザーを確認してください。

  • Apexクラス igns__LampGetTimelineHistoryAction へのアクセス。
  • 友だち(igns__SocialFriend__c)・公式アカウント(igns__SocialAccount__c)の参照権限と、対象レコードの共有。
  • 友だちのユーザーID(igns__UserId__c)など、履歴取得に使う項目の参照権限。
  • 外部ログイン情報 igns__APIAccess のプリンシパル Principal へのアクセス。

Einstein Agent Userライセンスの実行ユーザーでは、LAMPの一般ユーザー向け権限セットをそのまま割り当てられない場合があります。その場合は、上記の参照・実行権限を含む専用の権限セットを作成してください。