Principal Configurações avançadas Como editar agents com Rascunhos (Draft) na ClaudIA Agêntica

Como editar agents com Rascunhos (Draft) na ClaudIA Agêntica

Última atualização em May 12, 2026

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.