サービスアシスタントのコンテキスト変数の設定
サービスアシスタントがケースのクローズやレコードの更新などのアクションを、サービス担当者が手動で入力せずに完了できるように、有効なレコードの ID を指定します。
必要なエディション
| サポートされているエディションを表示する。 | |
 この記事の対象: |
すべてのサービスアシスタント環境。 |
| 必要なユーザー権限 | |
|---|---|
| Service Assistant でコンテキスト変数を設定する | 「サービスプランナービルダー」権限セット および 「システム管理者」または「アプリケーションのカスタマイズ」 |
メモ サービスアシスタントでのコンテキスト変数の参照ガイダンスは、「コンテキスト変数のグラウンディング」で提供されます。
まず、currentRecordId コンテキスト変数を作成します。次に、レコード ID が必要な各アクション (フロー、プロンプト テンプレート、Apex アクションなど) への入力として割り当てます。
この設定はフローベースのアクションに固有であるため、currentRecordId をフローに追加する手順が含まれています。プロンプトテンプレートや Apex アクションなど、他のアクション種別の場合は、currentRecordId をアクションの入力に割り当てます。
コンテキスト変数の設定
currentRecordId コンテキスト変数を作成し、説明を追加して、Service Assistant がいつ使用するかを把握できるようにします。
- Agentforce Builder で、エージェントを無効化します。
- [コンテキスト] タブを選択し、[新規変数] をクリックします。
-
次の値を入力します。
- 名前: currentRecordId
- API 参照名: currentRecordId
- データ型: Text
- 説明: ユーザーの画面のレコードの ID。ユーザーの入力に関連しない場合があります。これは、ユーザー入力で「this」、「current」、「the record」がメンションされている場合にのみ使用します。疑わしい場合は使用しないでください。
- [Allow value to be set by API] と [Allow LLM to use value] の両方を選択します。
- [保存] をクリックします。
- エージェントを再有効化します。
フローへのコンテキスト変数の割り当て
フローベースのアクションを使用する場合は、currentRecordId を入力変数として追加し、レコードを取得要素を更新して絞り込みます。
- Flow Builder で、フローを開きます。
- [新規リソース] をクリックし、[変数] を選択します。
-
次の値を入力します。
- API 参照名: currentRecordId
- データ型: テキスト
- [入力で使用可能] を選択します。
- [完了] をクリックします。
- もう一度 [新規リソース] をクリックし、[変数] を選択します。
-
次の値を入力します。
- API 参照名: レコード変数の名前 (caseRecord や messagingRecord など)
- データ型: レコード
- オブジェクト: フローで取得するオブジェクト (ケースまたはメッセージングセッション)
- [完了] をクリックします。
- [レコードを取得] 要素を開きます。
-
[Filter Records (レコードの絞り込み)] で、次の値を設定します。
- 項目: ケース ID またはメッセージングセッション ID
- 演算子: 次の文字列と一致する
- 値: currentRecordId
- [How to Store Record Data (レコードデータの保存方法)] で、[項目を選択して変数を割り当てる (詳細)] を選択します。
- [Where to Store Field Values (項目値を保存する場所)] で、[レコード変数で一緒に] を選択します。
- [Select Variable to Store Record (レコードを保存する変数を選択)] で、レコード変数 caseRecord または messagingRecord を選択します。
- フローを保存します。
Agentforce Builder に戻り、コンテキスト変数をアクションに割り当てます。
アクション入力へのコンテキスト変数の割り当て
アクション入力に currentRecordId を割り当てて、Service Assistant がセッションの開始時に現在のレコード ID を自動的にアクションに渡すようにします。
- Agentforce Builder で、アクションを開きます。
- 入力フィールドから、[Assign a Variable (変数を割り当て)] を選択し、[currentRecordId] を選択します。
- 入力フィールドで [入力で使用可能] が選択されていることを確認します。
- エージェントを保存して再有効化します。
- 新しいセッションを開始します。コンテキスト変数はセッション開始時に入力され、セッション中に更新されません。
currentRecordId の動作は、アクションで [ユーザー確認が必要] が選択されているかどうかによって異なります。
- [ユーザー確認が必要] が選択されていない場合、Service Assistant は担当者に確認を求めずにレコード ID を自動的にアクションに渡します。
- [ユーザー確認が必要] が選択されている場合、Service Assistant は一時停止し、レコード ID が事前入力された確認プロンプトを担当者に表示します。
この記事で問題は解決されましたか?
ご意見をお待ちしております。
