# Dicas de uso de prompts para a Zai
Dicas de prompts para a criação de aplicativos Para construir bons prompts e obter os melhores resultados, aqui estão as principais dicas: #### **Seja Específico e Estruturado** Em vez de dizer apenas "Quero um processo de compras", tente detalhar as etapas. A Zai entende melhor quando você fornece o contexto. * **Exemplo ruim:** "Crie um processo de reembolso." * **Exemplo bom:** "Crie um processo de reembolso de despesas de viagem onde o funcionário anexa as notas fiscais, o gestor direto aprova e, por fim, o departamento financeiro realiza o pagamento." #### **Defina os Papéis (Atores)** Deixe claro quem participa de cada etapa. Isso ajuda a Zai a sugerir as raias (lanes) do processo corretamente. * *Dica:* Mencione cargos como "Solicitante", "Gestor de RH", "Diretor Financeiro". #### **Liste os Dados Necessários (Campos do Formulário)** Você pode dizer à Zai quais informações precisam ser coletadas no formulário. * **Exemplo:** "...o formulário deve conter nome do fornecedor, CNPJ, valor do serviço e data de vencimento." #### **Use Verbos de Ação** Inicie as descrições das etapas com verbos claros: *Solicitar, Analisar, Aprovar, Corrigir, Pagar, Arquivar*. Isso facilita a identificação de tarefas de usuário pela IA. #### **Regras de Negócio e Desvios** Se o processo tiver condições (o famoso "se"), mencione isso no prompt. * **Exemplo:** "Se o valor for maior que R$ 5.000, o Diretor deve aprovar. Se for menor, segue direto para o Financeiro." #### **"O Caminho do Processo"** Imagine que você está contando uma história do início ao fim. Como começa? O que acontece depois? Quais são as decisões no meio do caminho? Como termina? #### Resumo de um bom prompt: "Crie um processo de **\[Nome do Processo]** que começa com o **\[Papel A]** preenchendo **\[Dados X, Y e Z]**. Depois, o **\[Papel B]** deve **\[Ação]**. Se **\[Condição]**, então **\[Ação Alternativa]**. O processo termina quando o **\[Papel C]** realizar o **\[Ação Final]**."

EXEMPLOS DE PROMPT:

#### **Processo de Solicitação de Compras (Foco em Alçadas e Aprovações)** "Crie um processo de **Solicitação de Compras** que começa com o **Colaborador** preenchendo o nome do item, a quantidade, o valor estimado e o link do fornecedor. O **Gestor Direto** deve analisar a solicitação. Se o valor for superior a R$ 2.000,00, o processo deve ser enviado para aprovação do **Diretor de Operações**. Após as aprovações, o **Setor de Compras** deve realizar a cotação final e efetuar o pedido. O processo termina quando o solicitante confirmar o recebimento do item." #### **Processo de Onboarding de Novo Colaborador** "Crie um workflow para **Onboarding de Novo Funcionário**. O processo inicia com o **RH** inserindo o nome do novo colaborador, cargo e data de início. O sistema deve gerar tarefas para o **TI** configurar o e-mail e acessos ao sistema, e para o **GP (Gestão de Pessoas)** preparar o kit de boas-vindas. Após o TI e o GP concluírem suas tarefas, o **Gestor da Área** deve receber uma notificação para agendar o treinamento inicial de 15 dias. O processo se encerra com uma pesquisa de satisfação enviada ao novo colaborador após seu primeiro mês." #### **Processo de Solicitação de Suporte Técnico de TI (Foco em Triagem e Correção)** "Desenvolva um processo de **Suporte de TI (Help Desk)**. O **Solicitante** descreve o problema e anexa um print do erro. O **Analista de Nível 1** recebe o chamado e faz a triagem inicial. Se o problema for simples, o Analista resolve e envia para o usuário validar. Se for um erro complexo ou de sistema, o Analista deve encaminhar para o **Desenvolvedor** investigar. Após a correção, o sistema solicita ao usuário que atribua uma nota de 1 a 5 para o atendimento. O processo termina com o fechamento do chamado pelo suporte."
Dicas de prompts para a criação de formulários ## Como construir um bom prompt para usar a ZAI na criação de formulários Como você já viu, a Zai tem ampliado significativamente as possibilidades de interação com o Zeev, sendo possível automatizar a criação de formulários com base na descrição do seu processo. Mas para que a nossa IA funcione com máxima eficiência, é fundamental que o prompt (ou seja, o comando que você escreve) seja claro, organizado e pensado com estratégia. Pensando nisso, (e depois de muitos, MUITOS testes 😅) quero indicar quatro pontos que devem guiar a elaboração de prompts para a ZAI na criação de formulários: #### **1) Contextualize** Antes de qualquer coisa, a Zai precisa entender **onde você está** e o **que você quer**. Isso significa trazer o contexto do processo em questão de forma mais profunda. Qual é o processo? Qual é o objetivo do formulário? Quem o preenche? Em que etapa ele acontece? ***Exemplo de contextualização:*** *Estou desenhando um processo de compras. Esse formulário será preenchido por colaboradores de qualquer área que precisem solicitar um produto ou serviço. Na empresa, as compras acima de R$1500,00 precisam de justificativa e aprovação de um diretor.* **Dica:** Quanto mais contexto, melhor a IA compreenderá a situação e gerará campos mais coerentes. #### 2) Descreva Depois de contextualizar, é hora de descrever o funcionamento do formulário. Aqui você descreverá **como** o formulário será usado. Pense em uma explicação cronológica, como se estivesse guiando alguém pelo passo a passo do preenchimento. ***Exemplo de descrição:*** *O formulário será iniciado pelo solicitante. Ele deve informar o tipo de compra (se produto ou serviço), justificar a necessidade, inserir detalhes do item (nome, quantidade, valor estimado) que devem estar em uma tabela multivalorada com um outro campo de soma dos valores, e anexar um orçamento. Após o envio, o formulário segue para o gestor imediato, que poderá aprovar ou recusar.* **Dica:** Evite repetir o contexto. Aqui é sobre a mecânica de uso, o fluxo. #### **3) Seja Objetivo** Como toda IA, a Zai é excelente em lidar com dados e instruções objetivas. Evite palavras vagas como “talvez”, “seria interessante”, “caso haja necessidade”. Substitua por frases diretas e delimitadas: *❌ "Pode haver a necessidade de aprovação."* *✅ "O gestor deve aprovar ou recusar a solicitação."* *❌ "Gostaria que tivesse um campo de observação."* *✅ "Adicione um campo de observação após o campo de justificativa."* A clareza leva a resultados mais precisos. #### **4) Hierarquize** A organização das informações é fundamental. Use **tags, marcadores** ou **sinais de hierarquia** para separar blocos de informação, dando prioridade e ordem lógica. Isso ajuda a IA a interpretar melhor os grupos de dados e estrutura do formulário. *Você pode usar:* * *Tags explícitas (ex: \, #Campos)* * *Marcadores numéricos (1., 2., 3.)* * *Sinais de hierarquia como asteriscos ou títulos com marcações (ex:* ##Grupo de campos## / #Campos#)

EXEMPLOS

#### **Exemplo 1 - Processo de compras** ``` #Contexto Trata-se de um processo de compras internas. O formulário será preenchido por colaboradores que precisam adquirir produtos ou contratar serviços. A solicitação ocorre após a identificação da necessidade e antes da aprovação do gestor. #Descrição O formulário será iniciado pelo solicitante. Ele deverá: escolher se o é produto ou serviço; a necessidade da compra, se acima de R$1500,00; e informar , , e um orçamento. Organize os campos em seções: <> e <>. ``` Note que aqui, além do contexto e descrição (sinalizados a título de aprendizagem), há o uso de tags que indicam hierarquia, como os sinais de maior e menor, onde ao usar de forma dupla "<< >>" indicamos os grupos do formulário e, ao usar de forma simples "< >", trazemos os campos. #### **Exemplo 2 - Cadastro de cliente PF e PJ** **Cadastro de Cliente PF/PJ** ``` 1) Este processo é um cadastro de clientes. O primeiro passo ao preencher o formulário é determinar se o cliente é uma Pessoa Física ou uma Pessoa Jurídica. 2) Ao selecionar Pessoa Física, os campos a serem preenchidos devem ser relacionados à pessoa física, como nome completo, CPF, RG, data de nascimento, celular e e-mail. 3) Já ao selecionar Pessoa Jurídica, os campos a serem preenchidos devem ser relacionados ao contexto de uma empresa, como razão social, nome fantasia, CNPJ Inscrição Estadual, telefone, e-mail e comprador(es) da empresa. 4) Também devemos ter campos comuns como campos relacionados ao endereço, forma preferencial de pagamento e data preferencial para faturamento dos pedidos - lembrando que os boletos serão emitidos com o vencimento para 28 dias após o faturamento. ``` Note que neste segundo prompt, usamos apenas uma ordem numérica. Porém o contexto do processo foi sendo desenhado durante a "orientação de preenchimento" do formulário. Outro ponto que poderíamos trazer aqui é, somado ao uso da ordem, usar tags para determinar os campos. \_\_ *Os exemplos trazidos são **hipotéticos**, não correspondendo necessariamente a alguma realidade existente, e servem apenas para ilustrar como estruturar prompts eficazes para a criação de formulários com a Zai.* ***Lembre-se:** o uso da inteligência artificial e sua capacidade de compreensão podem variar conforme o contexto do processo, o momento da solicitação e, até mesmo, a clareza das instruções fornecidas. Ao utilizar duas vezes o mesmo prompt, pode ser que a Zai te apresente dois formulários com pequenas diferenças entre si.*
Dicas de prompts para a criação de Agentes de IA A Zai, sua assistente de inteligência artificial no Zeev, é poderosa para criar agentes autônomos que executam tarefas complexas. Assim como na criação de aplicativos e formulários, **a qualidade do *****prompt***** (a instrução que você fornece) é o fator mais crítico para o sucesso do seu Agente.** Um prompt bem pensado garante que o Agente entenda seu papel, suas limitações e o resultado esperado. Quatro pontos essenciais devem guiar a elaboração de prompts para a Zai construir Agentes de IA: #### **1) Defina o Perfil (Papel e Personalidade)** Antes de tudo, a Zai precisa saber **quem** o Agente será e **como** ele deve se comportar. O Agente é um especialista, um analista, um atendente? Qual o tom de voz que ele deve usar? ***Exemplo de Definição de Perfil:*** *Sou um gestor de contratos e preciso de um Agente para revisar minutas. O Agente deve assumir o Perfil de um Analista Jurídico Júnior, com tom formal e cauteloso. Seu objetivo principal é cruzar as cláusulas do documento enviado com a nossa Política de Aquisições (aqui você deve enviar a política ou descrevê-la) e destacar qualquer divergência em potencial.* **Dica:** Definir um papel claro restringe o escopo de atuação do Agente, tornando-o mais focado e menos propenso a "alucinar" (dar respostas fora do escopo). #### **2) Estabeleça as Regras de Execução (O Workflow)** Depois de definir o perfil, descreva **como** o Agente deve executar a tarefa passo a passo, como se estivesse descrevendo um roteiro de execução. Quais os gatilhos? Quais as decisões (se/então)? ***Exemplo de Regras de Execução:*** *O Agente deve seguir este fluxo:* 1. *Receber o arquivo PDF do contrato anexado.* 2. *Fazer a leitura do texto.* 3. *Para cada cláusula de penalidade encontrada, verificar se o valor máximo estipulado é igual ou inferior a 10% do valor total do contrato.* 4. *Se encontrar uma cláusula que viole o limite de 10%, ele deve registrar o número da cláusula e o valor da penalidade em uma Tabela de Inconformidades.* 5. *Ao final, se a Tabela de Inconformidades não estiver vazia, emitir um alerta de **"PENDENTE DE REVISÃO HUMANA"** e anexar a Tabela ao relatório final.* 6. \*Se nenhuma inconformidade for encontrada, emitir o relatório final com o status **"APROVADO"**.\* **Dica:** Mapear a lógica de decisão (condicionais como "se/então") é fundamental para a autonomia do Agente. #### **3) Seja Explícito nas Restrições e Fontes** A IA precisa saber o que **não pode** fazer e, principalmente, **onde buscar a informação correta**. Evite comandos vagos como "Use bom senso" ou "Seja seguro". Defina limites e fontes autorizadas.
* ❌ **Vago:** "Não faça nada ilegal." * ✅ **Explícito:** "O Agente está estritamente proibido de sugerir alterações em cláusulas de foro ou legislação aplicável sem a aprovação explícita de um Gerente Sênior." * ❌ **Vago:** "Use as regras da empresa." * ✅ **Explícito:** "Todas as verificações de conformidade devem ser feitas **exclusivamente** com base nas nossas **Políticas de Aquisições** (lembre-se de disponibilizar), e não com base em conhecimento prévio da Zai." A clareza aqui impede desvios de foco e garante a aderência às diretrizes internas. #### **4) Utilize Estrutura e Marcadores para Ações** Organize o prompt usando marcadores claros para que a Zai separe a **Personalidade** das **Ações** e das **Fontes de Dados**. Use uma estrutura que facilite a leitura e a execução. ***Sugestão de Estrutura com Marcadores:*** * **`#PERFIL:`** Para definir o papel e o tom. * **`#AÇÕES:`** Para listar o fluxo sequencial de execução (o workflow). * **`#FONTES:`** Para indicar quais as fontes/campos ele deve considerar. * **`#SAÍDA_FORMATO:`** Para declarar como o resultado deve ser entregue. Um prompt bem estruturado, como o sugerido abaixo, maximiza a chance de a Zai criar um Agente que atenda exatamente à sua necessidade operacional.

EXEMPLO PRÁTICO

``` #PERFIL Assuma o perfil de um Técnico de Suporte Nível 1 (Help Desk). Seu tom deve ser objetivo, empático e resolutivo. Sua prioridade é classificar o chamado recebido, coletar informações cruciais e encaminhar para o time correto, ou resolver se for procedimento padrão. #AÇÕES 1. Receber o texto do chamado aberto pelo usuário no portal. 2. Ler a descrição e classificar a "Categoria" do problema (ex: Acesso, Impressora, Software, Infraestrutura). 3. Checar se a Categoria é "Acesso". Se for, retornar como concluído e enviar o para o campo para que o usuário receba as instruções de recuperação de acesso. 4. Se a Categoria não for "Acesso" ou se o problema for "Permissão", classificar a prioridade (baixa, média, alta) com base nas palavras-chave (ex: "Sistema principal fora do ar" = Alta). 5. Se a prioridade for "Alta", retornar o resultado como "Fila TI - Nível 2 - Prioridade Imediata". 6. Se a prioridade for diferente de "Alta", ou Categoria diferente de "Acesso" marcar o chamado como "CONCLUÍDO". #FONTES Utilize os campos fornecidos pelo usuário/solicitante. #SAÍDA_FORMATO O resultado pode ser um resumo do ticket para o usuário, informando o status da resolução. Se "CONCLUIDO" informar que o ticket está em atendimento. Se prioridade for "ALTA", indicar que uma equipe especializada está dando prioridade ao assunto. Se a Categoria for acesso, indicar que o ticket foi finalizado. ```
--- # 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/zai-inteligencia-artificial-do-zeev/como-utilizar-a-inteligencia-artificial-do-zeev/como-a-zai-pode-te-auxiliar/dicas-de-uso-de-prompts-para-a-zai.md?ask= ``` 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.