Confirmações de ação
Como as confirmações variam por canal
A forma como uma ferramenta de ação é confirmada e executada depende do canal em que o agente é executado. O agente sempre decide qual ação tomar da mesma forma em todos os canais; o que muda é se um humano precisa clicar em um cartão primeiro.
| Canal | Comportamento |
|---|---|
| Interno (UI do Salesforce) | Exibe um cartão de confirmação; a ação só é executada depois que o usuário clica em Confirmar. Essa é a experiência descrita ao longo deste artigo. |
| Widget Externo e Comunidade | Executa a ação automaticamente (sem cartão) e, em seguida, o agente faz um turno de acompanhamento automático e relata o resultado real — por exemplo, “Criei o Caso #00001234.” Se a ação falhar, ele informa isso com honestidade em vez de sugerir sucesso. O número de turnos de acompanhamento automáticos que o agente pode fazer em sequência é limitado por uma configuração da plataforma para evitar loops descontrolados. |
| API / Fluxo | Com autoExecuteActions=true, a ação é executada silenciosamente — sem cartão, sem narração; o Fluxo que chamou o agente trata o resultado. |
O que é uma confirmação de ação?
Uma Confirmação de Ação é um cartão de interface que aparece antes de a IA executar qualquer ferramenta da categoria Ação (ferramentas que modificam ou criam dados no Salesforce). O cartão de confirmação mostra:
- Tipo de Ação — Qual operação será realizada (por exemplo, "Criar Tarefa", "Enviar E-mail", "Atualizar Registro")
- Detalhes principais — Os principais valores de campo que serão criados ou alterados
- Botões de confirmação — "Confirmar" (prosseguir) ou "Cancelar" (abortar)
Esse mecanismo de segurança impede que os usuários façam a IA criar registros, enviar e-mails ou modificar dados acidentalmente, sem aprovação explícita.
Quando as confirmações são exigidas
Os cartões de confirmação aparecem para ferramentas da categoria Ação:
| Ferramenta | Confirmação? | O que é exibido |
|---|---|---|
| create_record | Sim | Tipo de objeto, campos principais (Nome, Etapa, Valor, etc.) |
| update_record | Sim | Nome/ID do registro, quais campos serão alterados e os novos valores |
| delete_record | Sim | Nome/ID do registro, confirmação de que será excluído |
| send_email | Sim | Destinatários, assunto, prévia do corpo do e-mail |
| create_task | Sim | Assunto, data de vencimento, prioridade, responsável |
| create_event | Sim | Título do evento, horário de início/término, participantes, local |
| send_custom_notification | Sim | Título da notificação, corpo e destinatários |
| link_file_to_record | Não | N/D — anexa um arquivo existente a um registro sem cartão |
| continue_workflow | Não | N/D — solicita mais um turno autônomo (somente canal API); por si só não altera dados |
| schedule_action | Não (exceção) | N/D — executa silenciosamente |
Ferramentas somente leitura (soql_query, get_record, describe_object) nunca exigem confirmação, pois não modificam dados.
A experiência do usuário com o cartão de confirmação
Veja o que o usuário vê e vivencia:
-
O usuário solicita uma ação
O usuário digita: "Crie uma tarefa para eu fazer o acompanhamento com o João Silva na próxima terça-feira, prioridade alta."
-
A IA decide chamar a ferramenta
A IA determina que create_task é a ferramenta certa para essa solicitação.
-
O cartão de confirmação aparece
Em vez de criar a tarefa imediatamente, um cartão de confirmação é exibido na janela do chat mostrando:
- Ação: "Criar Tarefa"
- Assunto: "Acompanhamento: João Silva"
- Data de vencimento: [data da próxima terça-feira]
- Prioridade: "Alta"
- Botões: "Confirmar" e "Cancelar"
-
O usuário revisa e aprova
O usuário lê a confirmação, verifica os detalhes e clica em "Confirmar" se estiver correto.
-
A ação é executada
A REDA AI executa a ferramenta create_task e retorna uma mensagem de sucesso no chat.
-
Alternativa: o usuário cancela
Se o usuário perceber um erro, ele clica em "Cancelar". A tarefa não é criada, e a IA pode pedir ao usuário que esclareça ou tente novamente.
Design do cartão de confirmação
Os cartões de confirmação são renderizados na interface de chat da REDA AI e projetados para clareza:
- Rotulagem clara — seções "Tipo de Ação:" e "Detalhes:"
- Layout de fácil leitura — campos e valores são fáceis de identificar rapidamente
- Botões de confirmação em destaque — "Confirmar" (geralmente verde/positivo) e "Cancelar" (cinza/neutro)
- Sem confirmação automática — o usuário precisa clicar ativamente para confirmar; não há tempo limite nem aprovação automática
As ações personalizadas também mostram seus detalhes. Um cartão de confirmação criado para uma das suas próprias ferramentas de classe Apex agora lista os valores que o agente pretende usar, no mesmo layout de uma ação nativa, em vez de apenas nomear a ação. Isso importa porque uma confirmação que você não consegue ler não é uma decisão: aprovar “Criar ordem de serviço” sem ver qual imóvel, qual fornecedor e qual valor é apenas clicar em Confirmar. Nada mudou sobre quando uma confirmação é exigida; apenas o que o cartão mostra antes de você aprovar.
Exceção do schedule_action
Das três ferramentas que pulam o cartão, o schedule_action é o que merece explicação — é o que mais parece precisar de um. Ele é executado sem cartão porque:
- schedule_action agenda uma ação futura (não imediata)
- O usuário pode cancelar ou modificar a ação agendada posteriormente
- Ela não modifica imediatamente os dados de produção
Exemplo: "Agende o envio de um e-mail ao cliente amanhã às 10h" — o schedule_action é executado imediatamente (agendando o e-mail futuro), mas nenhuma confirmação é exigida porque a ação ainda não aconteceu.
Execução automatizada sem confirmação
Quando o agente é invocado a partir de um Fluxo do Salesforce com o parâmetro autoExecuteActions=true, as ferramentas de ação são executadas sem cartões de confirmação. Isso é útil para:
- Fluxos de trabalho automatizados — Fluxos que precisam criar registros sem interação do usuário
- Operações em lote — processamento de múltiplas solicitações sem aprovação manual
- Integrações de backend — uso do agente via API, onde não há confirmação possível pela interface
Quando autoExecuteActions=true, a IA presume que a solicitação já foi validada e executa as ações silenciosamente.
O que acontece se o usuário cancelar?
Se o usuário clicar em "Cancelar" em um cartão de confirmação:
- A ferramenta de ação NÃO é chamada
- Nenhum dado é criado, atualizado ou excluído
- A IA recebe um status de "cancelado"
- A IA informa ao usuário: "Ação cancelada. Gostaria que eu tentasse algo diferente?"
A conversa continua normalmente. O usuário pode pedir à IA para tentar novamente com parâmetros diferentes ou solicitar uma ação diferente.
Cenários comuns de confirmação
A confirmação mostra: Objeto "Oportunidade", Nome da Conta "Acme Corp", Etapa do Negócio "Qualificação", Valor "R$ 50.000", Data de Fechamento "31 de março de 2026".
A confirmação mostra: Destinatários "joao@exemplo.com, joana@exemplo.com", Assunto "Atualização do Projeto", prévia do corpo (primeiros 100 caracteres).
A confirmação mostra: Registro "Oportunidade: Negócio Acme", Alterações: "StageName: Proposta → Negociação/Revisão", "Probabilidade: 50% → 75%".
A confirmação mostra: Aviso "Excluir Caso #001234", com confirmação exigida porque a exclusão é destrutiva.
Boas práticas para confirmações
Explique aos usuários que os cartões de confirmação são pontos de verificação de segurança críticos. Treine-os para ler os detalhes com atenção antes de clicar em "Confirmar".
Instrua a IA de forma adequada — Ao pedir à IA para criar ou modificar dados, seja o mais específico possível. Exemplo: "Crie uma tarefa com o assunto 'Acompanhamento', data de vencimento amanhã, prioridade Alta" em vez de "Crie uma tarefa" (vago demais).
Monitore os cancelamentos — Se os usuários estiverem cancelando confirmações com frequência, a IA pode não estar interpretando corretamente as solicitações. Revise os prompts e as instruções de Schema para melhorar a precisão.
Solução de problemas de confirmação
Se uma ferramenta de ação for chamada, mas nenhuma confirmação aparecer, verifique se a ferramenta é realmente da categoria Ação (e não da categoria Ferramenta). Confirme se a configuração do agente está correta.
Os detalhes da confirmação estão incompletos ou incorretos — a IA pode não estar interpretando corretamente as solicitações do usuário. Use Prompts personalizados para fornecer instruções de ação mais claras. Exemplo: "Ao criar uma tarefa, sempre inclua o assunto, a data de vencimento e a prioridade."
Usuários cancelando com muita frequência — a IA pode estar sugerindo valores de campo incorretos. Adicione prompts de Schema para fornecer contexto sobre os valores de lista de seleção dos campos, ou refine os Prompts personalizados para orientar melhor a IA.
Ações de e-mail, registros e agendamento
Ações de e-mail distinguem o destinatário Contato ou Lead do registro de negócio relacionado, aceitam listas Para/Cc e verificam os casos compatíveis de recusa de e-mail. Contatos/Leads fornecidos como registros relacionados são tratados como destinatários. Confirmações de registros mostram campos não aplicados. As etapas do plano são conciliadas individualmente e horários relativos preservam UTC. Agentes desativados e ações aninhadas não permitidas são verificados antes de executar confirmações. Vínculos de arquivos usam a rota com controle de acesso. Novas ações pendentes ou reagendadas por horário exigem processador disponível; rastreamento de respostas e atualizações normais de histórico/status continuam válidos. Jobs posteriores usam seu proprietário de agendamento, sem personificar o solicitante. Orientações reduzem duplicação por outro conector, mas não garantem o comportamento do assistente.
Perguntas frequentes
Não globalmente. Os cartões de confirmação são um recurso de segurança integrado das ferramentas de ação. No entanto, é possível desativar a confirmação de forma programática ao usar o agente em Fluxos com autoExecuteActions=true. No chat interativo, as confirmações são sempre exibidas.
A ação é executada. No entanto, se o usuário perceber o erro imediatamente, muitas vezes é possível desfazê-la (dependendo da ação). Por exemplo, se um registro foi criado por engano, ele pode ser excluído imediatamente. Para e-mails enviados, desfazer nem sempre é possível.
Três: schedule_action, link_file_to_record e continue_workflow têm o Requires Confirmation desligado. Todas as outras ferramentas de ação - create_record, update_record, delete_record, create_task, create_event, send_email e send_custom_notification - exigem.
Não há limite de tempo. O cartão de confirmação permanece na tela até que o usuário clique em "Confirmar" ou "Cancelar". O usuário pode levar o tempo que precisar para revisar os detalhes.
Próximos passos
Explore os campos de contexto para fornecer mais contexto de dados ao seu agente, ou saiba mais sobre acesso a dados e permissões para entender os controles de segurança.