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.

Elementos interdependentes no ecossistema das IAs:

- 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 rodar no browser a execução é mais limitada, ou num computador local/servidor via programas que permitem acesso a recursos específicos do usuário. Os prompts são textos simples e em projetos maiores eles são integraveis às skills e aos agentes.  

- Skills: funções especializadas que ampliam a capacidade da IA, como consultar bancos de dados, ler textos em pdf, 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 programas de interface (API). As skills podem ser "listas" com configurações, senhas, urls estruturados em  json, yaml, markdown, xml... ou até programas complexos, elaborados em linguagens como Python, Go, Node.js, JavaScript, SQL etc.

- Agentes: sistemas autônomos que planejam, decidem e executam tarefas em múltiplas etapas - algo como um gerente de skills. Utilizam prompts para definir as tarefas e ações e as skills como "ferramentas". Em tarefas mais complexas os agentes podem se integrar programas ou sistemas externos. Geralmente os agentes rodando em computadores locais ou servidores têm acesso direto aos arquivos, enquanto nos browsers/servidores dependem de APIs e permissões para interagir com recursos externos. Atualmente os agentes são programados com Python, Go, Java, TypeScript etc.  

- Em resumo: Prompts solicitam as tarefas a IA, a skill ou ao agente. A skill pode fornecer o resultado para o usuário ou para um agente. O agente coordena vários prompts e skills para executar tarefas complexas.

As perguntas (prompt) podem ser desde as mais simples a mais sofisticadas. Esses 5 pontos conferem uma estrutura mínima para a IA gerar uma boa resposta (completion)! Certamente que quanto mais complexo o tema, mais instruções ou interações serão necessárias.
         
 Perfil a IA pode assumir vários papéis: Determine o cenário em que irá atuar, qual seria o perfil do melhor profissional para resolver o problema e o público alvo.
 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. Pedir para citar as fontes ou citar se é uma elaboração dela é uma boa prática.
 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 ... pedir uma tabela ou lista simples já ajuda a compreender por onde ela irá caminhar e ajuda a fazer algum ajuste inicial no prompt.
 Tarefa  a IA pode tomar diferentes caminhos na elaboração da resposta (completion) e a objetividade na solicitação determina a qualidade da tarefa a ser realizada. Evite solicitações antagônicas como "detalhe resumidamente"! 

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.

prompt 4: ## perfil: Como historiador preparando um palestra para engenheiros de produto e analistas de marketing sobre produtos de uso doméstico. ## tarefa: Analise a evolução das principais invenções de produtos domésticos, de qualquer categoria, que marcaram os avanços da indústria de bens de consumo, a partir de 1900 até dias atuais. ## fontes: Utilize textos acadêmicos de universidades renomadas e não use jornais ou blogs. ## formato: Gere duas tabelas: 1- com as datas, produto e impacto na engenharia/marketing . 2- com as tendências do mercado. Ao final comentários e lista das referencias utilizadas. 
completion 4:  podem rodar na tua IA preferida ;) 

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.