IA PROMPT - exemplos e dicas

 PROMPT ->  COMPLETION

No mundo das IAs, a resposta é conhecida como completion - completação, ou seja, o texto retornado é o complemento lógico-probabilistico gerado a partir de uma situação inicial, que, neste caso, é a pergunta ou prompt.

No ecossistema de IA, temos três elementos interdependentes:

- Prompts: instruções fornecidas à IA para gerar respostas imediatas. Não têm memória nem executam ações por si só, mas servem de ponto de partida. Podem acionar diretamente skills simples ou instruir agentes. Podem rodar no browser a execução é mais limitada, ou num computador local/servidor há mais controle e acesso a recursos do sistema. A integração pode ser feita com Python scripts, JavaScript, APIs REST ou Node.js.  

- Skills: funções especializadas que ampliam a capacidade da IA, como consultar bancos de dados, calcular resultados ou acessar serviços externos. Podem ser ativadas por prompts ou usadas dentro de agentes. Podem rodar localmente o que permite integração com sistemas internos, enquanto via browser/servidor dependem de permissões e APIs expostas. A integração pode ser feita com Python (cálculos e processamento de dados), Node.js / JavaScript (web e APIs), SQL (bancos de dados), APIs externas (Google, OpenWeather etc.).

- Agentes: sistemas autônomos que planejam, decidem e executam tarefas em múltiplas etapas. Utilizam prompts para definir ações e skills como ferramentas, podendo se integrar a programas ou sistemas externos para realizar tarefas complexas. Agentes rodando em computadores locais ou servidores têm acesso direto aos arquivos, enquanto agentes no browser/servidor dependem de APIs e permissões para interagir com recursos externos. A integração pode ser feita com scripts em Python, Node.js, JavaScript, chamadas de APIs externas, automação em shell scripts, frameworks de workflow (Airflow, etc.).  
  

As perguntas (prompt) podem ser desde as mais simples a mais sofisticadas. Em negrito a estrutura básica de um prompt, ou seja, esses 5 pontos conferem uma estrutura mínima para a IA gerar uma boa resposta (completion)! Certamente que quanto mais complexo o tema, mais interações serão necessárias.
         
 Perfil a IA pode assumir vários papéis: defina quem ela será e para quem irá elaborar a resposta. Em outras palavras, determine o cenário em que irá atuar ... ou qual o perfil do melhor profissional para resolver este meu problema?!
 Fontes a IA pode consultar muitas fontes: ao consultar jornais ela gera uma resposta diferente de quando consulta artigos científicos.
   
 Restrições a IA sempre irá gerar uma resposta: ao restringir o que ela não pode fazer, você a auxilia a evitar respostas erradas ou alucinações. 
 Formato a IA pode gerar diferentes formatos de respostas, textos, tabelas, listas, poemas, textos juridicos, limitações orçamentárias, textos médicos ou um simples "ok", bem como um tom mais formal, informal, gíria etc. ... você define o que deseja.
 Tarefa  a IA pode tomar diferentes caminhos na elaboração da resposta (completion) e a objetividade na solicitação determina como a tarefa será a realizada. 

Produto
prompt 1: Diga o nome de um produto doméstico comum.
completion 1: Cafeteira

prompt 2: Diga o nome de um produto doméstico comum que **facilita a preparação de bebidas quentes**.
completion 2: Cafeteira elétrica

prompt 3: Diga o nome de um produto doméstico comum que facilita a preparação de bebidas quentes e **explique uma vantagem de usá-lo**.
completion 3: Cafeteira elétrica – permite preparar café rapidamente e a função de desligamento automático mantêm a bebida quente.

Texto livre
prompt 1: Escreva uma frase sobre um gato.
completion 1: O gato dormia no sofá durante a tarde.

prompt 2: Escreva uma frase sobre um gato que vive uma pequena aventura no jardim.
completion 2: O gato saltou sobre as flores e se escondeu atrás do arbusto, observando os pássaros no jardim.

prompt 3: Escreva duas frases sobre um gato que vive uma pequena aventura no jardim e descreva **como ele se sente**.
completion 3: O gato saltou sobre as flores e se escondeu atrás do arbusto, observando os pássaros no jardim. Ele sentia-se curioso e animado, explorando cada canto como se fosse um mundo novo.

• Use linguagem clara e direta e evite termos vagos como "coisa" ou "negócio"
• Use linhas separadas para cada instrução
• Use frases afirmativas e evite as negativas, ex:
      "faça uma lista simples com os nomes dos países da Europa"
• Solicite nível de evidência nos temas médicos, ex.: Oxford 1a–2a, veja no final desse texto!
• Delimite com crases os trechos literais, como citações de artigos, códigos ou comandos, veja crases abaixo.
• Deixe claro se deseja uma resposta elaborada ou curta, ex: responda somente **OK** e, também o estilo se uma explicação, poema, texto literário, tabela, marcadores (bullets), lista etc.
• Pode solicitar que evite a repetição de informações.
• Se deseja as fontes e referências em formato padronizado (ABNT, APA etc.)

1. Use cerquilhas: # títulos, ## subtítulos, ### subsubtítulos
2. Use crases triplas ``` para blocos de código ou trechos literais longos```
3. Use crases simples ` palavras literais `
4. Use dois asteriscos ** para destacar ** as palavras - equivale ao negrito
5. Use hífen - ou asterisco * para criar listas simples
6. Use três traços --- para separar as seções ou tópicos ---

1. Perguntas vagas ou ambíguas
   • Ex.: “Me fale sobre coisa de saúde.”
   • Problema: a IA irá retornar com a primeira coisa que aparecer


2. Misturar múltiplas instruções em uma única linha
   • Ex.: “Faça um resumo, gere tabela, explique passo a passo e cite fontes.”
   • Problema: a IA irá priorizar parte da instrução, o que irá gerar uma resposta confusa


3. Não indicar claramente o tipo de resposta desejada
   • Ex.: “Me explique poluição.”
   • Problema: a IA não se sabe se você deseja uma definição de dicionário ou uma explicação técnica ou uma notícia recente, ela retornará a primeira explicação que aparecer em seus registros.


4. Uso incorreto ou inconsistente de trechos literais de texto ou códigos
   • Não escreva comandos, códigos, equações e citações com os dados misturados com texto normal sem as crases de delimitação.
     Abaixo um exemplo de um código corretamente posicionado entre crases triplas:
     
       ```   #include <math.h>
       do { sin = i * cos(j) ; ++i ; }
       while( i < 2400 ) ; ```
   
   
   • Problema: sem as crases a IA irá interpretar como texto comum e a resposta será comprometida. Pode usar outros delimitadores? Sim, pode, desde que não apareçam no texto inserido! Entretanto, as crases já são um caminho conhecido para as IAs. A simbologia do markdown é muito difundida como interface homem-maquina.


5. Instruções conflitantes ou redundantes
   • Ex.: “IA elabore uma resposta detalha e concisa”
   • Problema: a IA tentará conciliar comandos opostos, e irá gerar uma resposta confusa.