Você está aqui:
Prepare sua ação do Apex para Criador móvel
Para que uma ação invocável do Apex possa ser configurada no Criador móvel para Agentforce, a ação deve atender a estes requisitos.
| Requisito | Por quê |
|---|---|
| O método invocável retorna uma Lista<> de uma classe do Apex. | O criador renderiza as respostas como um carrossel, que requer uma lista. Para respostas de um único item, retorne uma lista com um elemento. |
| Todos os campos de saída usam tipos simples: String, inteiro, booleano, decimal. | Não há suporte para objetos aninhados e tipos complexos no Beta. |
| A saída é simples, sem objetos aninhados ou listas em listas. | O criador expõe apenas campos de nível superior como selecionáveis no painel de propriedades. |
| O sinalizador Mostrar na conversa é selecionado na variável de saída @InvocableVariable. | Sem esse sinalizador, a ação é exibida no criador, mas não pode ser salva corretamente. |
| O tipo de saída é uma classe do Apex, não um SObject genérico. | O criador lê nomes de campo e tipos da classe do Apex. |
Exemplo de uma ação compatível do 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;
}
}Depois de implementar a classe do Apex, crie um agente, um tópico e uma ação do Agentforce que apontem para o método invocável. Em seguida, volte ao Criador móvel para que o Agentforce configure seu layout móvel.
