Apex エージェントアクションを作成する

学習の目的

この単元を完了すると、次のことができるようになります。

Apex エージェントアクションを作成する。
トピックにエージェントアクションを追加する。
エージェントアクションをテストする。

メモ

日本語で受講されている方へ
Challenge は日本語の Trailhead Playground で開始し、かっこ内の翻訳を参照しながら進めていってください。Challenge での評価は英語データを対象に行われるため、英語の値のみをコピーして貼り付けるようにしてください。日本語の組織で Challenge が不合格だった場合は、(1) この手順に従って [Locale (地域)] を [United States (米国)] に切り替え、(2) [Language (言語)] を [English (英語)] に切り替えてから、(3) [Check Challenge (Challenge を確認)] ボタンをクリックしてみることをお勧めします。

翻訳版 Trailhead を活用する方法の詳細は、自分の言語の Trailhead バッジを参照してください。

Apex エージェントアクションを構築する

Apex の準備ができましたので、これをアクションに追加しましょう。Apex のパラメーターが自動的にアクションに引き継がれる様子が確認できます。

歯車アイコンをクリックして、[Setup (設定)] を選択します。
[Setup (設定)] の [Quick Find (クイック検索)] ボックスで [Agentforce Agents (Agentforce エージェント)] を検索して選択します。
[Actions (アクション)] タブをクリックします。
[New Agent Action (新規エージェントアクション)] をクリックします。
[Reference Action Type (参照アクション種別)] で [Apex] を選択します。
[Reference Action Category (参照アクションカテゴリ)] で [Invocable Method (呼び出し可能なメソッド呼び出し可能なメソッド)] を選択します。
[Reference Action (参照アクション)] で [Check Weather (天気を確認)] を選択します。これが呼び出し可能なメソッドです。

[Agent Action Label (エージェントアクション表示ラベル)] では、呼び出し可能なメソッドのラベルパラメーターから取得された Check Weather (天気を確認) をそのまま使用します。
[Agent Action API name (エージェントアクション API 参照名)] では、自動生成された Check_Weather をそのまま使用します。
[Next (次へ)] をクリックします。

次のステップは、エージェントアクションの設定です。ここでは、Apex に設定したパラメーターがどのように役立つのかが見えてきます。

[Agent Action Instructions (エージェントアクション指示)] では、Apex の呼び出し可能なメソッドの description パラメーターから取得された値をそのまま使用します。
[Show loading text for this action (このアクションで読み込み中テキストを表示)] チェックボックスをオフにします。
[Input (入力)] には [dateToCheck] が事前入力されています。
[Instructions (説明)] には、Apex の呼び出し可能な変数の description パラメーターから取得された値が事前入力されています。必要に応じて説明を編集したり追加したりできます。
[Data Type (データ型)] も Apex のデータ型から取得されています。
required パラメーターが true に設定されているため、[Required (必須)] チェックボックスはデフォルトでオンになっています。
[Collect data from user (ユーザーからデータを収集)] チェックボックスをオンにします。

出力には、Apex の呼び出し可能な変数から取得された maxTemperature、minTemperature、temperatureDescription の 3 つがあります。それぞれの [Instructions (指示)] は対応する description パラメーター、[Data Type (データ型)] は Apex のデータ型から取得されています。
3 つ目の出力である temperatureDescription では、[Show in conversation (会話に表示)] チェックボックスをオンにします。

[Finish (完了)] をクリックします。

アクションが完成しました。これで、Apex をアクションに追加する手順が理解できましたね。また、Apex のパラメーターがアクションの構築にどのように役立つかも、より深く理解できました。次は、Check Weather (天気を確認) エージェントアクションをトピックに追加してテストします。

トピックを更新する

歯車アイコンをクリックして、[Setup (設定)] を選択します。
[Setup (設定)] の [Quick Find (クイック検索)] ボックスで [Agentforce Agents (Agentforce エージェント)] を検索して選択します。
[Einstein Copilot] または [Agentforce] (デフォルト) を選択します。
[Open in Builder (ビルダーで開く)] をクリックします。
エージェントが無効であることを確認します。
[MigrationDefaultTopic] を選択します。
[This Topic’s Actions (このトピックのアクション)] をクリックします。
[New (新規)] をクリックし、[Add from Asset Library (アセットライブラリから追加)] を選択します。
[Check Weather (天気を確認)] アクションのチェックボックスをオンにして、[Finish (完了)] をクリックします。
ブラウザーウィンドウを更新し、[MigrationDefaultTopic] を再び選択します。
[This Topic’s Actions (このトピックのアクション)] をクリックし、Check Weather (天気を確認) アクションがリストに残っていることを確認します。残っていない場合は、ステップ 8 ～ 11 を繰り返します。練習環境では、最初に保存したときにアクションがトピックに関連付けられないことがあります。
[Activate (有効化)] をクリックします。