エージェント要素の作成
Agentforce エージェントを使用して、フローで ToDo を動的に処理します。既存のエージェントを選択するか、カスタム手順とアクションを使用してエージェントを作成します。
必要なエディション
権限
フローで既存のエージェントを使用するには、「設定を参照」ユーザー権限が必要です。Flow Builder からエージェントを作成するには、「アプリケーションのカスタマイズ」、「Einstein Copilot Builder」、「Einstein Agent Platform Builder」、または「Self-Service Copilot Builder」ユーザー権限が必要です。システム管理者プロファイルを持つユーザーは、エージェントの作成と使用の両方ができます。
エージェントを作成する権限がない場合、エージェント選択パネルに [エージェントを作成] ボタンは表示されません。選択できるのは既存のエージェントのみです。
利用状況
[エージェントを作成] 要素をフローに追加します。［Agent］ フィールドで、有効なエージェントを検索して選択するか、［Create Agent］ をクリックして新しいエージェントを作成します。
既存のエージェントの選択
既存のエージェントを使用するには、[エージェント] 項目でエージェントを名前で検索します。有効なエージェントのみがリストに表示されます。エージェントを選択したら、プロパティパネルでエージェントの入力と出力を設定します。
新しいエージェントの作成
エージェントを作成するには、[Create Agent] をクリックします。[新規エージェント] ウィンドウで、エージェントの基本情報を設定します。
| 項目 | 説明 |
|---|---|
| 表示ラベル | エージェントの名前。 |
| API 参照名 | 一意性の要件は、現在のフロー内の要素のみに適用されます。異なるフローで使用されている場合、同じ API 参照名を持つ 2 つの要素を使用できます。API 参照名には、アンダースコアとスペースを含まない英数字を使用できます。文字で始まる必要があり、末尾をアンダースコアにすることはできません。アンダースコアを 2 つ続けて使用することもできません。 |
| 説明 | エージェントの動作の説明。 |
| ユーザーのアクセス権 | エージェントの実行ユーザーレコード。既存のユーザーを選択するか、システムでユーザーを作成します。 |
| 説明 | エージェントが実行する内容と理由を説明する手順。 |
| アクション | エージェントが使用できるアクション。アセットライブラリから既存のアクションを選択するか、カスタムアクションを作成します。 |
エージェントへのアクションの追加
エージェントが ToDo を実行するには、少なくとも 1 つのアクションが必要です。アクションは、[作成 & 有効化] をクリックする前、またはエージェントを有効化した後に Agentforce Builder で追加します。
既存のアクションを選択するには、[アクションを選択] をクリックします。アセットライブラリから 1 つ以上のアクションを検索して選択し、[エージェントに追加] をクリックします。使用可能なアクションには、Knowledge アクション、呼び出し可能なアクションとして設定されたフロー、標準アクションなどがあります。
アクションを作成するには、[Create Action (アクションを作成)] をクリックします。[アクションを作成] ウィンドウで、アクションを設定します。
| 項目 | 説明 |
|---|---|
| Agent Tool Label | アクションの名前。 |
| API 参照名 | 一意性の要件は、現在のフロー内の要素のみに適用されます。異なるフローで使用されている場合、同じ API 参照名を持つ 2 つの要素を使用できます。API 参照名には、アンダースコアとスペースを含まない英数字を使用できます。文字で始まる必要があり、末尾をアンダースコアにすることはできません。アンダースコアを 2 つ続けて使用することもできません。 |
| 説明 | アクションの名前。エージェントはこの情報を使用して、このアクションを使用する方法とタイミングを決定します。 |
| 参照アクション種別 | アクションのタイプ (フロー、Apex など)。 |
| 参照アクションカテゴリ | 参照アクション種別のサブ種別。すべてのアクションに参照アクションカテゴリがあるわけではありません。 |
| 参照アクション | 参照するアクションの名前。 |
入力ごとに、入力内容に関する説明を追加します。エージェントは、アクションをコールするときに説明を使用して入力の使用方法を決定します。[Require input to execute action (アクションの実行に入力が必要)] を選択して、入力を必須にします。
出力ごとに、出力の戻りとフローでの結果の使用方法に関する説明を追加します。エージェントの推論から出力を除外するには、[Filter from agent context] を選択します。エージェントの応答にこの出力を含めるには、[会話に表示] を選択します。
［Create & Activate］ をクリックして、エージェントを作成して有効化します。
要素の設定
エージェントを選択または作成したら、プロパティパネルで [エージェントを作成] 要素を設定します。
| 項目 | 説明 |
|---|---|
| 表示ラベル | キャンバスおよびツールボックスマネージャーのアクションの表示ラベル。 |
| API 参照名 | 一意性の要件は、現在のフロー内の要素のみに適用されます。異なるフローで使用されている場合、同じ API 参照名を持つ 2 つの要素を使用できます。API 参照名には、アンダースコアとスペースを含まない英数字を使用できます。文字で始まる必要があり、末尾をアンダースコアにすることはできません。アンダースコアを 2 つ続けて使用することもできません。 |
| 説明 | 要素の説明。 |
入力値の設定
プロパティパネルで [エージェントを作成] 要素の入力を設定します。
| 項目 | 説明 |
|---|---|
| エージェント要求 | このフロー実行のためにエージェントに送信する質問または要求。エージェントはこの特定の要求に指示を適用して出力を生成します。 |
| セッション ID | 省略可能。フローの前半で実行される [エージェントを作成] 要素から返されたセッション ID を使用します。エージェントは、その会話の完全な推論コンテキストとメモリを保持します。セッション ID を指定しない場合、エージェントは新しい会話を開始しますが、以前の [エージェントを作成] 要素からの出力を入力としていつでも指定できます。 |
構造化出力の設定
フローで使用できる構造化データを返すようにエージェントを設定するには、構造化出力項目を定義します。各項目は、エージェントが抽出または生成する情報を表します。
構造化出力を設定すると、エージェントは [構造化されたエージェント応答] 項目で構造化データのみを返します。Agent Response フィールドは null を返します。構造化出力を設定していない場合、エージェントは [エージェント応答] 項目に非構造化テキストのみを返します。
構造化出力を設定するには、[設定] をクリックします。構造化された各出力項目の項目を設定します。
| 項目 | 説明 |
|---|---|
| 項目名 | 必須。構造化出力項目の一意の英数字名。名前に特殊文字やスペースを含めることはできません。 |
| 説明 | 大規模言語モデル (LLM) の精度を高めるために項目名で使用する簡単な説明。 |
| データ型 | 必須。項目のデータ型。有効な値: String、Number、Boolean。 |
| 必須 | LLM がこの出力項目の応答を生成する必要があることを示します。出力行を要求すると、LLM によって不正確または有害な応答が返される可能性があります。 |
出力値の保存
| 項目 | 説明 |
|---|---|
| エージェント応答 | エージェントからの構造化されていない応答。構造化出力が設定されている場合は、null を返します。 |
| セッション ID | エージェント応答がある会話セッションの ID。 |
| 構造化されたエージェント応答 | エージェントからの構造化された出力。構造化された出力が設定されていない場合は、null を返します。 |
構造化された出力の利用状況
構造化出力を設定する前に、[エージェントを作成] 要素の表示ラベルと API 参照名を入力し、フローを保存します。
構造化出力を設定する場合、保存する前に少なくとも 1 つの構造化出力項目を定義します。
定義された構造化出力項目ごとに、定義された名前を持つ項目と関連する Boolean _set 項目の 2 つの項目が作成されます。たとえば、「summary」という名前の構造化出力フィールドを定義した場合、「summary_set」という名前の Boolean フィールドも作成されます。
| 項目 | 説明 |
|---|---|
| True | この項目は構造化されたエージェント応答に含まれていましたが、設定されていませんでした。 |
| False | この項目は構造化されたエージェント応答に含まれていません。 |
定義された構造化出力でnullが返される場合、フローの後半で関連する _set 項目を使用して、その項目がnullである理由を判断します。
使用上の注意
- 有効化する前にフローをテストし、[エージェントを作成] 要素が期待どおりに機能することを確認します。
- Flow Builder で作成されたエージェントは、いつでも Agentforce Builder で検索および編集できます。
- API バージョン 67.0 以降、AI エージェントアクションはアクション要素から使用できなくなりました。[エージェントを作成] 要素を使用してエージェントを操作します。AI エージェントアクションを参照するアクション要素を含むフローを開くと、自動的に [エージェントを作成] 要素として表示されます。元の設定が保持されます。
