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

学習の目的

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

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

メモ

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

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

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

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

1. アプリケーションランチャー で、[Agentforce Studio (Agentforce スタジオ)] を検索して選択します。
   
2. [Agent Customization (エージェントのカスタマイズ)] をクリックします。
   
3. [New Version (新規バージョン)] をクリックします。
   
4. [Subagents (サブエージェント)] で [Answer Weather Questions (天気の質問に回答)] を選択します。
   
5. [Actions Available For Reasoning (推論に使用可能なアクション)] で、[Select action (アクションを選択)] をクリックし、[Create a custom action (カスタムアクションを作成)] を選択します。
   
6. [Action Name (アクション名)] に Check Weather (天気を確認) と入力します。
   
7. [Description (説明)] に This action will return the local weather information. (このアクションを実行すると、現地の天気予報が返されます。) と入力します。
8. [Reference Action Type (参照アクション種別)] で [Apex] を選択します。
   
9. [Reference Action Category (参照アクションカテゴリ)] で [Invocable Method (呼び出し可能なメソッド呼び出し可能なメソッド)] を選択します。
   
10. [Reference Action (参照アクション)] で [Check Weather (天気を確認)] を選択します。
    
11. [Create and Open (作成して開く)] をクリックします。
    

[Inputs (入力)] セクションの [dateToCheck] には、Apex の呼び出し可能な変数の description パラメーターから取得された説明が事前入力されます。必要に応じて指示を編集または追加できます。

12. [Require Input to execute action (アクションを実行するために入力を必須にする)] チェックボックスがデフォルトでオンになっていることを確認します。この操作は、required パラメーターが true に設定されているコードで実行されます。
    
    

出力には、Apex の呼び出し可能な変数から取得された maxTemperature、minTemperature、temperatureDescription の 3 つがあります。それぞれの [Instructions (指示)] は対応する description パラメーター、[Data Type (データ型)] は Apex のデータ型から取得されています。

13. 3 つ目の出力である temperatureDescription では、[Show in conversation (会話に表示)] チェックボックスをオンにします。
    
    

14. [保存] をクリックします。
    
15. [Commit Version (バージョンを確定)] をクリックします。
    
16. [Commit Version (バージョンを確定)] をもう一度クリックします。
    
17. [Activate (有効化)] をクリックします。
    
18. [Activate (有効化)] をもう一度クリックします。
    

できました! アクションが完成しました。これで、Apex をアクションに追加する手順が理解できましたね。また、Apex のパラメーターがアクションの構築にどのように役立つかも、より深く理解できました。次は、このアクションをテストします。

天気を確認しよう

Agentforce Builder では、このツールで直接エージェントを操作してプレビューできます。

1. Agentforce Builder で [Preview (プレビュー)] をクリックします。
   
2. [Live Test Mode (ライブテストモード)] になっているはずです。
   
3. [Describe your task or ask a question (タスクについて説明するか、質問する)] ボックスに What’s the weather like this Monday? (この月曜日の天気はどんな感じですか?) と入力して、Enter キーを押します。エージェントが正確な日付を尋ね、日付を選択するオプションを表示する場合があります。次の月曜日の日付を選択して送信します。
   
4. 
   
   

エージェントが実行したステップを見ると、要求を処理するために Check Weather (天気を確認) アクションが選択されていることがわかります。

お疲れさまでした。すでに組織で利用できる Apex 機能を AI エージェントで活用するための大きな一歩を踏み出すことができました。また、エージェントを最大限に活用するためのベストプラクティスや、パラメーターの設定方法についても学びました。

リソース

• Salesforce ヘルプ: エージェントアクションの手順のベストプラクティス
• YouTube: Best Practices for Building Agentforce Apex Actions | TDX 2025: Developer Highlights (Agentforce Apex アクション構築のベストプラクティス | TDX 2025: 開発者向けハイライト)
• Salesforce 開発者ブログ: Build Advanced Custom Agent Actions with Code (高度なカスタムエージェントアクションをコードで構築)