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.

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.

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.