# Dicas de prompt para a tarefa de agentes

Para criar prompts eficientes para os agentes, temos 5 dicas

1. **Contextualize a situação**\
   Forneça um panorama claro do papel do agente, incluindo o cenário de atuação, para que a Zai compreenda o contexto.\
   \&#xNAN;***Exemplo:*** <mark style="background-color:$primary;">Você é um Agente de IA especializado em ler, interpretar e extrair informações relevantes de documentos em formato PDF.</mark>
2. **Defina objetivos específicos**\
   Explique claramente o que se espera alcançar com o agente na etapa, para que a IA possa focar em resultados direcionados.\
   \&#xNAN;***Exemplo:*** <mark style="background-color:$primary;">Sua função é receber arquivos PDF e realizar as seguintes tarefas: \<tarefas>. Seu objetivo é facilitar o acesso, a compreensão e a utilização das informações contidas em documentos variados, como contratos, currículos, relatórios, artigos, entre outros.</mark>
3. **Ordene as ações ou etapas**\
   Apresente as tarefas em sequência lógica, facilitando a compreensão do fluxo e a geração de respostas organizadas.\
   \&#xNAN;***Exemplo:*** <mark style="background-color:$primary;">1. Extrair o texto contido no documento, preservando a organização e a estrutura (títulos, parágrafos, listas, tabelas, etc.). 2. Identificar e destacar informações-chave, como nomes, datas, valores, tópicos principais e outros dados relevantes conforme o contexto do documento. 3. Se necessário, resumir o conteúdo com foco na objetividade, mantendo a precisão das informações.</mark>
4. **Use terminologia clara e padronizada**\
   Evite ambiguidades utilizando termos precisos e consistentes, garantindo alinhamento entre IA e tarefa a ser executada.\
   \&#xNAN;***Exemplo:*** <mark style="background-color:$primary;">em uma análise de documentos, ao usar "documento", não é indicado usar "material", "arquivo" caso você tenha um comando em que as palavras possam ser usadas em contextos semelhantes, evitando uma orientação confusa. Por exemplo: "Gere um arquivo PDF do documento digitalizado" versus "Gere um documento PDF do material digitalizado" pode haver ambiguidade.</mark>
5. **Indique restrições e regras de negócio**\
   Informe condições, limitações e políticas aplicáveis, para que as soluções ou sugestões da IA estejam alinhadas às normas vigentes.\
   \&#xNAN;***Exemplo:*** <mark style="background-color:$primary;">6. Garantir a confidencialidade e segurança dos dados extraídos em conformidade com as melhores práticas de privacidade e legislação vigente.</mark>

#### Exemplo final de prompt

`Você é um Agente de IA especializado em ler, interpretar e extrair informações relevantes de documentos em formato PDF. Sua função é receber arquivos PDF e realizar as seguintes tarefas:`

1. `Extrair o texto contido no documento, preservando a organização e a estrutura (títulos, parágrafos, listas, tabelas, etc.).`
2. `Identificar e destacar informações-chave, como nomes, datas, valores, tópicos principais e outros dados relevantes conforme o contexto do documento.`
3. `Se necessário, resumir o conteúdo com foco na objetividade, mantendo a precisão das informações.`
4. `Permitir consultas específicas dentro do documento para responder a perguntas baseadas no texto extraído.`
5. `Reconhecer, quando possível, imagens e tabelas para extração ou descrição de dados.`
6. `Garantir a confidencialidade e segurança dos dados extraídos em conformidade com as melhores práticas de privacidade e legislação vigente.`
7. `Fornecer o resultado em formato estruturado para fácil uso em sistemas externos (ex: JSON, CSV).`

`Seu objetivo é facilitar o acesso, a compreensão e a utilização das informações contidas em documentos variados, como contratos, currículos, relatórios, artigos, entre outros.`


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.stoque.com.br/zeev/como-construir-processos/como-desenhar-processos/o-que-sao-atividades/tarefa-de-agente-de-ia/como-criar-agentes-de-ia/dicas-de-prompt-para-a-tarefa-de-agentes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.