> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/acoes/workflow-concepts/publishing-and-versioning.md).

# Publicação e Versionamento

Acompanhe alterações e coloque aplicações em produção com versões

O versionamento permite gerir facilmente instâncias históricas, rascunhos e versões padrão publicadas dos seus Workflows.

## Qual é a diferença entre um rascunho, uma versão e uma versão padrão?

1. **Rascunhos** não são guardados permanentemente, e apenas o rascunho mais recente é salvo.
2. **Versões** por outro lado, são guardadas permanentemente. Podem sempre ser visualizadas e restauradas. Também pode executar versões de Workflows em lote, via API, ou adicioná-las a outro workflow ou agente
3. A **Versão Padrão** é a versão do Workflow que:
   1. Com a qual os utilizadores interagem na interface do AirOps
   2. É executada quando você chama o endpoint POST Execute, a menos que outra versão seja passada como parâmetro

## Como posso criar uma nova versão?

Quando estiver pronto para partilhar, integrar ou executar o seu Workflow, publique-o numa versão permanente clicando em "**Publicar Workflow"** no canto superior direito:

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-17832c0bed6c7a5a9a915860c0fb679863305a17%2Fversioning-01-publish.png?alt=media" alt="Workflow Studio header with the Version 3 dropdown and the Publish button"><figcaption><p>Publique para criar uma nova versão.</p></figcaption></figure>

Isto gera a "Versão 1" do seu Workflow, que agora atua como a Versão Padrão.

### Nomes e descrições personalizados das versões

Ao publicar uma nova versão, pode adicionar um nome e uma descrição personalizados para ajudar a acompanhar alterações relevantes:

1. Clique em **Publicar Workflow**
2. Introduza um **Nome da versão** (por exemplo, "Adicionado passo de otimização de SEO")
3. Adicione uma **Descrição** a explicar o que mudou nesta versão
4. Clique em **Publicar**

Nomes e descrições personalizados facilitam à sua equipa compreender o que cada versão contém e por que foi criada, especialmente ao rever o histórico de versões ou ao reverter alterações.

## O que acontece à minha versão anterior se eu publicar novamente?

Todas as versões publicadas anteriormente são guardadas permanentemente, e uma nova versão torna-se a Versão Padrão.

## Utilizar Versões Anteriores

Para visualizar as versões anteriores do seu Workflow, basta clicar no **"Versões"** menu suspenso e selecionar a versão desejada:

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-7d93cf8c9b25f5b36c8bcb6df9e9a9b4690def81%2Fversioning-02-versions.png?alt=media" alt="Versions dropdown listing named versions, with the default version marked Default"><figcaption><p>Abra versões anteriores a partir do menu suspenso Versões.</p></figcaption></figure>

{% hint style="info" %}
O seu rascunho NÃO será substituído apenas por clicar numa versão anterior.
{% endhint %}

### Restaurar versões anteriores como rascunho

Para restaurar uma versão anterior para o seu rascunho atual, comece por selecionar a versão histórica desejada no menu suspenso e depois clique em **"Restaurar."**

{% hint style="info" %}
O seu rascunho atual SERÁ substituído ao clicar em **"Restaurar,"** por isso certifique-se de que não tem alterações que possam ser perdidas.
{% endhint %}

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-c60a1869a629b97b600719dc55706ae6cdcca425%2Fversioning-03-restore.png?alt=media" alt="Version 1 of a Workflow open in view mode with the Restore button in the header"><figcaption><p>Restaure uma versão mais antiga como rascunho.</p></figcaption></figure>

Isto promove a sua versão histórica para o rascunho atual, que depois pode escolher guardar ou publicar.

### Definir versões anteriores como a Versão Padrão

Para restaurar uma versão anterior para ser a sua Versão Padrão, comece novamente por selecionar a versão histórica desejada no menu suspenso e depois clique em **"Definir como padrão."**

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-dbf21e66afdb37f7878d5b9df21895008604878e%2Fversioning-04-set-default.png?alt=media" alt="Version 1 open in view mode with the Versions dropdown showing Version 3 marked Default, and a Restore button in the header"><figcaption><p>O selo Padrão marca a versão padrão. Para tornar uma versão mais antiga a padrão, restaure-a e publique-a.</p></figcaption></figure>

Quando altera a versão padrão, apenas a versão em produção é alterada. O rascunho mais recente NÃO muda.

## Referenciar versões através da API

Assim que tiver várias versões do seu Workflow, pode especificar qual versão específica executar através da API do AirOps.

Para fazer isso, volte à janela de exibição do seu Workflow e clique no **"Integrar"** separador na parte superior:

O comando POST geral executará sempre a Versão Padrão, enquanto o endpoint de versionamento permite especificar a versão desejada para executar.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/acoes/workflow-concepts/publishing-and-versioning.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
