> 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

A versionação permite-lhe gerir facilmente instâncias históricas, rascunhos e versões predefinidas publicadas dos seus Workflows.

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

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

## Como é que crio 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-7e953d5aed2f203c0c5c53b2dcff27ae4833904e%2FCleanShot%202025-02-27%20at%2006.22.09%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

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

### Nomes e Descrições de Versão Personalizados

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

1. Clique em **Publicar Workflow**
2. Introduza um **Nome da Versão** (por exemplo, "Adicionado passo de otimização 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 porquê foi criada, especialmente ao rever o histórico de versões ou ao reverter alterações.

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

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

## Utilizar Versões Anteriores

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

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-06e8e76365aae555cae2a00fc2a6c9db271d2a82%2FCleanShot%202025-02-27%20at%2006.23.01%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
O seu rascunho NÃO será substituído ao clicar simplesmente 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 pretendida 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-d36146dd3eb58e30245b76c2d443038ac4fc4c20%2FCleanShot%202025-02-27%20at%2006.24.22%402x.png?alt=media" alt=""><figcaption></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 Predefinida

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

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-b5e218367f554367354b1f4c60488d3d70264f97%2FCleanShot%202025-02-27%20at%2006.25.53%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

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

## 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 isto, navegue de volta para a janela de visualização do seu Workflow e clique no **"Integrar"** separador no topo:

O comando POST geral executará sempre a Versão Predefinida, enquanto o endpoint de Versionamento permite especificar a versão pretendida a 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.
