変数と検索条件をサブエージェントとアクションに追加する

メモ

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

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

Einstein と Agentforce を有効化する

Linda が Cloud Kicks のユーザー認証を設定する最初のステップは、Einstein と Agentforce の両方が有効になっていることを確認することです。以下の手順を実行します。

1. をクリックして、[Setup (設定)] を選択します。[Setup (設定)] ページが新しいタブで開きます。
   
2. [Quick Find (クイック検索)] ボックスで [Einstein Setup (Einstein 設定)] を検索して選択します。
   
3. [Turn on Einstein (Einstein を有効化)] 切り替えが [On (オン)] に設定されていることを確認します。
   
4. ブラウザーを更新して、[Setup (設定)] を再度読み込みます。
   
5. [Setup (設定)] の [Quick Find (クイック検索)] ボックスで [Salesforce Go] を検索して選択します。
   
6. [Setup (設定)] の [Search features... (特徴を検索...)] テキストボックスで [Agentforce] を検索して選択します。
   

7. [使用開始] をクリックします。
   
8. [Turn On (有効化)] をクリックします。
   
9. [Confirm (確認)] をクリックします。
   

フローを有効化する

次に、Linda は事前作成されたいくつかのフローを組織で有効化します。認証アクションが適切に機能するために有効化する必要があります。その方法は、次のとおりです。

1. [Setup (設定)] の [Quick Find (クイック検索)] ボックスで [Flows (フロー)] を検索して選択します。
   
2. 列ヘッダー [Last Modified (最終更新日)] (最後の列) をクリックして、最後に変更されたフローが一番上に表示されるように並べ替えます。
   
3. [Get Orders by Contact (取引先責任者別の注文を取得)] フローを選択して新しいタブで開きます。
   
4. [Activate (有効化)] をクリックします。
   
5. この Web ブラウザータブを閉じます。前の設定タブが開いたままになっていることを確認します。
   
6. [Get Contact (取引先責任者を取得)] フローを選択して新しいタブで開きます。
   
7. [Activate (有効化)] をクリックします。
   
8. この Web ブラウザータブを閉じます。前の設定タブが開いたままになっていることを確認します。
   

サブエージェントとアクションを変更する

[Customer Verification (顧客検証)] サブエージェントは、機密データへのアクセス権を付与する前に顧客の ID を検証する標準サブエージェントです。このサブエージェントには 2 つのアクションが含まれます。

まず、[Send Email with Verification Code (検証コードを含むメールを送信)] アクションの出力を [Verify Customer (顧客を検証)] アクションの入力に対応付けます。これは、両方のアクションの質問 (入力) と回答 (出力) を関連付ける方法だと考えてください。

変数を作成する

最初に 4 つの変数を作成する必要があります。これらの変数は、アクションの入力と出力に追加します。

1. [Setup (設定)] で、[Agentforce Agents (Agentforce エージェント)] を検索して選択します。
   
2. エージェントのリストから、[Cloud Kicks Service Agent (Cloud Kicks サービスエージェント)] をクリックします。
   
3. [Open in Builder (ビルダーで開く)] をクリックします。
   
4. サイドバーから、[Context (コンテキスト)] アイコンを選択します。
   

5. [New Variable (新規変数)] をクリックします。
   

• Name (名前): Authentication Key (認証キー)
• API Name (API 参照名): Authentication_Key
• Description (説明): This variable stores the authentication key that generates the verification code. (この変数には、検証コードを生成する認証キーが保存されます。)
• Data Type (データ型): Text (テキスト)
  
• Allow value to be set by API (API による値の設定を許可): オフのまま
  
• Allow LLM to use value (LLM による値の使用を許可): オフのまま
  
• 次の [Assign or Map This Variable (この変数を割り当てまたは対応付け)] 入力: [Customer Verification (顧客検証)] > [Send Email with Verification Code (検証コードを記載したメールを送信)] > [Authentication Key (認証キー)]
  

6. [Save (保存)] をクリックします。
   
7. [New Variable (新規変数)] をクリックします。
   

• Name (名前): Customer ID (顧客 ID)
• API Name (API 参照名): Customer_ID
• Description (説明): This variable stores the user ID or contact ID. (この変数には、ユーザー ID または取引先責任者 ID が保存されます。)
• Data Type (データ型): Text (テキスト)
  
• Allow value to be set by API (API による値の設定を許可): オフのまま
  
• Allow LLM to use value (LLM による値の使用を許可): オフのまま
  
• 次の [Assign or Map This Variable (この変数を割り当てまたは対応付け)] 入力: [Customer Verification (顧客検証)] > [Send Email with Verification Code (検証コードを記載したメールを送信)] > [Customer ID (顧客 ID)]
  

8. [Save (保存)] をクリックします。
   
9. [New Variable (新規変数)] をクリックします。
   

• Name (名前): Customer Type (顧客種別)
• API Name (API 参照名): Customer_Type
• Description (説明): This variable stores the customer ID type (user or contact). (この変数には、顧客 ID 種別 (ユーザーまたは取引先責任者) が保存されます。)
• Data Type (データ型): Text (テキスト)
  
• Allow value to be set by API (API による値の設定を許可): オフのまま
  
• Allow LLM to use value (LLM による値の使用を許可): オフのまま
  
• 次の [Assign or Map This Variable (この変数を割り当てまたは対応付け)] 入力: [Customer Verification (顧客検証)] > [Send Email with Verification Code (検証コードを記載したメールを送信)] > [Customer Type (顧客種別)]
  

10. [Save (保存)] をクリックします。
    
11. [New Variable (新規変数)] をクリックします。
    

• Name (名前): Verified Contact record ID (検証済み取引先責任者レコード ID)
• API Name (API 参照名): Verified_Contact_record_ID
• Description (説明): This variable stores a boolean value that indicates if the customer is verified. (この変数には、顧客が検証済みであるかを示す Boolean 値が保存されます。)
• Data Type (データ型): Boolean
  
• Allow value to be set by API (API による値の設定を許可): オフのまま
  
• Allow LLM to use value (LLM による値の使用を許可): オフのまま
  
• 次の [Assign or Map This Variable (この変数を割り当てまたは対応付け)] 入力: [Customer Verification (顧客検証)] > [Verify Customer (顧客を検証)] > [Verified (検証済み)]
  

12. [Save (保存)] をクリックします。
    

[Verify Customer (顧客を検証)] 入力を調整する

1. [Subagents (サブエージェント)] アイコンをクリックします。
   
2. [Subagents (サブエージェント)] セクションで、[Customer Verification (顧客検証)] をクリックします。
   
3. [This Subagent’s Actions (このサブエージェントのアクション)] タブをクリックします。
   
4. [Verify Customer (顧客を検証)] アクションをクリックします。
   

5. [1 Authentication Key Instructions (1 認証キー指示)] 入力 (青色) ボックスまでスクロールダウンし、[Assign to Variable (変数に割り当て)] 入力をクリックします。
   
6. [Authentication Key (認証キー)] 変数を選択します。
   
7. [3 Customer ID Instructions (3 顧客 ID 指示)] 入力 (青色) ボックスまでスクロールダウンし、[Assign to Variable (変数に割り当て)] 入力をクリックします。
   
8. [Customer ID (顧客 ID)] 変数を選択します。
   
9. [4 Customer Type Instructions (4 顧客種別指示)] 入力 (青色) ボックスまでスクロールダウンし、[Assign to Variable (変数に割り当て)] 入力をクリックします。
   
10. [Customer Type (顧客種別)] 変数を選択します。
    

[Verify Customer (顧客を検証)] アクションと変数を対応付ける

次のステップでは、[Verify Customer (顧客を検証)] アクションの [Customer ID (顧客 ID)] 出力を変数に対応付けます。これにより、検証状況が顧客に接続されます。その後、顧客のためにエージェントに実行して欲しいアクションの検索条件でこの変数を使用できます。

1. [Verify Customer (顧客を検証)] アクションが開いたままの状態で、[2 Customer Id Instructions (2 顧客 ID 指示)] 出力 (緑色) ボックスまでスクロールダウンし、[Map to Variable (変数に対応付け)] 入力をクリックします。
   
2. [VerifiedCustomerId] 変数を選択します。
   

[Get Cases for Verified Contact (検証済み取引先責任者のケースを取得)] を変数に対応付ける

次に、[Case Management (ケース管理)] サブエージェントに [Customer ID (顧客 ID)] 変数を追加します。これにより、エージェントが確認済みのコンタクトに関連付けられているすべてのケースにアクセスできるようになります。

1. [<— View Action (アクションを表示)] をクリックし、[<— Subagent Details (サブエージェントの詳細)] をクリックしてサブエージェントのリストに戻ります。
   
2. サブエージェントのリストの [Case Management (ケース管理)] をクリックします。
   
3. [This Subagent’s Actions (このサブエージェントのアクション)] タブをクリックします。
   
4. [Get Cases for Verified Contact (確認済みコンタクトのケースを取得)] アクションをクリックします。
   
5. [1 Verified Contact record ID (1 検証済み取引先責任者レコード ID)] 入力 (青色) ボックスまでスクロールダウンし、[Assign a Variable (変数を割り当て)] 入力をクリックします。
   
6. [Verified Customer ID (検証済み顧客 ID)] 変数を選択します。
   

検索条件を作成する

ここからが楽しいところです。顧客が検証された場合にのみエージェントが非公開アクションを含むサブエージェントにアクセスできるように、「Is Verified」(検証済み) 変数を使用する検索条件を作成できるようになりました。Cloud Kicks は [Case Management (ケース管理)] サブエージェントで検証を必要としたいため、そこに検索条件を追加する必要があります。

1. サイドバーから、[Context (コンテキスト)] アイコンを選択します。必要に応じて、変数のリストに戻るには [<- Variable (変数)] をクリックします。
   
2. コンテキストパネルで [Filters (検索条件)] タブをクリックします。
   
3. [New (新規)] をクリックして、次の詳細を入力します。
   

• Name (名前): Is Verified (検証済み)
• [API Name (API 参照名)] が Is_Verified になっていることを確認します。
• [All Conditions Are Met (AND) (すべての条件に一致 (AND))] を選択します。
  
• Resource (リソース): Verified Contact record ID (検証済み取引先責任者レコード ID)
  
• Operator (演算子): Equal (等号)
  
• Value (値): True
  

4. [Save (保存)] をクリックします。
   
5. [Subagents (サブエージェント)] アイコンをクリックします。
   
6. [<— View Action (アクションを表示)] をクリックし、[<— Subagent Details (サブエージェントの詳細)] をクリックしてサブエージェントのリストに戻ります。
   
7. サブエージェントのリストの [Case Management (ケース管理)] をクリックします。
   
8. 検索条件アイコンをクリックします。
   

9. [Assign Filters (検索条件を割り当て)] 入力ボックスをクリックし、[Is Verified (検証済み)] を選択します。
   
10. [Save (保存)] をクリックします。
    

フローの有効化、変数の作成、検索条件の適用が終わったところで、次はすべてをまとめ、エージェント認証を実際に確認してみましょう。

リソース

• Salesforce ヘルプ: Create a Custom Variable for Your Agent (エージェントのカスタム変数の作成)
• Salesforce ヘルプ: Einstein Copilot アクション手順のベストプラクティス