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: <Contexto>, #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 <tipo de compra> é produto ou serviço; <justificar> a necessidade da compra, se acima de R$1500,00; e informar <nome do item>, <quantidade>, <valor estimado> e <anexar> um orçamento.
Organize os campos em seções: <<dados da Solicitação>> e <<detalhes dos itens>>.

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 <link> para o campo <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.