---
title: Publicação e versões
description: Rascunho, publicado e arquivado — o que Publicar faz, o que só vale depois de republicar, o que vale na hora e o que fazer quando a publicação falha.
---

# Publicação e versões

Tudo o que você edita no assistente do Agent fica num **rascunho de trabalho**. As conversas com clientes nunca usam esse rascunho diretamente: elas usam a **versão publicada**, uma "foto" da configuração tirada no momento em que você clicou em **Publicar**.

Isso permite ajustar o Agent com calma, testar no [Playground](/guia/agents/playground) e só então colocar as mudanças no ar.

## Os três status

| Status | O que significa |
|---|---|
| **Rascunho** | O Agent nunca foi publicado. Ainda não atende ninguém. |
| **Publicado** | Existe uma versão no ar. As conversas usam essa versão. |
| **Arquivado** | O Agent foi retirado de uso. |

O status aparece no card de cada Agent na lista de **Agentes**, e o filtro **Status** permite ver só um deles.

## Salvar rascunho e Publicar

No rodapé do assistente há dois botões:

| Botão | O que faz | Afeta as conversas? |
|---|---|---|
| **Salvar rascunho** | Guarda a configuração atual. Mensagem: "Rascunho salvo." | **Não.** A versão publicada continua a mesma. |
| **Publicar** | Salva a configuração e tira uma nova "foto" dela, que passa a ser a versão no ar. Mensagem: "Agente publicado com sucesso." | **Sim**, a partir da próxima mensagem. |

<Passos>
  <Passo>

**Revise.** O último passo do assistente, **Confira antes de publicar**, lista o que falta. Enquanto houver pendências, aparece "Falta um item para publicar" (ou "Faltam N itens") e o botão fica bloqueado. Use **Salvar rascunho** para não perder o trabalho.

  </Passo>
  <Passo>

**Teste.** No [Playground](/guia/agents/playground), escolha a versão **Rascunho** para conversar com o que você acabou de editar, antes de publicar.

  </Passo>
  <Passo>

**Publique.** Com tudo certo, a Revisão mostra "Pronto para atender". Clique em **Publicar**.

  </Passo>
</Passos>

<Dica>

Pode publicar quantas vezes quiser. Cada publicação gera uma nova versão (v1, v2, v3...), e o Playground permite conversar com a **Publicada** ou com o **Rascunho**.

</Dica>

## O que só vale depois de republicar

Qualquer mudança na **configuração** do Agent fica só no rascunho até você publicar de novo:

- Nome, tipo, modelo, instrução (System Prompt) e User Message Template
- Ferramentas: adicionar, remover, ligar ou desligar MCP Servers, Function Tools e Skills
- Quais ferramentas do CRM ou de um MCP o Agent pode usar (**Selecionar tools**)
- Artigos de conhecimento vinculados (incluir ou tirar um artigo) e seus controles
- Sub-agents: adicionar, remover, editar, e o **Somente roteamento**
- Regras de conduta (guardrails)

## O que vale na hora, sem republicar

Algumas coisas não fazem parte da "foto" do Agent e são lidas no momento da conversa:

| Item | Por quê |
|---|---|
| **Conteúdo de uma Skill** | O Agent guarda só o vínculo com a skill. O corpo é lido quando ele carrega a skill, então editar o texto da skill vale para a próxima conversa. Já **vincular ou desvincular** a skill exige republicar. |
| **Texto de um artigo de conhecimento já vinculado** | O Agent busca no conteúdo atual do artigo, então editar o texto vale assim que ele é processado. Já um artigo **novo** precisa ser vinculado ao Agent e o Agent republicado. |
| **Credencial de uma Function Tool ou MCP** | Trocar o token vale na próxima chamada. |
| **Lista de ferramentas de um MCP Server** | É buscada direto no servidor a cada conversa. |
| **Dados do CRM** | Etapas, tags e campos são consultados na hora pelas ferramentas do CRM. |

<Cuidado>

Por valer na hora, uma edição errada numa Skill ou numa base de conhecimento afeta **todos** os Agents que as usam, imediatamente. Teste no Playground depois de mexer.

</Cuidado>

## Quando a publicação falha

O assistente mostra "Erro ao publicar agente." As causas mais comuns:

| Causa | Como resolver |
|---|---|
| O modelo escolhido é de um provedor que exige **credencial própria** (OpenAI, Anthropic, OpenRouter, Gemini, Mistral, Groq, DeepSeek, Ollama, xAI) e o workspace não tem a integração desse provedor com status **Conectado**. | Conecte o provedor em **Conexões → Integrações**, ou troque para um modelo que não exige credencial. |
| **Somente roteamento** ligado com um sub-agent de fallback que foi renomeado ou removido. | Na aba **Sub-agentes**, escolha outro fallback. |
| Agent do tipo **Loop** com mais de um sub-agent. | Deixe exatamente um. Veja [Tipos de Agent](/guia/agents/sub-agents#loop). |
| Agent **Sequencial** sem sub-agents ou **Paralelo** com menos de dois. | Adicione os sub-agents que faltam. |
| Um artigo de conhecimento ou uma skill vinculados foram excluídos. | No passo **Conhecimento** ou **Ferramentas**, remova o vínculo quebrado. |

Se nenhuma dessas for a causa, salve o rascunho e fale com o suporte.

## Arquivar

Na lista de **Agentes**, abra o menu do card (os três pontos) e clique em **Arquivar**. O Agent sai da lista e para de ser oferecido para novos atendimentos.

<Cuidado>

- Não há botão para desarquivar. Para recuperar um Agent arquivado, fale com o suporte.
- Antes de arquivar, confira se o Agent não está em uso num fluxo do Flow Builder ou num canal. Um fluxo que aponta para um Agent arquivado deixa de conseguir executá-lo.
- Só quem tem permissão de excluir agents vê a opção **Arquivar**.

</Cuidado>

## Histórico de versões

Cada publicação fica registrada como uma versão numerada, e o Playground e as [Avaliações](/guia/agents/eval) mostram qual versão foi usada. Hoje **não há tela para voltar a uma versão anterior**. Para desfazer uma mudança, edite o Agent de volta e publique de novo. Se precisar restaurar uma versão antiga, fale com o suporte.

## Saiba mais

- [Criar seu primeiro Agent](/guia/agents/criar-primeiro)
- [Playground](/guia/agents/playground) — testar o rascunho antes de publicar
- [Ferramentas do Agent](/guia/agents/ferramentas)