Você está aqui:
Considerações sobre o Criador móvel para Agentforce (beta)
Lembre-se destas limitações e problemas conhecidos ao usar esse recurso.
Requisitos de ação do Apex
| Limitação | Impacto | Recomendação |
|---|---|---|
| Campos aninhados ou de saída do tipo objeto não são suportados. | O criador mostra o nome do campo como selecionável, mas os dispositivos móveis não mostram nada para esse campo. | Use apenas tipos de campo simples na saída do Apex (String, Integer,
Boolean, Decimal). Mantenha a saída plana, sem objetos aninhados. |
| Há suporte apenas para ações invocáveis do Apex que retornam uma lista. | Ações do Apex que retornam um único objeto plano (não encapsulado em uma lista) não podem ser configuradas no criador. | Estruture todas as ações do Apex para retornar uma lista, mesmo quando apenas um item for esperado. |
| A configuração Mostrar na conversa é ignorada. | Se você não selecionar Mostrar na conversa na variável de saída, a ação será exibida no criador, mas não poderá ser salva corretamente. | Sempre selecione Mostrar na conversa na variável de saída do Apex. |
Exibir
| Limitação | Impacto | Solução alternativa/Orientação |
|---|---|---|
| Um erro vermelho pode aparecer ao adicionar um ativo de imagem externo. | Se sua organização não tiver um gerente de ativo digital de terceiros configurado, o seletor de imagem mostrará um erro enganoso, embora a imagem tenha sido adicionada com sucesso. | Ignorar o erro. A imagem é adicionada à sua personalização com êxito. |
Outras considerações
- Implantar uma classe do Apex com
@InvocableMethodnão é suficiente sozinha. Após a implantação da classe do Apex, registre-a como uma Ação do Agentforce do tipo Apex:- Em Configuração, insira Ativos do Agentforce na caixa Busca rápida e selecione-a.
- Clique na guia Ações e em Nova ação do agente.
- No modal, defina Tipo de ação de referência como
Apex. - Defina Categoria da ação de referência como
Invocable Methods. - Defina Ação de referência para sua classe do Apex.
- Clique em Avançar e conclua a configuração.
O SDK Agentforce responde com Ações do Agentforce, que podem ser de diferentes tipos (por exemplo, Apex ou Fluxo), de modo que uma classe do Apex não registrada não será exibida pelo agente ou aparecerá como uma ação selecionável no Criador móvel para Agentforce.
- URLs de imagem que usam autenticação não são exibidos para usuários convidados. Certifique-se de que os URLs de imagem estejam acessíveis ao público. Adicione imagens do CMS em um canal público. Para links de imagem externos, adicione o domínio a URLs confiáveis em Configuração.
- Apenas uma personalização móvel é permitida por ação do Agentforce e é aplicada a todos os usuários que acessam o aplicativo Salesforce móvel e aplicativos externos usando o SDK do Agentforce móvel. Para fazer alterações, edite a personalização existente.
- Uma pré-visualização no criador não está disponível no beta. Publique sua personalização e teste em um dispositivo móvel para verificar o layout.
- Somente campos de nível superior da saída da ação do Apex aparecem como campos selecionáveis no criador. Mantenha a saída simples.
- Não há suporte para referências a campos de dados aninhados no beta.
- Personalizações móveis se aplicam apenas à forma como as respostas de ação do Agentforce são exibidas. A entrada do usuário não é personalizável.
