> 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/workflow-steps/ai-steps/llm/prompt-with-gpt.md).

# Guia de Prompting

Como fazer prompting com GPT

## Começar a gerar prompts com IA

A **Gerar com IA** a funcionalidade permite aos utilizadores estruturar um prompt com linguagem natural.

Basta clicar **Gerar com IA**, escolher o tipo da sua tarefa e descrever o que pretende alcançar. Consulte este guia para começar:

{% embed url="<https://www.youtube.com/watch?v=FI2T6SzuOlw>" %}

## O que é a mensagem do sistema?

A mensagem do sistema define a persona, o objetivo e as tarefas ou regras específicas da IA.

*Nota: esta definição varia de utilizador para utilizador e de prompt para prompt. Demasiadas instruções na mensagem do sistema podem degradar a saída - por isso, sinta-se à vontade para experimentar adicionando as instruções no prompt do utilizador!*

```
Exemplo de mensagem do sistema: 
És um poeta renomado. 
Escreves poemas no tom e estilo do Dr. Seuss.
Inclui apenas temas apropriados para crianças.
```

## Como decido o que incluir na mensagem do sistema?

Não existem regras rígidas sobre o que incluir no prompt do sistema. No entanto, recomendamos geralmente incluir tarefas específicas e bem definidas, evitando lógica extremamente complexa.

## O que são as mensagens do Utilizador e do Assistente?

O utilizador e o assistente definem a conversa entre si (o utilizador) e a IA (o assistente).

Por exemplo, numa conversa entre si e o chatGPT: a sua mensagem é a mensagem de "Utilizador" e a resposta do chatGPT é a resposta do "Assistente".

{% hint style="info" %}
Usar tanto o Utilizador como o Assistente permite-lhe fornecer exemplos que ajudam o modelo a "aprender" o formato de saída desejado (JSON, HTML, etc.) e a linguagem
{% endhint %}

## Como faço prompts com o Utilizador e o Assistente?

### Como Fazer Prompts com um Par Utilizador-Assistente

Os pares Utilizador-Assistente (também conhecidos como prompting one-shot ou few-shot) são exemplos que fornecemos ao modelo para o ajudar a "aprender" a nossa resposta desejada:

1. Adicione um exemplo **Usuário** mensagem
2. Adicione a resposta **Assistente** resposta
3. *(opcionalmente) Adicione mais pares utilizador-assistente*
4. Adicione outra **Usuário** mensagem com a sua entrada

Para um guia detalhado, consulte o nosso tutorial sobre Prompting K-Shot:

{% embed url="<https://www.youtube.com/watch?v=NBpAPwl4Yx0>" %}

### Exemplo de Extração de Texto

> **Sistema:** A sua tarefa é extrair o ID único da transcrição do final do URL.
>
> **Utilizador:** <https://app.fireflies.ai/view/AirOps-Intro::DkMo5PetdLeCDglp>
>
> **Assistente:** DkMo5PetdLeCDglp
>
> **Utilizador:** <https://app.fireflies.ai/view/Mdei9OrqpQlWIijd>
>
> **Assistente:** Mdei9OrqpQlWIijd
>
> **Utilizador:** {{link\_to\_sales\_call}}

### Por que usar mais do que um par Utilizador-Assistente?

Usar mais do que um exemplo é útil para lógica diferenciada.

No nosso exemplo de extração de texto, fornecemos dois URLs com formatos diferentes para ajudar o modelo a বুঝnder como extrair texto em múltiplos cenários.

{% hint style="success" %}
**Use um exemplo da vida real:** A melhor forma de gerar resultados de alta qualidade é fornecer ao modelo um exemplo de alta qualidade. Use o exemplo mais realista possível, sempre que possível, seja da internet ou dos seus próprios dados.
{% endhint %}

## Como é que uso LLMs com capacidades de visão no AirOps?

Alguns LLMs, como o GPT-4o, têm capacidades de visão. Para usar estas capacidades de visão no AirOps, precisa de fornecer ao modelo um link de uma imagem transferível:

### Como Configurar a Etapa de LLM

1. Adicione uma **LLM** etapa para o seu fluxo de trabalho
2. Altere o modelo para **GPT-4o**
3. Adicione uma **URL da imagem** na mensagem do Utilizador onde diz "Adicionar um URL de imagem"

### Como passar uma imagem de um Upload do Utilizador

1. Para carregar uma única imagem a partir do seu ambiente de trabalho, altere o tipo de entrada para **Media de Ficheiros** que aceita um ficheiro .jpg, .png ou .webp
2. O AirOps devolverá um URL transferível para esta imagem
3. Passe a entrada como sintaxe liquid para o GPT-4o onde diz "Adicionar um URL de imagem"

### Como passar uma imagem do Google Drive

1. Para carregar uma imagem do Google Drive, escolha **Texto Curto** como tipo de entrada
2. Altere a imagem do Google Drive para que qualquer pessoa com o link a possa ver
3. Adicione uma etapa de código para transformar o link do Google Drive num URL transferível, substituindo `short_text_input` pelo nome da sua entrada:
   * ```
     const fileID = short_text_input.match(/[-\\w]{25,}/);

     return `https://drive.google.com/uc?export=download&id=${fileID[0]}&confirm=t`
     ```
4. Passe a saída da etapa anterior para o GPT-4o onde diz "Adicionar um URL de imagem"

Para um guia mais detalhado sobre o GPT-4o, consulte o nosso tutorial aqui:

{% embed url="<https://www.youtube.com/watch?v=BCoZhI4Gem8>" %}


---

# 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/workflow-steps/ai-steps/llm/prompt-with-gpt.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.
