Versões e publicação

No LangChain Agent, cada alteração do agente vira uma versão numerada (v1, v2, v3…). Duas ações diferentes:

• Salvar cria uma versão nova, que fica como rascunho. Nenhum lead recebe.
• Publicar escolhe a versão que está no ar. É a que responde aos leads.

Isso deixa mexer, testar e só então trocar o que o lead recebe. Também deixa voltar atrás: a versão anterior continua guardada.

​

O que é versionado

Tudo o que fica no config do agente: modelo e parâmetros, prompt, Enviar dados, tools (ações da Zatten, HTTP, apps integrados, MCP), skills, lista de tarefas, resumo do histórico, retry e fallback, falha do agente, monitoramento (LangSmith), limite de chamadas, filtro de tools e descarte de resultados. Não é versionado e vale na hora em que muda, sem publicar: os ajustes de Configurações avançadas que ficam no projeto, como Tempo de espera (buffer), Pausa humana e Segmentação. (Falha do agente, na mesma seção, é do config e é versionada.) Também não são do config: o funil, as tags, as propriedades e as automações do projeto.

​

Onde fica no painel

Menu Agente (/project), no topo da página:

• Seletor de versões (ícone de relógio com vN): lista as versões, da mais nova para a mais antiga, com o tempo desde a criação. A publicada tem ponto verde e o selo publicada. Clicar numa versão abre a configuração dela no editor.
• Botão de ação, que muda conforme o estado:

​

Como funciona

Quando a mudança chega aos leads. Conversas novas e conversas em andamento passam a usar a versão publicada em até 2 minutos. Uma mensagem que chegou logo depois de publicar ainda pode ser respondida pela versão anterior.

​

Voltar a uma versão anterior

1. Abra o seletor de versões e clique na versão que estava boa.
2. Confira a configuração no editor (e no chat de teste, se quiser).
3. Clique em Publicar.

As versões mais novas continuam guardadas; dá para voltar a elas do mesmo jeito. Para partir de uma versão antiga e mudar algo nela: abra a versão, edite e Salve. A versão nova nasce do conteúdo da antiga. Restaurar uma versão restaura tudo o que estava no config dela, inclusive o texto das skills e a chave do modelo daquela época.

​

Pelo MCP

O MCP nunca publica. Uma escrita no bloco langchain (ou no bloco skills, quando acrescenta skill ao agente) cria uma versão nova, não publicada, e a versão no ar continua a mesma.

• Se o config enviado é igual ao atual, nenhuma versão é criada.
• Se já havia uma versão por publicar, a escrita é gravada por cima dela, e uma nota avisa. Quem deixou aquele rascunho pode ter mudanças que não estão no seu config: confira antes de pedir para publicar.
• get_template devolve o config da versão mais nova, publicada ou não. Assim uma escrita não apaga o rascunho que alguém deixou no painel.
• A resposta de update_template traz a versão criada em agent.version e agent.published: false.

Depois da escrita, diga à pessoa, em Para você fazer no painel: testar no chat de teste e publicar a versão N. Com navegador, o assistente pode clicar em Publicar, com um “sim” da pessoa e o nome do projeto conferido na tela.

​

Armadilhas

• Salvar não é publicar. O aviso verde de “Versão salva” não põe nada no ar.
• Rascunho de outra pessoa. Duas pessoas (ou a pessoa e o assistente) editando ao mesmo tempo: cada um salva uma versão a partir do que tinha na tela, e publicar uma deixa de fora a mudança da outra. Combine quem edita e quem publica.
• Esperar efeito imediato. Até 2 minutos para as conversas pegarem a versão nova.
• Achar que buffer e pausa voltam com a versão. Esses ajustes não são versionados; restaurar uma versão não muda o valor atual deles.
• Restaurar traz a chave antiga. Se a chave do modelo foi trocada depois daquela versão, a versão restaurada usa a chave antiga. Confira no editor antes de publicar.

​

Perguntas frequentes

​

Para saber mais

• Testar o agente
• O que só se faz pelo painel
• Como uma escrita funciona
• Referência do config do agente
• LangGraph: visão geral
• Termos para buscar: “assistant versions LangGraph”, “set latest version”, “publicar agente”.