AgentMaker

O AgentMaker é o copiloto do editor de agentes. Você descreve o resultado desejado em linguagem natural, ele analisa a configuração disponível e devolve uma proposta para revisão. Nenhuma mudança de prompt é salva só porque apareceu na conversa.

Esta página trata do AgentMaker do agente. O editor de automações usa outro modo do mesmo copiloto para montar um fluxo; consulte Montando a automação com o AgentMaker.

Antes de começar

Você precisa de permissão para editar agentes (agents.write) e deve usar o editor em uma tela de desktop. Em larguras menores, o painel não é exibido.

Salve qualquer alteração manual pendente antes de conversar. O contexto enviado ao AgentMaker usa o último prompt salvo, não o texto ainda não salvo no editor. Essa precaução evita que uma proposta calculada sobre a versão anterior substitua seu rascunho.

Prompts podem ter até 32.000 caracteres no editor, mas o AgentMaker recebe somente os primeiros 8.000 caracteres do prompt salvo. Em prompts longos, peça mudanças pequenas e confira todo o texto antes de aplicar uma reescrita completa.

O que ele consegue analisar

No modo de agente, o AgentMaker recebe:

• o prompt salvo e diagnósticos da estrutura;
• as ferramentas ativas no agente e as disponíveis para a organização;
• os nomes e as descrições das bases de conhecimento vinculadas — não o conteúdo dos itens;
• configurações relevantes do agente e capacidades do modelo selecionado;
• o mapa atual da navegação administrativa, para indicar onde alterar uma configuração.

Com esse contexto, ele pode preparar a reescrita de uma seção, adicionar uma seção, substituir o prompt inteiro, sugerir ferramentas ou explicar um problema de configuração. Ele não testa o agente nem garante que a proposta produzirá o comportamento esperado.

Como abrir

Há quatro entradas no editor:

1. Depois de criar um agente manualmente, o editor abre o AgentMaker automaticamente no desktop.
2. Clique em AgentMaker, no cabeçalho do editor. O botão funciona a partir de qualquer seção.
3. Na seção Prompt, clique em Editar Prompt. Isso abre o editor de texto e o painel juntos.
4. Em Insights, clique em Pedir ao AgentMaker. O painel abre e a pergunta sugerida é enviada automaticamente.

O X fecha apenas o painel. Na seção Prompt, selecionar Visualizar também o fecha e devolve o texto ao modo de leitura. Histórico abre versões anteriores do prompt e é um fluxo separado.

O painel Testar Agente e o AgentMaker não ficam abertos ao mesmo tempo: abrir um fecha o outro.

Revisar e aplicar uma proposta

1. Escreva um objetivo específico, por exemplo: “deixe o tom formal e proíba descontos sem aprovação”.
2. Aguarde a resposta. Você pode interromper a geração pelo controle de parada.
3. Quando houver mudanças aplicáveis, confira o cartão Melhorias propostas e expanda os trechos para comparar o texto.
4. Selecione Aplicar tudo ou Descartar. Uma resposta apenas explicativa não mostra esses botões.
5. Revise o editor e selecione Salvar para persistir o novo prompt. Use Descartar na barra do editor se não quiser salvar o rascunho.
6. Teste o agente em uma conversa controlada antes de publicar ou usar a nova configuração.

Aplicar uma proposta substitui o rascunho do prompt no formulário; não faz uma mesclagem com edições manuais paralelas. Para mudanças grandes, aplique e salve uma proposta por vez.

Pedir que o agente envie fotos

Diga ao AgentMaker em que situação o agente deve mostrar uma foto e qual imagem usar. Por exemplo: “Quando a pessoa pedir o catálogo, envie a foto de cada produto mencionado e explique o preço de cada um.” Para fotos já existentes, forneça os endereços públicos das imagens ou indique onde o agente deve obtê-los. Você não precisa escrever ![imagem](url) nem ligar Dividir resposta em várias mensagens para isso.

O AgentMaker pode propor a regra no prompt para sua revisão. O SquadOS cuida do formato e envia cada imagem escolhida como foto em canais compatíveis, como WhatsApp. Se você quer que o agente crie uma imagem nova, ele também precisa ter a capacidade de geração de imagens ativa. Confira Configurações Avançadas para o comportamento das mensagens.

Mudanças em ferramentas

O AgentMaker pode propor ativar ou desativar ferramentas nativas e do Composio. Ao selecionar Aplicar tudo, essas alterações são persistidas imediatamente; a parte do prompt continua sendo apenas um rascunho até Salvar.

Revise a seção Ferramentas depois de aplicar. Algumas ferramentas nativas ainda exigem configuração própria — por exemplo, escolher as bases que uma consulta pode pesquisar. Servidores e ferramentas MCP entram no contexto do AgentMaker, mas ele não consegue ativá-los ou desativá-los pelo cartão.

Se a aplicação de um lote falhar, não presuma reversão completa: ferramentas processadas antes do erro podem continuar alteradas. Confira Ferramentas, corrija a configuração e só então decida se deve tentar novamente.

Para configurações que ele não altera diretamente, o AgentMaker apresenta uma recomendação e o caminho da interface. Você continua responsável por abrir a seção indicada e confirmar a mudança.

Histórico da conversa

Depois que uma resposta termina, o navegador guarda a conversa por usuário, agente e modo do AgentMaker. Recarregar ou voltar ao mesmo agente no mesmo navegador normalmente restaura as mensagens e uma proposta pendente.

Reiniciar conversa pede confirmação, limpa o histórico exibido nesse navegador e inicia uma nova conversa. Isso não altera o prompt salvo, não desfaz ferramentas já aplicadas e não representa uma solicitação de exclusão dos registros de conversa mantidos pelo serviço.

O botão de ajuda, identificado por O que o AgentMaker faz, resume as capacidades do modo atual e aponta para esta documentação.

Em qualquer tela

O AgentMaker também fica na aba AgentMaker, na borda direita, em todas as telas do painel. A aba aparece para quem pode editar agentes (agents.write): administradores e donos sempre a veem, e quem só atende conversas não. Cada mudança continua exigindo a permissão da área que ela altera.

Diagnosticar uma conversa

Abra a conversa em Conversas e descreva o problema na aba. Por exemplo: “a pessoa disse ‘Oi, estou na página blog.IA e tenho dúvidas’ e o agente não consultou o cadastro dela”. O AgentMaker lê a conversa — o que o contato escreveu, o que o agente respondeu, as ferramentas que ele usou (com o que enviou e o que recebeu), as transferências e as notas internas — e explica o que aconteceu antes de propor uma mudança.

Ele lê somente conversas de clientes que você já pode ver em Conversas.

Configurar os motivos de transferência

Na ferramenta Transferir Conversa, o AgentMaker lê os motivos atuais do agente e pode propor uma nova lista: quando transferir, para quem em cada faixa de horário e para quem fora desses horários.

1. Descreva o roteamento que você quer, por exemplo: “se o cadastro mostrar que é aluno, mande para o Agente de Suporte; se não for, mande para o Agente de Vendas em horário comercial e para o atendimento comercial fora dele”.
2. Confira o cartão Confirmar alteração: em Motivos de transferência aparece a lista proposta com o nome de cada destino, e Como está hoje mostra a configuração atual.
3. Selecione Confirmar para gravar, ou Descartar. Nada muda antes disso.

Os horários seguem o fuso da organização. Quando o motivo depende de uma informação que o agente precisa buscar antes — como consultar o cadastro do contato com uma ferramenta HTTP —, o AgentMaker também propõe a instrução no prompt.

Se os horários do agente tiverem exceções de data, como feriados, ajuste-os pela seção Ferramentas do agente: o AgentMaker não altera essa configuração.

Boas práticas

• salve o rascunho manual antes de pedir uma análise;
• diga o papel, o público, o tom, a regra e o resultado que quer mudar;
• prefira uma melhoria verificável por vez;
• leia o diff completo, principalmente quando o prompt ultrapassa 8.000 caracteres;
• confira ferramentas e configurações recomendadas antes de salvar o prompt;
• teste casos normais, limites e recusas após cada alteração.