Um agente nunca está terminado. Afinas as instruções depois de uma conversa confusa, adicionas uma ferramenta para o novo sistema de reservas, trocas a saudação para o verão. A maioria das alterações torna-o melhor. De vez em quando uma torna-o pior e, até agora, a única forma de voltar atrás era lembrares-te do que lá estava antes.

A partir desta semana, cada alteração deixa uma versão. Os agentes e os servidores MCP têm um novo separador Histórico, em Configuração no editor, e cada ferramenta da Biblioteca de ferramentas tem o seu próprio histórico. Eis o que guarda e como o usar.

O que guarda uma versão

Uma versão é tudo o que molda a forma como o agente responde e o seu aspeto:

  • O prompt (ou, num servidor MCP, as suas instruções) e as definições de comportamento.
  • As traduções: títulos, saudações e perguntas sugeridas em cada idioma.
  • O aspeto do widget, os menus de boas-vindas, o logótipo e a capa.
  • O formulário de feedback e as proteções.
  • As ferramentas e bases de conhecimento ligadas, e os vídeos.

Algumas coisas ficam de fora de propósito: preço e faturação, estado e visibilidade, quem tem acesso, verificação, a equipa, os canais e o domínio próprio. Repor isso podia custar dinheiro, deixar pessoas sem acesso ou quebrar uma ligação, por isso uma reposição nunca lhes toca.

Cada alteração, venha de onde vier

Uma versão regista quem fez a alteração e onde: o painel, a API, o MCP ou uma importação. Isso importa mais do que parece. Se um assistente edita o teu agente através do MCP durante a noite, ou um script o atualiza através da API, a alteração fica no Histórico como qualquer outra, com uma nota curta do que mudou: "Prompt editado", "Ferramenta adicionada: Booking", "Idioma adicionado: polaco".

Gravações rápidas da mesma pessoa juntam-se. Cinco gravações em dois minutos enquanto afinas um parágrafo aparecem como uma só versão, para que a cronologia se leia como uma lista de decisões e não de teclas. Uma gravação que não muda nada do que uma versão guarda, uma mudança de preço por exemplo, não cria versão nenhuma.

Compara, depois repõe

01

Abre o Histórico

A cronologia mostra cada versão com quem a guardou e quando, e a que está em uso no topo. Filtra por Pontos de restauro para veres só as versões a que deste nome.

02

Abre uma versão

Vê o que essa versão mudou, ou compara-a com a que está em uso: "Se repuseres a v12, isto muda:", área a área: o prompt, as definições, os idiomas, as ferramentas, o conhecimento e o resto.

03

Repor esta versão

Tudo o que ela guarda volta a como estava, para toda a gente, de imediato. As ferramentas ou bases de conhecimento apagadas entretanto ficam de fora, e a reposição diz-te quais.

04

Anula, se precisares

Uma reposição fica registada como uma nova versão, por isso o estado que deixaste continua no Histórico, a um clique de distância.

Pontos de restauro para as versões que importam

Antes de uma grande alteração, carrega em Guardar ponto de restauro e dá um nome à versão em uso: "Antes da Black Friday", "Versão de lançamento", "Aprovado pelo jurídico". Os pontos de restauro com nome ficam guardados para sempre e nunca contam para o número de versões que o teu plano guarda, por isso podes sempre voltar a eles, por muitas alterações que se sigam.

Anula logo a seguir a guardar

Nem todos os erros esperam para ser encontrados. Depois de cada gravação aparece um pequeno Anular, que leva o agente de volta a como estava imediatamente antes da tua alteração. Só anula a tua própria alteração recente, por isso nunca desfazes o trabalho de um colega por engano.

Duas pessoas, um agente

O histórico de versões resolve também um problema mais antigo e mais silencioso. Se abriste o editor de manhã e entretanto um colega, um script da API ou uma reposição alterou o agente, o teu Guardar é agora travado com uma mensagem curta a dizer quem o alterou, e um botão Recarregar que traz a alteração dessa pessoa mantendo as tuas edições por guardar. Duas pessoas já não conseguem sobrepor o trabalho uma da outra sem saberem.

As ferramentas têm o seu próprio histórico

Uma ferramenta pode ser usada por vários agentes, por isso tem a sua própria cronologia na Biblioteca de ferramentas: nome, descrição, entradas, as instruções para o agente e as definições da ação. Ficam guardadas as últimas 10 versões de cada ferramenta. Ao repor uma, vês que agentes e servidores MCP a usam, porque a alteração se aplica em todo o lado ao mesmo tempo.

Quem pode fazer o quê

Todos os membros do espaço de trabalho podem ler o Histórico. Os proprietários e administradores podem repor versões e dar-lhes nome. Quantas versões ficam guardadas depende do teu plano, e o separador Histórico diz-te; os pontos de restauro com nome ficam sempre guardados. Combina-o com o feedback às respostas: quando uma alteração faz subir a contagem de 👎, sabes exatamente a que versão voltar.

Perguntas frequentes

Posso repor uma versão anterior do meu agente de IA?

Sim. Abre o separador Histórico no editor do agente, escolhe a versão, compara-a com a que está em uso e carrega em Repor esta versão. A reposição é ela própria uma nova versão, por isso podes anulá-la.

O que é que uma reposição não altera?

Preço e faturação, estado e visibilidade, listas de acesso, verificação, a equipa, os canais e o domínio próprio. Repor isso podia custar dinheiro, deixar pessoas sem acesso ou quebrar uma ligação, por isso nunca fazem parte de uma versão.

As alterações feitas através da API ou do MCP ficam registadas?

Sim. As alterações feitas no painel, na API, no MCP e em importações deixam todas uma versão, marcada com a origem e com quem as fez.

Durante quanto tempo ficam guardadas as versões?

O teu plano define quantas versões guarda cada agente e servidor MCP; o separador Histórico mostra o número. Os pontos de restauro com nome ficam sempre guardados. Cada ferramenta guarda as suas últimas 10 versões.

Quem pode repor uma versão?

Os proprietários e administradores do espaço de trabalho. Os outros membros podem ver o histórico, mas não repor nem dar nome a versões.