詳細情報:
モバイルビルダーでの Apex アクションの準備
Agentforce のモバイルビルダーで Apex 呼び出し可能アクションを設定できるようにするには、アクションが次の要件を満たす必要があります。
| 要件 | 理由 |
|---|---|
| 呼び出し可能なメソッドは、Apex クラスのリスト<> を返します。 | ビルダーでは、応答がカルーセルとして表示されます。カルーセルにはリストが必要です。単一項目の回答の場合、1 つの要素を含むリストを返します。 |
| すべての出力項目では、単純な型 (String、Integer、Boolean、Decimal) が使用されます。 | ネストされたオブジェクトと複合型はベータではサポートされません。 |
| 出力はフラットで、リスト内にネストされたオブジェクトやリストはありません。 | ビルダーでは、プロパティペインで選択可能な最上位項目のみが表示されます。 |
| @InvocableVariable 出力変数で [会話に表示] フラグが選択されている。 | このフラグがないと、アクションはビルダーに表示されますが、正しく保存できません。 |
| 出力タイプは、汎用 SObject ではなく Apex クラスです。 | ビルダーは、Apex クラスから項目名と型を読み取ります。 |
互換性のある Apex アクションの例:
public class FetchRecipes {
@InvocableMethod(label='Fetch Recipes' description='Returns a list of recipes')
public static List<RecipeOutput> execute(List<RecipeInput> inputs) {
// Implementation
}
public class RecipeOutput {
@InvocableVariable(label='Recipe Title')
public String recipe_title;
@InvocableVariable(label='Cook Time')
public Integer cook_time;
@InvocableVariable(label='Image URL')
public String image_url;
}
}Apex クラスをリリースしたら、呼び出し可能なメソッドを参照する Agentforce エージェント、トピック、およびアクションを作成します。次に、Agentforce のモバイルビルダーに戻り、モバイルレイアウトを設定します。

