Como editar agents com Rascunhos (Draft) na ClaudIA Agêntica
Agora é possível testar as modificações nos agentes antes de enviar para produção
Agora, toda edição gera primeiro um Rascunho — uma versão separada do agent que existe apenas pra você revisar e testar.
O agent em produção continua atendendo cliente normalmente. O rascunho só substitui a versão de produção quando você
clica em Publicar.
Funciona para:
- Edição de agents existentes
- Criação de agents novos (gera um rascunho, que vira produção na primeira publicação).
Passo a passo
Etapa 1 — Editar um agent
Vá até Agents no menu lateral
Clique em Editar no card do agent que você quer modificar
Altere o que precisar: nome, descrição, system prompt, tools selecionadas, etc.
Clique em Salvar
O agent volta pra listagem com o ícone "Modificado". Em produção, nada mudou ainda — só existe um rascunho associado.
Etapa 2 — Comparar rascunho vs produção
No card do agent com badge Modificado, clique em Ver mudanças (ícone ao lado do lápis)
Um modal abre mostrando lado a lado:
- Esquerda: versão atual em produção
- Direita: versão do rascunho
Os campos comparados são os mesmos em todo agent:
- Nome
- Descrição
- System prompt
- MCP servers e tools selecionadas
- Sub-agents vinculados (no caso do supervisor)
Listas (como tools e sub-agents) mostram explicitamente o que foi + Adicionado e − Removido. Campos simples (texto,
prompt) aparecem lado a lado destacando a diferença.
Etapa 3 — Testando um rascunho
Basta clicar no ícone de playground do agente em rascunho.
Teste o novo comportamento dele.
OBS: o playground sempre olha para os agentes em rascunho.
Etapa 4 — Publicar o rascunho
Publicação simples (agent isolado)
No card do agent, clique em Publicar (ícone similar a um "enviar mensagem" em destaque laranja)
Um modal de confirmação aparece. Clique em Confirmar
O rascunho substitui a versão de produção (pode demorar 2s). O ícone Modificado some.
Publicação em cascade (supervisor com sub-agents alterados)
Se você publicar um supervisor que referencia sub-agents também modificados, o modal Publicar em Cascade abre
automaticamente.
Ele lista todos os agents que serão publicados juntos.
A publicação acontece em ordem topológica: sub-agents primeiro, supervisor por último. Isso garante que o supervisor já
encontre os sub-agents corretos no momento em que entra em produção.
Se algum passo falhar no meio, o modal fica aberto pra você tentar de novo. O sistema garante que cada agent é publicado
uma vez só, sem duplicação por retry ou clique duplo.
Descartar um rascunho
Abra o card do agent Modificado, clique em Descartar no canto inferior direito.
Confirme a ação
O rascunho é excluído. Produção segue exatamente como estava antes.
Editando tools de um agente dentro de um rascunho
A seleção de tools dentro do agente faz parte do rascunho como qualquer outro campo.
Marque/desmarque tools dentro de Agent Tools durante a edição
Clique em Save Changes — a mudança vai pro rascunho
No diff modal, as tools alteradas aparecem como + Adicionou ou − Removeu dentro do agente correspondente
Perguntas frequentes
O agent em produção continua atendendo cliente enquanto eu edito o rascunho?
Sim. Toda edição vive em um rascunho separado. O cliente continua conversando com a versão de produção até você clicar
em Publicar.
Posso ter rascunho de um agent que ainda não existe em produção?
Sim. É o caso de um agent novo (rascunho orphan). Quando você publicar pela primeira vez, ele é criado direto em
produção.
Se a publicação falhar no meio, perco tudo?
Não. O modal fica aberto pra você tentar de novo. O sistema rastreia o que já foi publicado e só completa os passos
restantes, sem duplicar.
Posso reverter para uma versão anterior já publicada?
Não diretamente pela interface. O fluxo é editar de novo, gerar um novo rascunho com o conteúdo desejado e publicar. Não
há histórico navegável de versões anteriores.
