Montando a automação com o AgentMaker

O AgentMaker transforma uma descrição em linguagem comum em uma proposta de fluxo. Ele lê o grafo da automação, o catálogo de passos, as execuções recentes e referências da organização, monta o grafo inteiro e o valida antes de mostrar a proposta.

Ele vive na doca do AgentMaker, na borda direita da tela, e acompanha você entre as telas. O resultado depende de onde você está:

• com o editor daquela automação aberto, a proposta vira uma Revisão do rascunho: aplicar muda só o canvas, e a decisão de salvar continua sua;
• em qualquer outra tela, a proposta vira uma Proposta para você confirmar, e Confirmar salva uma versão nova que entra no ar imediatamente.

Onde abrir e quem pode usar

No editor da automação, selecione AgentMaker na barra superior (dica: “Criar a automação conversando com o AgentMaker”). O botão só aparece enquanto a doca está fechada; com ela aberta, use a própria doca. Fora do editor, abra a doca pela aba AgentMaker na borda direita.

Aberta, a doca empurra a página para o lado em vez de cobri-la, e pode ser ampliada ou reduzida. No celular, ocupa a tela inteira.

Usar o AgentMaker exige permissão para editar agentes (agents.write), e alterar uma automação exige automations.write; sem as duas, o botão do editor não aparece. Essa permissão não concede, sozinha, a criação de etiquetas ou listas; veja Quando falta uma etiqueta ou uma lista.

Escreva um pedido verificável

Informe o evento, os filtros, o tempo, o efeito e os recursos que devem ser usados. Por exemplo:

Quando uma conversa entrar na caixa Suporte, aguarde 1 hora. Se ninguém tiver respondido, transfira para o agente Triagem.

Se faltar uma decisão que altere o resultado — a caixa, o prazo, a mensagem ou o critério de um ramo —, o AgentMaker deve perguntar uma coisa por vez em vez de inventar. Use os nomes visíveis no SquadOS e diga explicitamente quando quer preservar uma parte do fluxo atual.

Antes de exibir qualquer proposta, o backend passa o grafo pelo mesmo validador usado no salvamento. O AgentMaker pode corrigir uma resposta inválida e tentar de novo, até três tentativas de validação no mesmo pedido, com no máximo 40 passos por fluxo. Se não conseguir, ele deve explicar que não montou o fluxo; a ausência de cartão não é uma mudança aplicada.

Com o editor aberto: Revisão do rascunho

1. Com o editor da automação aberto, faça o pedido na doca. O cartão Revisão do rascunho mostra os passos adicionados, removidos e alterados e as ligações criadas ou removidas.
2. Revise tudo e selecione Aplicar ao rascunho. O grafo passa para o canvas como alteração não salva. O estado muda para “Aplicado ao rascunho — revise e clique em Salvar quando estiver certo.”
3. Se não gostar do resultado, Desfazer aplicação devolve o rascunho anterior, desde que você não tenha mexido nele depois. Descartar abandona a revisão sem aplicar.
4. Revise o canvas e todos os campos marcados como obrigatórios ou inválidos. A validação da proposta não substitui essa inspeção; confirme também, no painel de cada passo, recursos como caixa, agente, etiqueta e modelo.
5. Use Salvar somente quando o rascunho estiver correto. Nesse caminho, o AgentMaker não salva, não liga nem desliga a automação.

Se você editar o canvas depois que a revisão apareceu, ela não sobrescreve sua edição: o cartão mostra “O rascunho mudou. Mantive sua edição e a proposta para você revisar ou recalcular.” Use Recalcular para refazer a revisão sobre o rascunho atual. Uma revisão substituída por outra mais nova deixa de poder ser aplicada.

Se a conversa estiver aberta em mais de uma aba, só uma delas pode aplicar ou descartar a revisão; as outras mostram o estado.

Fora do editor: Proposta para você confirmar

Quando você pede uma mudança numa automação sem estar no editor dela, o cartão Proposta para você confirmar oferece:

• Confirmar — salva o grafo proposto como uma versão nova. Se a automação estiver ligada, essa versão passa a valer imediatamente para as próximas execuções;
• Revisar na tela — abre a proposta no editor para você revisar e salvar por conta própria;
• Descartar — abandona a proposta.

Se a automação mudou desde que a proposta foi exibida, Confirmar é recusado com “A proposta mudou desde que foi exibida. Peça ao AgentMaker para refazer.” Prefira Revisar na tela em automações ativas que falam com clientes: a versão confirmada entra no ar sem passar pelo canvas.

Quando falta uma etiqueta ou uma lista

O AgentMaker pode criar etiquetas de contato e listas de contatos que o fluxo precisa. Essas criações acontecem na hora, sem cartão de confirmação, e ele informa o que criou.

• Etiqueta exige permissão para editar contatos (contacts.write).
• Lista exige permissão para editar e-mails (emails.write).

O AgentMaker consulta no máximo 300 etiquetas, 300 listas, 300 caixas, 300 agentes e 300 pessoas por pedido, sem busca por nome. Se um recurso existente não aparecer para ele, não peça para criar uma duplicata: confira o nome no catálogo correspondente e monte essa referência manualmente no passo.

Ele não cria caixa de entrada, canal nem agente. Para esses recursos, pode apenas recomendar a página correspondente; conclua a criação fora da doca e depois faça um novo pedido.

O que fica fora do alcance

O AgentMaker de Automações não pode:

• criar uma automação nova — ele altera o fluxo de uma automação que já existe;
• ligar ou desligar a automação, nem alterar suas Configurações;
• executar ou testar o fluxo;
• criar caixa de entrada, canal ou agente;
• garantir que um envio real ocorrerá: janelas de canal, consentimento, frequência, opt-out, permissões e dados presentes no momento da execução continuam valendo.

Ele pode ler as execuções recentes da automação para diagnosticar um problema, mas a correção sugerida segue o mesmo caminho de revisão ou confirmação descrito acima.

Conversa, interrupção e reinício

A conversa da doca acompanha você entre as telas; a tela atual entra como contexto de cada pedido. Reiniciar conversa pede confirmação e começa do zero, sem desfazer o que já foi aplicado ou salvo, nem remover etiquetas e listas criadas. A cópia local da conversa fica neste navegador, por organização, e é de melhor esforço: outro navegador ou dispositivo não a restaura.

• Enquanto um pedido roda, use Interromper para pará-lo.
• Se você sair da área ou do recurso durante um pedido, ele é interrompido e a doca avisa o motivo.
• Uma revisão ou proposta antiga, depois de recarregar a página, deve ser tratada como histórico se o cartão não oferecer mais as ações. Peça uma proposta nova.

Revisão e teste

Antes de salvar, percorra o fluxo do gatilho até cada saída, abra os passos e confirme referências, textos, tempos, variáveis e conexões. Depois use Testar. O teste executa o rascunho atual: envios são simulados, mas IA e chamadas de webhook são reais. Consulte Execuções e testes antes de rodá-lo.