> 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çando 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 realizar. Consulte este guia para começar: {% embed url="" %} ## O que é a mensagem do sistema? A mensagem do sistema define a persona da IA, o objetivo e tarefas ou regras específicas. *Nota: esta definição varia de utilizador para utilizador e de prompt para prompt. Muitas instruções na mensagem do Sistema podem degradar o resultado — por isso, sinta-se à vontade para experimentar adicionando as instruções no prompt do Utilizador!* ``` Exemplo de Mensagem do Sistema: Você é um poeta renomado. Você escreve poemas no tom e estilo do Dr. Seuss. Inclua apenas temas apropriados para crianças. ``` ## Como decido o que entra na mensagem do Sistema? Não existem regras rígidas sobre o que incluir no prompt de sistema. No entanto, geralmente recomendamos 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 "Utilizador" e a resposta do ChatGPT é a resposta "Assistente". {% hint style="info" %} Usar tanto o Utilizador como o Assistente permite 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 um prompt com um par Utilizador-Assistente 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 resposta desejada: 1. Adicione um exemplo **Utilizador** mensagem 2. Adicione o esperado **Assistente** resposta 3. *(opcionalmente) Adicione mais pares utilizador-assistente* 4. Adicione outra **Utilizador** mensagem com a sua entrada Para um guia detalhado, consulte o nosso tutorial sobre Prompting K-Shot: {% embed url="" %} ### Exemplo de Extração de Texto > **Sistema:** A sua tarefa é extrair o ID único da transcrição a partir do final da URL. > > **Utilizador:** > > **Assistente:** DkMo5PetdLeCDglp > > **Utilizador:** > > **Assistente:** Mdei9OrqpQlWIijd > > **Utilizador:** {{link\_to\_sales\_call}} ### Por que usar mais de um par Utilizador-Assistente? Usar mais de um exemplo é útil para lógica com nuances. No nosso exemplo de extração de texto, fornecemos duas URLs com formatos diferentes para ajudar o modelo a entender como extrair texto em vários cenários. {% hint style="success" %} **Use um exemplo da vida real:** A melhor forma de gerar resultados de alta qualidade é fornecer um exemplo de alta qualidade ao modelo. Use o exemplo mais realista possível, seja da internet ou dos seus próprios dados. {% endhint %} ## Como posso usar LLMs com capacidades de visão no AirOps? Alguns LLMs, como o GPT-4o, têm capacidades de visão. Para usar essas capacidades de visão no AirOps, precisa fornecer ao modelo um link de uma imagem descarregável: ### Como Configurar a Etapa LLM 1. Adicione um **LLM** etapa ao seu fluxo de trabalho 2. Altere o modelo para **GPT-4o** 3. Adicione um **URL da imagem** na mensagem do Utilizador onde diz "Adicionar um URL de imagem" ### Como passar uma imagem de um Carregamento do Utilizador 1. Para carregar uma única imagem do seu ambiente de trabalho, altere o tipo de entrada para **Mídia de ficheiro** que aceita um ficheiro .jpg, .png ou .webp 2. O AirOps devolverá um URL descarregá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 descarregá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 o resultado 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="" %} --- # 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=&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.