AgentForce Agent を呼び出す
概要
The Agentforce エージェントの呼び出し このインタラクションにより、Avonni ダイナミックコンポーネント内から直接、Agentforce エージェントにメッセージを送信できます。これにより、AI による支援とインテリジェントな自動化をユーザーインターフェースに統合する強力な手段が提供され、ユーザーは現在のページを離れることなくエージェントの機能を活用できます。
重要
このインタラクションを使用する前に、まず Salesforce の Agent Builder で Agentforce エージェントを作成し、設定する必要があります。 このインタラクションは、ダイナミックコンポーネントと既存のエージェントをつなぐコネクタであり、エージェント自体の作成や設定は行いません
開始前に必要なもの
有効な Agentforce エージェント
Salesforce セットアップ → Agent Builder で作成
トピック、アクション、手順が完全に設定されている
有効化され、リクエストを受け取れる状態である
必要なデータにアクセスするための権限が設定されている
エージェントの API 名
Agent Builder でエージェントの詳細を表示した際に確認可能
これはインタラクション設定で使用する一意の識別子です
例:
Account_Summarizer_AgentまたはCustomer_Service_Agent
Agent Builder でエージェントが作成されていない場合、このインタラクションは機能しません。 このインタラクションは既存のエージェントをトリガーします。すべての AI 挙動、データアクセス、応答ロジックはエージェント側で設定する必要があります。
Agent Builder とダイナミックコンポーネントの連携方法
Agent Builder: エージェントの動作、アクセス可能なデータ、応答方法を定義する場所
ダイナミックコンポーネント: エージェントをトリガーし、その応答を表示するユーザーインターフェースを作成する場所
このインタラクション: コンポーネント内のユーザー操作を Agent Builder でのエージェント実行に結びつけるブリッジ
Agentforce は初めてですか？ エージェントの作成方法を学ぶには Salesforce Agent Builder ドキュメントを参照してください。エージェントの準備ができたら、ここに戻ってダイナミックコンポーネントと統合しましょう。
サポートされているコンポーネント
次の Avonni ダイナミックコンポーネントに「Agentforce エージェントの呼び出し」インタラクションを追加できます:
ボタン
ボタングループ
ボタンメニュー
アイコンボタン
データテーブル（ヘッダー操作）
リスト項目
重要
「Agentforce エージェントの呼び出し」インタラクションは、バックグラウンドで実行されるプログラム的な呼び出し用に設計されています。エージェントはメッセージを処理し、ダイナミックコンポーネント内で取得・利用できる応答を返します。
仕組み
ユーザー操作: ユーザーがコンポーネントを操作します（例: ボタンをクリック）。
エージェント呼び出し: 「Agentforce エージェントの呼び出し」インタラクションが、指定した Agentforce エージェントにメッセージを送信します。
データ引き渡し（任意）: コンテキストや具体的な指示を与えるために、パラメータをエージェントへ渡すことができます。
エージェント処理: エージェントは設定済みのトピック、アクション、AI 機能を用いてメッセージを処理します。
応答の取得（任意）: エージェントの応答は、ダイナミックコンポーネント内で使用するためにリソースに保存できます。
実行後アクション（任意）: エージェントが応答した後に実行するアクションを設定できます（例: 成功やエラー時にトーストを表示）。
設定
「Agentforce エージェントの呼び出し」インタラクションは、（ボタンのクリックなどの）ユーザー操作を Agentforce エージェントに接続します。設定すると、エージェントにメッセージを送り、必要に応じてコンテキストのためのパラメータを渡し、エージェントの応答を取得し、成功・エラーのシナリオを処理します。
対応する Avonni コンポーネントのプロパティパネルの「Actions」または「Interactions」から、このインタラクションを追加します。インタラクションタイプとして「Agentforce エージェントの呼び出し」を選択します。
エージェント API 名
どの Agentforce エージェントがリクエストを処理するかを識別します。Agent Builder で作成したエージェントの API 名を入力してください。これは、インタラクションがトリガーされた際に Salesforce がどのエージェントを呼び出すかを示す一意の識別子です。
ユーザーメッセージ
これはエージェントに送るプロンプトまたは質問です。AI に与える指示だと考えてください。メッセージは次のようにできます:
固定テキスト: 「この取引先を要約して」のような固定メッセージ
マージ構文による動的テキスト: コンポーネントから変数を含めるには、
{!variableName}表記を使います。例えば、「この取引先を要約できますか {!combobox1.selectedItemSObject.Id}」のように選択された取引先 ID をメッセージに動的に挿入しますコンテキスト重視: 静的な指示と動的データを組み合わせ、エージェントに必要な情報をすべて与えます
エージェントはこのメッセージを受け取り、設定されたトピックとアクションに従って処理します。
パラメータ （任意）
パラメータにより、ユーザーメッセージ以外の追加の構造化データをエージェントに渡せます。エージェントが特定の名前付き入力を想定している場合や、主要なプロンプトとは別にコンテキストを提供する必要がある場合に有用です。
各パラメータごとに指定する内容:
名前： Agent Builder で定義された、エージェントが想定するパラメータ識別子
値： 渡す内容 — 固定値、コンポーネント属性、またはリソース変数のいずれか
単なるテキストメッセージの解析ではなく、構造化入力が必要な場合にパラメータを使用します。
応答格納リソース名
インタラクションがエージェントの応答をどこに保存するかを指定します。ダイナミックコンポーネント内のテキスト変数名を入力します。エージェントが応答すると、その回答は自動的にこの変数に保存され、次の用途に利用できます:
テキストコンポーネントでの表示
数式や条件ロジックでの利用
内容に応じた追加アクションのトリガー
他のインタラクションやフローへの引き渡し
リソースを指定しない場合でも、エージェントはリクエストを処理しますが、応答を取得・表示することはできません。
手順付きの例
Agentforce で選択した取引先を要約する
実用的な例として、ユーザーがデータテーブルから複数の取引先を選択し、ボタンをクリックして AI による要約を取得できるようにしてみましょう。
シナリオの概要
ダイナミックコンポーネント内に、取引先の一覧を表示する Avonni データテーブルがあります。ユーザーは次のことができます:
データテーブルで 1 件以上の取引先にチェックを付ける
テーブルのヘッダーアクションで「選択分を要約」ボタンをクリックする
Agentforce エージェントから選択した取引先の AI 生成要約を受け取る
開始前に
前提条件:
Agent Builder で作成・設定された Agentforce エージェント
取引先レコードを表示する Avonni データテーブルコンポーネント
データテーブルで行選択が有効（チェックボックスが表示）になっていること
設定手順
データテーブルの準備
まず、取引先を表示するデータテーブルを設定し、ユーザーがレコードを選択してエージェントをトリガーできるように構成します。これが対話的な要約機能の基盤となります。
データテーブルを追加
ダイナミックコンポーネントに Avonni データテーブルを追加します
取引先（Account）レコードを表示するように設定します
API 名: これを控えておきます（例:
Datatable1）— 後で選択行を参照するのに必要です
行選択を有効化
データテーブルのプロパティで、行選択（チェックボックス）を有効にします
これにより、ユーザーは要約したい取引先を複数選択できます
ヘッダーアクションボタンを追加
データテーブルの Header Actions セクションで
「選択した取引先を要約」のようなラベルのボタンを追加します
このボタンがクリック時にエージェント呼び出しをトリガーします
「Agentforce エージェントの呼び出し」インタラクションを設定
ここでは、ユーザーが「選択した取引先を要約」ボタンをクリックしたときの挙動を設定します。
ヘッダーアクションボタンを選択
手順 1 で作成したボタンをクリック
インタラクションを追加
ボタンのプロパティで、新しいアクション／インタラクションを追加します
選択してください 「Agentforce エージェントの呼び出し」
エージェント設定を構成 インタラクション設定で次の項目を入力します: エージェント API 名 Agent Builder にあるエージェントの API 名を入力します。例:
Account_Summarizer_Agentエージェントの API 名の確認方法: Agent Builder → エージェントを選択 → エージェント詳細から API 名をコピー
ユーザーメッセージ: これはエージェントに送るプロンプトです。以下のテンプレートをコピー＆ペーストし、必要に応じてカスタマイズしてください:
System:
あなたは Salesforce に精通した営業アナリストです。簡潔かつ構造的に回答してください。
User:
ユーザーが選択した次の Salesforce 取引先を要約してください。
含める内容: 取引先数、ARR／年間売上（あれば）、主要業種、共通の製品、顕著なホワイトスペース、そして 5 つの箇条書きによるエグゼクティブサマリー。
レコード ID:
{!Datatable1.selectedRowsKeyValue}重要: 次を置き換えてください Datatable1 実際のデータテーブルの API 名で。
これが行うこと:
{!Datatable1.selectedRowsKeyValue}ユーザーが選択したすべての取引先の ID を動的に挿入しますエージェントはこれらの ID を受け取り、Salesforce から取引先の詳細を照会できます。
応答格納リソース名
入力先: agentResponse
これは手順 2 で作成した変数名です。エージェントの要約はここに保存されます。
エージェントの応答を表示
これでエージェントインタラクションが設定され、 agentResponse 変数に応答を保存するようになったので、この要約をユーザーに表示する必要があります。エージェントが結果を返した後にのみ表示されるコンポーネントを追加します。
表示用コンポーネントを追加
要約を表示するコンポーネントを追加します（例: プロフィールカード, テキスト表示、または リッチテキスト コンポーネント）
ダイナミックコンポーネントのキャンバス上の見やすい場所に配置します
コンポーネントの内容を設定
コンポーネントのプロパティで、テキスト内容を表示するフィールドを見つけます
値を次に設定
{!agentResponse}エージェントが返した内容がそのまま表示されます
コンポーネントの表示制御を設定 （任意だが推奨）
表示コンポーネントを選択
プロパティパネルの コンポーネントの表示制御を設定 を探します
応答がある場合にのみコンポーネントが表示されるよう条件を作成します:
{!agentResponse} IS NOT NULLこれが行うこと: エージェントが応答を返すまでコンポーネントは非表示のままです。 agentResponse にデータが入ると、コンポーネントは自動的に要約を表示して現れます。
ここまでで達成したこと: ユーザーが「選択した取引先を要約」ボタンをクリックすると、AI 生成の要約が画面に表示されるようになります。要約コンポーネントは実際に表示する内容があるまで非表示のままなので、インターフェースがすっきり保たれます。
重要な考慮事項
エージェント設定: Agentforce エージェントが、必要なトピック、アクション、権限で適切に設定され、リクエストを処理できることを確認します。
メッセージ形式: ユーザーメッセージを明確に構造化し、意図を正しく理解できるようにします。マージ構文で関連コンテキストを含めてください。
パラメータ名: パラメータを使用する場合、パラメータ名がエージェントの想定と一致していることを確認します。
応答の扱い: エージェントの応答をどのように使うか（ユーザー表示、レコード更新、追加アクションのトリガーなど）を計画します。
エラー処理: 「On Error」アクションを使用して、エージェント呼び出し中に発生する可能性のあるエラーを適切に処理します。
パフォーマンス: エージェントの呼び出しには処理に数秒かかる場合があります。ローディング指標や案内メッセージの追加を検討し、ユーザーの期待を管理してください。
まとめ
「Agentforce エージェントの呼び出し」インタラクションは、ダイナミックコンポーネントに AI 駆動のインテリジェンスを追加するための有用な機能です。設定には、呼び出すエージェントの指定、動的コンテキストを含むユーザーメッセージの作成、パラメータの受け渡し、応答の取得、成功・エラーアクションの定義が含まれます
最終更新
役に立ちましたか？