> For the complete documentation index, see [llms.txt](https://docs.patagon.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.patagon.ai/otimizacao-do-agente/agent-versions.md).

# Como gerenciar versões do agente

Cada alteração no prompt do agente deve ser registrada como uma versão. As versões permitem testar novos prompts com segurança e reverter instantaneamente se algo der errado.

No menu lateral, acesse Agente > Geral e clique na aba Versões.

## Como as versões funcionam

Seu agente sempre tem uma versão Atual (a que está em produção). Quando quiser fazer alterações, crie um Rascunho. O Rascunho permite editar, testar no Playground e ativar somente quando estiver confiante.

| Status             | O que significa                                            |
| ------------------ | ---------------------------------------------------------- |
| Atual              | Ativa em produção. Leads estão conversando com esta versão |
| Rascunho           | Em andamento. Ainda não está ativa                         |
| Versões anteriores | Snapshots históricos na lista de versões                   |

## Como criar uma nova versão

1. Na aba Versões, clique em Criar Rascunho.
2. Vá para a aba Objetivos e Tom e faça suas alterações.
3. Clique em Salvar.
4. Teste em Agente > Playground. Envie mensagens para confirmar que o novo comportamento funciona.
5. Quando estiver pronto, clique em Ativar versão no Rascunho para torná-lo a versão Atual.

{% hint style="warning" %}
Um Rascunho não está ativo até você ativá-lo. Seu agente continua rodando na versão Atual enquanto você trabalha no Rascunho. Não pule os testes antes de ativar. Uma vez ativado, o Rascunho substitui imediatamente a versão Atual em produção.
{% endhint %}

## Como reverter para uma versão anterior

Se uma nova versão causar problemas (queda na taxa de qualificação, respostas inesperadas, leads desistindo), você pode reativar qualquer versão anterior instantaneamente.

1. Acesse Agente > Geral > Versões.
2. Encontre a versão que deseja restaurar na lista do Histórico de Versões.
3. Passe o mouse sobre o card da versão. O botão Ativar versão aparece.
4. Clique em Ativar versão. A versão selecionada torna-se imediatamente a versão Atual e seu agente começa a executá-la em produção.

## Como adicionar uma descrição a uma versão

Cada versão tem um botão + Adicionar descrição. Use-o para registrar o que mudou. Por exemplo: 'Ajustei o limite de orçamento para mínimo de $10K' ou 'Adicionei caminho de desqualificação para perguntas fora do escopo'. As descrições facilitam encontrar a versão certa quando você precisa reverter.

## Boas práticas

* Sempre crie um Rascunho antes de fazer alterações significativas no prompt.
* Adicione uma descrição a cada versão antes de ativá-la. Você vai agradecer quando precisar reverter semanas depois.
* Teste no Playground antes de ativar.
* Altere uma coisa por versão. Se alterar múltiplas coisas no mesmo Rascunho, não saberá o que causou uma queda no desempenho.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.patagon.ai/otimizacao-do-agente/agent-versions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.