> 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/getting-started/building-your-first-workflow.md).

# Criar o seu primeiro Workflow

Crie um Workflow de pesquisa para informar a estratégia de conteúdo próprio da sua marca.

Crie um processo de pesquisa repetível para apoiar a sua estratégia de descoberta de IA. Este tutorial usa resultados da pesquisa Google para informar decisões de conteúdo próprio e apresenta os Steps que pode combinar em AirOps Workflows.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-325ceaff6e1464cb2c8ccc389bcb866dd73b7534%2Ffirst-workflow-01-serp-researcher.png?alt=media" alt="Keyword SERP Researcher Workflow in Studio with Google Search and Prompt LLM steps, and the Logs tab of a test run showing the search intent and themes for satellite fleet monitoring software"><figcaption><p>O Workflow de Pesquisa de SERP por Palavra-chave concluído, com uma execução de teste aberta no separador Registos.</p></figcaption></figure>

## A criar o seu primeiro Workflow: Pesquisa de SERP por Palavra-chave

Neste tutorial, vamos guiá-lo na criação do seu primeiro AirOps Workflow — um Pesquisador de SERP por Palavra-chave que analisa os resultados da pesquisa Google para as suas palavras-chave-alvo.

## Tutorial interativo

{% @arcade/embed url="<https://app.arcade.software/share/emHfbSG0PcdSrIcWVTGN>" flowId="emHfbSG0PcdSrIcWVTGN" %}

## Guia passo a passo

### Criar o Workflow

#### Passo 1: Criar um Novo Workflow

1. No ecrã inicial, clique no botão "Criar" no canto superior direito
2. Selecione "Fluxo de trabalho" no menu pendente
3. Será encaminhado para o AirOps Workflow Studio, onde irá construir o seu fluxo de trabalho

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-4e0ddda204abcb6ec20c31cccb641525720b5a15%2Ffirst-workflow-02-create-menu.png?alt=media" alt="Get Started dialog with Start with a Template, Start with a Grid, Start with a Workflow, and Start with a Playbook"><figcaption><p>Escolha Começar com um Workflow.</p></figcaption></figure>

#### Passo 2: Configurar a Entrada do seu Workflow

1. No Workflow Studio, verá um nó com a designação "Definir entradas" na parte superior do seu workflow
2. Clique neste nó para configurar o seu campo de entrada
3. Clique em "Adicionar campo ao grupo" ou numa opção semelhante
4. Selecione "Texto curto" como tipo de entrada
5. Rotule o campo "keyword" — este será o termo de pesquisa que pretende analisar
6. Certifique-se de que o nome da variável também é "keyword" (isto acontece automaticamente)
7. Ative "Obrigatório" para garantir que é sempre fornecida uma palavra-chave
8. Guarde a sua configuração

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-62953113fbd5547d105852d208d36e457f84a1e6%2Ffirst-workflow-03-set-inputs.png?alt=media" alt="Input Settings step selected on the Workflow canvas, with the Inputs panel listing the keyword input and an Add Field button"><figcaption><p>Defina as entradas do Workflow nas Definições de entrada.</p></figcaption></figure>

### Configurar o Passo de Pesquisa Google

#### Passo 1: Adicionar um Passo de Pesquisa Google

1. Terá de adicionar um passo de Pesquisa Google após as suas entradas
2. Procure o botão "+" ou a opção "Adicionar passo" abaixo do seu nó de entrada
3. Navegue pelas categorias e selecione a categoria "Pesquisa na Web"
4. Escolha "Pesquisa Google" entre os passos disponíveis
5. Isto adicionará um passo de Pesquisa Google ao seu workflow, semelhante ao mostrado na Imagem 2

#### Passo 2: Configurar o Passo de Pesquisa Google

1. Clique no passo de Pesquisa Google
2. No campo "Consulta de pesquisa", clique no explorador de variáveis (ícone rosa no canto superior direito do campo de entrada) e escolha `{{ keyword }}`
3. Deixe o campo "Parâmetros de pesquisa" vazio por agora
4. Guarde a sua configuração

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1b71897698f3c6ecc856761a5d577fe9b116d9de%2Ffirst-workflow-04-add-step.png?alt=media" alt="Steps panel listing AI, Web Research, and Code steps, including Google Search, beside the Workflow canvas"><figcaption><p>Adicione o passo de Pesquisa Google a partir do painel de Steps.</p></figcaption></figure>

### Criar o Passo de Análise LLM

#### Passo 1: Adicionar um Passo Prompt LLM

1. Após o seu passo de Pesquisa Google, adicione outro passo
2. Escolha "Prompt LLM" (Modelo de Linguagem de Grande Porte) entre os passos disponíveis
3. Isto adicionará um passo LLM após o seu passo de Pesquisa Google

#### Passo 2: Configurar o Modelo LLM

1. Clique no passo LLM
2. Estamos a usar "GPT-4o" como modelo neste exemplo
3. Pode deixar as restantes definições com os valores predefinidos por agora

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-d17aaffd03924fa6911c1b3c1b12dc45609bfa0d%2Ffirst-workflow-05-llm-step.png?alt=media" alt="Workflow canvas with the Prompt LLM step labelled LLM · GPT-6.1 Sol"><figcaption><p>O passo Prompt LLM mostra o seu modelo na tela.</p></figcaption></figure>

#### Passo 3: Elabore o seu Prompt LLM

1. No painel do passo LLM, introduza o seguinte prompt no campo de entrada que diz "User" à esquerda:

{% code overflow="wrap" %}

```
A sua tarefa é analisar os temas e as melhores práticas dos resultados de pesquisa Google com melhor desempenho para uma determinada palavra-chave. Esta análise ajudará a perceber o que torna estas páginas bem-sucedidas e fornecerá insights para a criação de conteúdo.

A palavra-chave para análise é:
{{ keyword }}

Aqui estão os resultados de melhor desempenho do Google para esta palavra-chave:
{{ step_1.output }}

Para concluir esta tarefa, siga estes passos:

1. Leia cuidadosamente todos os resultados de melhor desempenho.

2. Analise os temas:
   a. Identifique tópicos ou assuntos comuns abordados em vários resultados.
   b. Registe quaisquer ângulos ou perspetivas únicas sobre o tema principal.
   c. Observe a profundidade e a abrangência da informação coberta.

3. Identifique as melhores práticas:
   a. Examine a estrutura do conteúdo (títulos, subtítulos, listas, etc.).
   b. Avalie a utilização de media (imagens, vídeos, infografias, etc.).
   c. Avalie o estilo de escrita e o tom.
   d. Procure padrões no comprimento do conteúdo e no nível de detalhe.
   e. Registe quaisquer recursos externos ou referências comuns utilizados.
   f. Observe como o conteúdo aborda a intenção do utilizador.

4. Apresente a sua análise no seguinte formato:

# Análise
## Temas
[Liste e descreva brevemente 3-5 temas principais que identificou]


## Melhores Práticas
[Liste e explique 5-7 melhores práticas que observou]

## Recomendações
[Forneça 3-5 recomendações acionáveis para criar conteúdo com base na sua análise]

Lembre-se de ser exaustivo na sua análise e objetivo nas suas observações. Foque-se nos padrões e práticas que parecem contribuir para o sucesso destas páginas com melhor desempenho. As suas perspetivas devem ser valiosas para qualquer pessoa que queira criar conteúdo de alta qualidade sobre este tema.
```

{% endcode %}

2. Repare em como este prompt refere tanto a entrada da palavra-chave (`{{ keyword }}`) como a saída do passo anterior de Pesquisa Google (`{{ step_1.output }}`)

### Testar e Publicar o seu Workflow

#### Passo 1: Testar o seu Workflow

1. Clique em "Testar Workflow" no canto superior direito da barra de navegação do Studio (com o ícone de reprodução ao lado)
2. Introduza uma palavra-chave de teste (por exemplo, "dicas de marketing de conteúdo" ou "melhores sapatilhas de corrida")
3. Clique em "Testar Workflow" para executar o seu workflow
4. Revise os resultados para garantir que ambos os passos estão a funcionar corretamente

#### Passo 2: Publicar o seu Workflow

1. Quando estiver satisfeito com os resultados, procure o botão "Publicar" no canto superior direito do Studio
2. Dê ao seu workflow um nome descritivo como "Pesquisador de SERP por Palavra-chave"
3. Adicione uma breve descrição do que o workflow faz
4. Publique o seu workflow para o disponibilizar para execução

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-13a50703feb083ee872a66ef96601881bac66d3f%2Ffirst-workflow-06-test-publish.png?alt=media" alt="Workflow Studio header with the Test Data tooltip on the play button next to Publish"><figcaption><p>Teste o Workflow com o botão de reprodução e, em seguida, publique-o.</p></figcaption></figure>

### Conseguiu :tada:

O seu Pesquisador de SERP por Palavra-chave transforma os resultados da pesquisa Google em análise que pode usar para informar a estratégia de conteúdo próprio da sua marca.

À medida que o seu programa cresce, pode adicionar Steps, incorporar revisão humana ou ligar este Workflow a outros Workflows que executem as prioridades da sua equipa.


---

# 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/getting-started/building-your-first-workflow.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.
