Montando a automação com o AgentMaker

O AgentMaker do editor transforma uma descrição em linguagem comum em uma proposta de fluxo. Ele recebe o grafo que está no canvas no início de cada mensagem, o nome e o estado da automação, o fuso da organização, o catálogo de passos e referências da organização. Nada é aplicado enquanto você não selecionar Aplicar no fluxo.

Use-o para montar ou alterar o grafo. A decisão de salvar — que cria uma versão e, se a automação já estiver ligada, coloca essa versão no ar — continua sendo sua.

Onde abrir e quem pode usar

Abra uma automação e permaneça em Editor. Na barra superior, selecione AgentMaker; o painel aparece entre a navegação lateral e o canvas. Ele não aparece em Configurações nem em Atividade.

O botão e o backend exigem automations.write. Uma pessoa com acesso somente de leitura não o vê. Essa permissão, porém, não concede automaticamente permissão para criar etiquetas ou listas; veja Quando falta uma etiqueta ou 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. Para reduzir ambiguidades, use os nomes visíveis no SquadOS e diga explicitamente quando quer preservar uma parte do fluxo atual.

Da conversa ao canvas

1. Ao enviar a mensagem, o AgentMaker congela como base o grafo que está no canvas naquele instante.
2. Ele devolve o grafo inteiro, preservando os passos que você não pediu para mudar e usando somente referências conhecidas da organização.
3. Antes de exibir a proposta, o backend chama o mesmo validador de grafo usado no salvamento. O AgentMaker pode corrigir uma resposta inválida e tentar novamente, até três tentativas de validação no mesmo turno.
4. O cartão resume passos adicionados, removidos, trocados de tipo e campos alterados, além da quantidade de ligações criadas ou removidas. Para campos que apontam para recursos — como etiqueta, caixa, agente, modelo ou template — o cartão mostra o nome do campo, mas não o valor escolhido. Confirme esse valor no painel do passo depois de aplicar.
5. Se estiver de acordo, selecione Aplicar no fluxo. O grafo passa para o canvas como alteração não salva e entra no histórico local do editor; Ctrl+Z desfaz.
6. 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: há contratos conhecidos que o editor marca e o salvamento ainda pode aceitar.
7. Use Salvar somente quando o rascunho estiver correto. O AgentMaker não salva, não liga e não desliga a automação.

Se as três tentativas falharem ou o validador estiver indisponível, ele deve explicar que não conseguiu montar o fluxo. Reformule o pedido em uma alteração menor ou faça a configuração manualmente; não interprete a ausência do cartão como mudança aplicada.

Não misture edição manual e proposta pendente

Depois que o cartão aparecer, não edite nenhum passo nem nenhuma ligação antes de aplicar. A proteção atual detecta mudanças em passos e configurações, mas não compara as ligações. Uma conexão alterada manualmente pode ser substituída sem aviso pelo grafo inteiro da proposta.

Se você mexeu no canvas, não use o cartão antigo. Envie uma nova mensagem pedindo para refazer a proposta com o fluxo atual. Quando a mudança detectada está em um passo, o cartão exibe o aviso de proposta desatualizada e bloqueia a aplicação; isso não torna segura uma alteração feita somente nas conexões.

Também não aplique uma proposta antiga depois de fechar o painel ou recarregar a página. O histórico textual pode voltar, mas o grafo-base do cartão não é restaurado. Peça uma proposta nova.

Quando falta uma etiqueta ou uma lista

O AgentMaker pode propor a criação de etiquetas de contato e listas de contatos. O cartão informa cada nome e motivo; Criar grava os recursos e Continuar inicia outro turno para montar o fluxo com os IDs reais.

Antes de criar:

• confira nos catálogos se o mesmo nome já existe;
• para etiqueta, confirme que você pode editar contatos (contacts.write em organizações com permissões granulares; no modo legado, o catálogo exige nível Colaborador ou superior);
• para lista, confirme que você é Administrador ou superadmin, conforme a política atual do catálogo de e-mail;
• se o cartão trouxer vários itens e ocorrer erro, verifique quais já foram criados antes de tentar novamente. As inserções são sequenciais e não têm rollback; repetir desde o primeiro nome pode parar na restrição de nome único e deixar os itens restantes sem criação.

Depois de uma criação bem-sucedida, o botão Continuar pode enviar uma instrução interna incorreta herdada do editor de prompt. Se o AgentMaker falar em prompt, ferramentas ativas ou não retomar o grafo, escreva uma mensagem nova e explícita, por exemplo: “Continue montando esta automação usando a etiqueta Cliente em risco”.

O AgentMaker consulta no máximo 300 etiquetas, 300 listas, 300 caixas, 300 agentes e 300 pessoas por turno, sem busca por nome. Se um recurso existente não aparecer para ele, não crie uma duplicata. Abra o catálogo correspondente para confirmar o nome 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 do painel e depois faça um novo pedido.

O que fica fora do alcance

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

• salvar, ligar ou desligar a automação;
• executar ou testar o fluxo;
• alterar Configurações da automação;
• 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.

Quando o pedido depende de uma dessas ações, ele deve apresentar uma recomendação em vez de alegar que executou a mudança.

Conversa, fechamento e reinício

Cada combinação de usuário, automação e modo mantém uma cópia da interface da conversa no localStorage deste navegador. O backend também conserva o histórico associado ao identificador da conversa. A gravação local é de melhor esforço: quota cheia, dados corrompidos, outro navegador ou outro dispositivo podem impedir a restauração.

• O X fecha o painel sem apagar a conversa, mas não é o comando de interrupção. Se a resposta ainda estiver sendo gerada, use Parar antes de fechar; o fechamento sozinho não aborta a requisição.
• Reiniciar conversa pede confirmação, limpa a cópia local e inicia um novo contexto na próxima mensagem. Não desfaz o grafo aplicado e não remove etiquetas ou listas já criadas.
• Depois de recarregar ou reabrir, trate cartões de aplicação anteriores como histórico e 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, HTTP, criação/atualização de contato e outros efeitos podem ser reais. Consulte Execuções e testes antes de rodá-lo.