> ## Documentation Index > Fetch the complete documentation index at: https://docs.tela.com/llms.txt > Use this file to discover all available pages before exploring further. # Publicação e versões > Como cada alteração vira uma versão, o que publicar faz, como visualizar e restaurar versões, trabalhar em branches, tornar um Agente público e transformá-lo em template Toda alteração que você salva em um Agente é uma versão. As versões que você continua editando formam a branch `main`, que o painel **Teste seu agente** executa. **Publicar** marca uma versão como aquela que a API, os Workflows, os agendamentos e as tarefas executam. Nada chega à produção até você publicar, então você pode construir e testar à vontade. ## Versões Cada salvamento do Objetivo, cada mudança em Entradas, Saídas, skills, subagents, arquivos, integrações ou modelo cria uma nova versão. A versão atual aparece no menu de **Publicar** como `VER-` seguido de um identificador curto. Clique no botão **Histórico de Versões** (o ícone de relógio no cabeçalho) para ver todas. Cada entrada mostra quem fez a alteração (**Autor**), quando (**Última edição**), um **Resumo das alterações** e o **ID da versão**, que você pode copiar. A versão que você está editando é marcada como **Atual** e a publicada como **Publicado**. Clique em **Carregar mais** para versões mais antigas. ![Diálogo Histórico de Versões com as marcas Atual e Publicado](https://mintcdn.com/meistrari/IBJhAp-onVS37l80/images/pt/agent/version-history.png?fit=max\&auto=format\&n=IBJhAp-onVS37l80\&q=85\&s=121ed6e0e10b1787c2d8b03b93241341) ### Visualizando e restaurando uma versão Clique em **Visualizar** em uma versão para abri-la em modo somente leitura. Um aviso mostra **Visualizando versão** com o identificador curto e lembra que *este é um preview somente leitura; restaure para editar*. O editor, os esquemas e as integrações não podem ser alterados durante o preview. Clique em **Sair do Preview** ou **Voltar ao atual** para retornar. Clique em **Restaurar esta versão** para torná-la a sua versão atual. Restaurar copia aquela versão por cima do seu rascunho, para frente ou para trás no tempo, então tudo o que você adicionou desde então, inclusive entradas e atributos de saída, desaparece do rascunho. A produção continua executando a versão publicada até você publicar de novo. > [!WARNING] > > Restaurar não é desfazer. Se você restaurar uma versão antiga e depois quiser o trabalho de hoje de volta, encontre-o no **Histórico de Versões** e restaure-o de novo. ## Publicando Clique em **Publicar** no cabeçalho. A publicação é imediata, sem escolha de ambiente ou versão nem confirmação: é publicada a versão que você está visualizando ao clicar, ou a atual, se você não estiver em um preview do histórico. Um aviso **Versão publicada com sucesso** confirma, e o botão passa a mostrar **Publicado** enquanto você olha a versão publicada. A seta ao lado do botão abre um resumo: **Publicado** com quando e por quem (ou **Ainda não publicado**), o identificador `VER-`, o selo **Publicado** ou **Não publicado**, um card **Conectar via API** cujo botão **Detalhes** abre o diálogo da API depois que uma versão é publicada, e um botão **Publicar**. ![Menu de Publicar com o status de publicação, o identificador da versão e o card Conectar via API](https://mintcdn.com/meistrari/IBJhAp-onVS37l80/images/pt/agent/publish-menu.png?fit=max\&auto=format\&n=IBJhAp-onVS37l80\&q=85\&s=4b247421af57913eeef94f73e3fb2c5b) Onde a versão publicada é usada: * Chamadas via **Conectar via API** (veja [Executando um Agente e obtendo resultados](https://docs.tela.com/pt/agent/running-and-results.md#pela-api)) * Agendamentos: eles sempre executam a versão publicada, então publicar muda o que cada agendamento existente do Agente executa em seguida * Tarefas criadas para o Agente * **Tornar público**, que exige uma versão publicada O painel **Teste seu agente** e os casos de teste continuam executando as suas alterações atuais, então você pode seguir trabalhando na próxima versão enquanto a produção executa a publicada. > [!NOTE] > > **Para desenvolvedores.** Publicar registra um hash de commit como a versão publicada. Não há ambientes para Agentes: uma versão publicada por Agente. Para publicar uma versão mais antiga, abra-a no **Histórico de Versões** e clique em **Publicar** durante o preview. ## Branches Por padrão você trabalha na `main`. O seletor de branch no cabeçalho permite criar uma **Nova branch** a partir da atual, alternar entre branches e excluir as de que não precisa mais. Use uma branch para experimentar outro Objetivo ou modelo sem mexer na `main`; o painel de teste executa a branch que você selecionou, e a URL guarda um parâmetro `?branch=` que você pode compartilhar. Em qualquer branch que não seja a `main`, o botão **Publicar** é substituído por **Mergear**. O merge abre uma comparação com a `main`; quando não há conflitos, confirme para levar as alterações para a `main` e então publique a partir dela. Se a branch tiver conflitos com a `main`, resolva localmente com a Tela CLI e dê push; o merge fica disponível assim que o conflito é resolvido. ## Trabalhando localmente com a Tela CLI O ícone de terminal no cabeçalho abre **Trabalhe localmente com a Tela CLI**, para quem prefere editar os arquivos do Agente na própria máquina: 1. **Instalar o Tela Dock** no seu computador 2. **Instalar e configurar a Tela CLI** seguindo as instruções do Tela Dock 3. **Sincronize e envie seu agente**: `tela agent sync ` traz o Agente para o seu ambiente local, `tela agent push` faz o commit e sincroniza as suas alterações locais de volta para o Tela > [!NOTE] > > **Para desenvolvedores.** O Agente é um repositório git; o diálogo mostra o endereço dele. Alterações enviadas pela CLI aparecem no **Histórico de Versões** como as feitas na interface. Arquivos gerenciados, como `CLAUDE.md`, `agent.config.json` e `output-format.json`, são mantidos pelo Tela; edite o Objetivo, as Entradas, as Saídas e o modelo pela interface ou pela API, e não à mão. ## Compartilhando o Agente **Compartilhar link** (o ícone de link no cabeçalho) copia um link para a página do Agente para colegas do seu Workspace. **Tornar público** vai além: permite que qualquer Workspace do Tela execute a versão publicada. Abra o menu `…` ao lado do título e escolha **Tornar público** (a mesma entrada passa a se chamar **Gerenciar acesso global** depois de configurada). O diálogo explica o que muda: *Todos os workspaces da Tela poderão executar este agente e consultar as informações de leitura permitidas do seu repositório. A edição e a publicação continuam restritas ao workspace proprietário.* Confirme com **Tornar público**. O cabeçalho então mostra **Disponível para todos os workspaces**, e o mesmo diálogo oferece **Remover acesso global**; execuções em andamento não são canceladas quando você remove. Tornar um Agente público exige uma versão publicada e a permissão para gerenciar o acesso global. ## Templates Administradores podem transformar um Agente em ponto de partida para novos Agentes. No menu `…`, **Tornar template do workspace** o registra como template do seu Workspace: ele aparece no diálogo **Novo agent** para todos no Workspace, na lista do harness que ele usa. **Remover dos templates** desfaz a ação. **Tornar template global** é reservado ao time do Tela. Agentes criados a partir de um template recebem um botão **Atualizar template** quando o template muda; veja [O que sobrevive a uma atualização de template](https://docs.tela.com/pt/agent/skills-subagents-and-files.md#o-que-sobrevive-a-uma-atualizacao-de-template). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.