Tema
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 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. |
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.
Teste. No Playground, escolha a versão Rascunho para conversar com o que você acabou de editar, antes de publicar.
Publique. Com tudo certo, a Revisão mostra "Pronto para atender". Clique em Publicar.
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.
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. |
Atenção
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.
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. |
| 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.
Atenção
- 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.
Histórico de versões
Cada publicação fica registrada como uma versão numerada, e o Playground e as Avaliações 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
- Playground — testar o rascunho antes de publicar
- Ferramentas do Agent