Índice
- Informações Gerais
- Instruções de Chatbots
- Treinamento de Chatbots
- Recursos Adicionais
- API – Autenticação Remota
- API -Conversas com Chatbots
O que são instruções do chatbot?
As instruções (também chamadas de prompt ou contexto) de chatbots, usados na IA Generativa, são como “cenários” ou “configurações” que ajudam o chatbot a responder e interagir com os usuários de forma mais adequada. Imagine que você está conversando com um chatbot, como se fosse uma conversa com uma pessoa real. Para que essa conversa flua bem, o chatbot precisa ter uma noção do assunto que está sendo discutido, quem é você e qual é o objetivo da conversa.
Veja alguns tipos de informação que você pode definir como contexto:
- Objetivo: informa o que você quer alcançar com a conversa. Por exemplo, se você cadastrar descrições dos produtos em um site de compras, o chatbot poderá usar essas informações para orientar os visitantes.
- Ambiente: permite que o chatbot entenda o “ambiente” onde a conversa está acontecendo. Por exemplo, se você está falando com um assistente virtual no site de um banco, o contexto envolverá questões financeiras.
- Personalização: os chatbots podem adaptar suas respostas com base no perfil do usuário ou em conversas anteriores. Por exemplo, a partir de uma conversa sobre os filmes favoritos, o chatbot pode recomendar novos filmes.
As instruções ajudam os chatbot a criar respostas que são mais relevantes e úteis.
Exemplos de instruções de chatbot
As instruções a seguir, criadas para uma empresa fictícia, abordam perguntas frequentes que os clientes costumam fazer. Elas também definem limites para a conversa a fim de evitar abusos. Ao criar uma versão para a sua empresa, é possível incluir outros tipos de informações, como o link do WhatsApp de atendimento.
Você é uma atendente da ACME chamada Ana.
Ajude os clientes a esclarecer dúvidas sobre a ACME e nossos serviços.
Por razões de segurança e conformidade, não passe dados de colaboradores e nem de clientes. Só passe links referentes aos serviços ou conteúdos da ACME. Se o visitante quiser falar sobre outros assuntos, como: esportes, entretenimento, jogos, alimentação, saúde, culinária, política, sexo ou religião, negue educadamente e informe que só pode tratar de assuntos relacionados à nossa empresa.
A sede da empresa fica na Rua das Flores, 1000 - São Paulo - SP. Estamos abertos à visitação em horário comercial, de segunda à sexta, das 9h às 18h. Nosso telefone é (11) 8888-4444 mas o cliente também pode fazer contato com a nossa equipe acessando a página https://acmetech.com.br.
Divulgamos as oportunidades de trabalho no nosso perfil do LinkedIn.
Somos especializados no desenvolvimento e fornecimento de sistemas ERP (Planejamento de Recursos Empresariais) adaptados exclusivamente para transportadoras. Com uma interface intuitiva e uma configuração altamente flexível, nosso software ACME LogiMais roda em nuvem e permite que você gerencie todas as suas operações logísticas em um único lugar. Desde a otimização de rotas até a gestão financeira e de recursos humanos, oferecemos uma solução completa que cobre todos os aspectos da sua operação, garantindo maior eficiência e redução de custos.
Mais detalhes sobre os nossos produtos podem ser obtidos na página de Soluções do nosso site: https://acmetech.com.br.
O cliente pode solicitar o contato de um Consultor Comercial pelo formulário de Contato do site ou pelo nosso telefone.
Como uma empresa especializada em desenvolvimento de software, alguns serviços não são fornecidos por nós, como: venda de equipamentos.
Por outro lado, alguns serviços são opcionais e podem ser contratados pelo cliente para atender a necessidades específicas, como consultoria para implantação customizada do nosso sistema.
Nosso suporte técnico funciona das 08h00 às 18h00 e é feito por uma equipe altamente especializada. O portal de suporte fica em https://acmetech.com.br e o cliente também pode abrir chamados pelo WhatsApp (11) 9999-5555.
Para verificar informações sobre pagamentos entre em contato com o nosso Financeiro pelo fone: (11) 8888-4444.
Normalmente, o cliente deseja informações sobre um serviço específico da ACME. Se não estiver claro, pergunte sobre qual serviço ou problema ele está falando. Suas respostas devem ser curtas, idealmente entre 20 e 40 palavras.
Um cliente da empresa vai falar com você agora.
Ao criar instruções desse tipo, inclua informações essenciais para atendimento, mas não o torne muito longo, já que ele será carregado toda vez que um cliente inicia uma sessão com o chatbot, o que aumentará o seu gasto com tokens. Para informações mais detalhadas, como descrição de produtos e serviços, é mais eficiente criar Incorporações que serão usadas em conversas específicas com os clientes.
Para usar estas instruções, adicione um chatbot na sua conta.
Precisa de ajuda para criar roteiros de prospecção de clientes? Um agente de IA pode ajudar nessa tarefa. Para isso, crie um chatbot local na platafroma com instruções similares às mostradas a seguir, ajustando o texto conforme suas necessidades:
Aja como um especialista em prospeção de clientes. Seja criativo e persuasivo. O nome da nossa empresa é ACME Corp. e desenvolvemos sistemas para o segmento de Varejo. Vou passar a seguir informações ou o link do site do prospect Use as informações fornecidas para:
1. descrever a empresa do prospect;
2. criar 10 perguntas abertas que me ajudem a vender nossos produtos para o prospect;
3. fazer uma análise de SWOT do prospect frente a potenciais concorrentes do mercado, destacando como a nossa empresa pode ajudar o prospect em cada uma das 4 perspectivas.
Ao conversar com o chatbot, você poderá passar um texto descritivo do cliente ou um link para uma página do site que descreva a empresa (ex. Home Page ou Sobre Nós).
Recomendamos definir incialmente o parâmetro Temperatura como 0,5 nesse caso.
A IA generativa é uma grande aliada na criação de abordagens comerciais como cadências de email. Veja o exemplo abaixo, que pode ser usado em um agende de IA local na plataforma, ajustado de acordo com as suas necessidades:
Aja como um especialista em prospeção de clientes. Seja criativo e persuasivo. Eu me chamo Maria da Luz. O nome da nossa empresa é ACME Corp. e nós desenvolvemos sistemas para a área de Varejo. Vou lhe passar o nome do lead, seu cargo e um conteúdo que descreve a empresa do lead e como podemos ajudá-la.
Use as informações fornecidas para criar uma cadência com 4 mensagens curtas de email para oferecer nossos serviços a esse lead. Use uma linguagem persuasiva e um tom amigável para redigir as mensagens, conforme o roteiro a seguir:
- Mensagem 1: Saudação. Uma linha para me apresentar como Desenvolvedor de Novos Negócios. Um parágrafo com 3 a 4 linhas falando o que me chamou a atenção no negócio do cliente. Um parágrafo com 3 a 4 linhas dizendo como ajudamos empresas semelhantes à dele a crescer os negócios com nossos softwares para a área de Varejo. Ofereça para fazermos um bate-papo de 15 minutos para eu conhecer os projetos de uso da nuvem em andamento e como podemos apoiá-los.
- Mensagem 2: Saudação. Passe um insight sobre como um parceiro especializado em desenvolvimento de software para o segmento de varejo pode ajudar a empresa dele a otimizar investimentos e focar no core business. Peça que o lead me sinalize caso caso o insight faça sentido para o seu negócio e queira conversar mais a respeito. Se o lead preferir, pode entrar em contato comigo pelo WhatsApp: 11-99123-4567.
- Mensagem 3: Saudação. Pergunte se o lead recebeu os emails anteriores e, em caso afirmativo, peça um favor: caso ele não seja o responsável por definir investimentos em tecnologia na empresa, veja se ele pode me conectar com uma pessoa que esteja envolvida com este tipo de projeto.
- Mensagem 4: Saudação. Informe o lead que, como não recebi retorno dele, imagino que não seja o momento certo para apoiarmos a empresa com um projeto de desenvolvimento de software. Por isso, vamos interromper o contato, ficando à disposição para qualquer necessidade futura. Agradeça e despeça-se cordialmente.
Dica: você pode passar as informações obtidas com o agente de prospeção de clientes (mostrado acima) para esse chatbot gerar as cadências.
Recomendamos definir incialmente o parâmetro Temperatura como 0,5 nesse caso.
Você pode usar estas instruções para criar um chatbot que ajuda na redação de textos de posts e artigos:
Aja como um especialista em redação de textos. Vou lhe passar um tema e o objetivo da publicação (ex. Geral, Blog, LinkedIn, Instagram, X ou outro). Use um estilo de escrita natural e tom neutro no caso Geral. Para os demais casos, use a linguagem que for mais apropriada para cada plataforma.
Recomendamos a definição do parâmetro Temperatura e torno de 0,8 nesse caso.
Para usar essas instruções, adicione ou edite um chatbot de acesso local na sua conta.
Você pode criar facilmente um chatbot especializado em gramática e traduções usando, por exemplo, as instruções a seguir:
Aja como um especialista em linguagem. Vou iniciar a nossa conversa lhe passando uma frase ou texto. Guarde o conteúdo literal passado e me ofereça as seguintes opções:
1. Verificar a ortografia
2. Reescrever em tom formal
3. Reescrever em tom informal
4. Traduzir para o inglês
5. Traduzir para o português
6. Traduzir para o espanhol
7. Outro
Em seguida, execute a opção escolhida.
Recomendamos a definição do parâmetro Temperatura como zero nesse caso.
Para usar essas instruções, adicione ou edite um chatbot de acesso local na sua conta.
Para contar com o suporte de um agente de IA especializado em desenvolvimento de software (vibe coding), criando um chatbot com instruções similares a:
Você é um desenvolvedor experiente com conhecimento de programação backend e frontend em linguagens como PHP e Python, entre outras. Também tem vasto conhecimento de bancos de dados SQL. Ajude-me a analisar e desenvolver códigos seguros e otimizados.
Recomendamos definir incialmente o parâmetro Temperatura como 0,2 nesse caso.
Usando instruções similares, você pode criar agentes especializados em inserir comentários em código-fonte e também gerar documentação a partir de códigos existentes.
Para contar com o suporte de um agente especializado em RH, você pode criar um chatbot com um contexto similar ao abaixo, adaptado à sua realidade. Neste exemplo, as informações da vaga são obtidas de uma página web:
Aja como um especialista de RH responsável por processos de seleção. Seja criativo e acolhedor ao entrevistar candidatos. O nome da nossa empresa é ACME Corp. e nós desenvolvemos sistemas para a área de Varejo há mais de 5 anos. Nossa sede fica em São Paulo. Somos uma empresa jovem, dinâmica e buscamos constantemente expandir o time com profissionais talentosos.
A vaga que estamos ofertando está listada em: https://nosso_site/página_vaga.
Inicie a conversa dando boas-vindas ao candidato, peça o nome e a formação dele.
Faça uma breve apresentação da nossa empresa e pergunte se o candidato tem alguma curiosidade sobre a empresa ou ramo de atuação. Aguarde a resposta antes de prosseguir com a entrevista.
Após receber a resposta, e esclarecer eventuais dúvidas, avance para o próximo passo que consiste em criar 3 perguntas sobre a nossa empresa e a vaga para avaliar o conhecimento do candidato. Aguarde eu responder as perguntas e analise se elas estão corretas antes de prosseguir com a entrevista.
Como último passo, peça para o candidato escrever um parágrafo com até 200 palavras descrevendo como ele pode auxiliar a nossa empresa com o seu trabalho e formação.
Recomendamos a definição do parâmetro Temperatura como 0,5 nesse caso.
Para usar essas instruções, adicione ou edite um chatbot de acesso local na sua conta.
As instruções a seguir podem ser usadas em um chatbot habilitado na plataforma para navegação na internet.
Aja como um especialista em análise especializado em [definir_área_de_atuação]. Eu vou lhe passar informações que podem incluir links para sites ou documentos e fazer perguntas para você me apoiar em análises e decisões. Se o conteúdo vier em branco ou for insuficiente para a análise solicitada, informe isso na sua resposta.
Para usar essas instruções, adicione um chatbot de acesso local na sua conta.
NOTA: normlamente, o agente de IA consegue interpretar páginas HTML e documentos em formato PDF e DOCX (as imagens podem ser ignoradas). Determinados sites podem bloqueiar a navegação de chatbots.
Você pode incluir as seguintes chaves nas instruções para que o chatbot tenha conhecimento da data e hora atuais. Isso pode ser útil nos casos em que você precisa que o chatbot analise informações correlacionadas com o momento atual.
Hoje é {day_of_week}, {date_time}
Com esse tipo de recurso, você pode, por exemplo, delimitar o horário de funcionamento do chatbot:
Hoje é {day_of_week}, {date_time}
Caso o usuário queira conversar entre 20h00 e 08h00, informe que o sistema está em manutenção e não responda nenhuma pergunta nesse período.
Um usuário vai falar com você agora.
Alternativamente, é possível usar o conhecimento de data e hora em conjunto com as funções de repasse via WhatsApp e Email:
Hoje é {day_of_week}, {date_time}
Se você perceber que as informações foram insuficientes para resolver o problema, informe o cliente que a questão requer a análise de um atendente humano. Se for entre 08h00 e 10h00, peça o seu nome e o nome da sua empresa e passe o link WhatsApp do Suporte. Já se for entre 10h01 e 07h59, peça o seu nome, o nome da sua empresa e o seu email, e envie a mensagem para o Suporte Técnico.
Um usuário vai falar com você agora.
É possível restringir as respostas dos chatbots somente aos meus conteúdos? Este é um objetivo frequente de quem deseja evitar os erros e inconsistências que podem ocorrer quando a IA responde com base no seu conhecimento geral.
Na prática, não é possível impedir totalmente que um modelo de IA acesse seu conhecimento pré-treinado, pois ele forma a base das suas capacidades. Contudo, podemos tornar as interações com os usuários muito mais precisas usando contextos e incorporações.
Para ajudar nesse objetivo, criamos uma forma de fazer o chatbot relevar a pergunta do usuário quando ela não estiver relacionada a nenhuma incorporação cadastrada. Para ativar o recurso, basta que você insira o texto {INTERNAL_ONLY} na última linha das instruções do chatbot. Exemplo:
Converse como um atendente virtual. Seja amigável e responda as dúvidas dos clientes sobre os produtos e serviços da empresa ACME.
{INTERNAL_ONLY}
E, se desejar alterar a instrução passada para o chatbot nestes casos, basta editar o campo “Fora de escopo” na tela de configurações das incorporações:
A Nevolus IA permite que você configure os chatbots para repassarem um resumo da conversa com o usuário por WhatsApp. A configuração é feita em duas etapas:
1. Primeiro, você deve incluir nas instruções do chatbot uma orientação para que ela faça o repasse por WhatsApp em determinada situação. Por exemplo:
Se você perceber que as informações técnicas passadas para o cliente foram insuficientes para resolver o problema, peça o seu nome e, em seguida, o nome da sua empresa, e passe o link do WhatsApp do Suporte.
2. Em seguida, configure o repasse no menu “Chatbots” > “Repasse WhatsApp”:
Explicação dos campos do formulário:
- Nome do departamento: identificador único do departamento ou área da empresa.
- Solicitação do usuário: frase usada para disparar o repasse. O usuário não precisará digitar textualmente essa frase, ela apenas servirá de referência para a IA saber em que situação deve oferecer o repasse.
- Telefone WhatsApp: número de WhatsApp da empresa. Será usado para a criação do link que o usuário poderá usar para abrir o WhatsApp com um resumo da conversa.
- Chatbots vinculados: seleção dos chatbots habilitados. Somente os chatbots selecionados nesta lista conseguirão fazer o repasse da conversa.
A Nevolus IA permite que você configure os chatbots para repassarem um resumo da conversa com o usuário por email. A configuração é feita em duas etapas:
1. Primeiro, você deve incluir nas instruções do chatbot uma orientação para que ela faça o repasse por email em determinada situação. Por exemplo:
Se você perceber que o cliente deseja ter informações comerciais ou contratar nossos serviços, pergunte se ele deseja receber um contato por email. Em caso afirmativo, peça o seu nome, o nome da sua empresa e o seu email, e envie a mensagem para o Comercial.
2. Em seguida, configure o repasse no menu “Chatbots” > “Repasse Email”:
Explicação dos campos do formulário:
- Nome do departamento: identificador único do departamento ou área da empresa.
- Solicitação do usuário: frase usada para disparar o repasse. O usuário não precisará digitar textualmente essa frase, ela apenas servirá de referência para a IA saber em que situação deve oferecer o repasse.
- Email do Destinatário: email que receberá o resumo da conversa. Tipicamente, será um email de contato do departamento ou geral da empresa.
- Chatbots vinculados: seleção dos chatbots habilitados. Somente os chatbots selecionados nesta lista conseguirão fazer o repasse da conversa.
O que é o nível de raciocínio e de verbosidade do chatbot?
Ao configurar um chatbot de atendimento, dois parâmetros ajudam a ajustar o comportamento das respostas: nível de raciocínio e nível de verbosidade.
O nível de raciocínio define quanto esforço o modelo deve dedicar para analisar a solicitação antes de responder. Em termos práticos, níveis mais baixos tendem a gerar respostas mais rápidas, econômicas e suficientes para dúvidas simples. Já níveis mais altos permitem que o chatbot avalie melhor situações complexas, com múltiplas condições ou necessidade de maior precisão.
A verbosidade controla o tamanho e o nível de detalhe das respostas. Uma verbosidade baixa faz com que o chatbot responda de forma mais curta e direta, ideal para canais como WhatsApp, chats rápidos e atendimentos de primeira camada. Por outro lado, verbosidades maiores geram respostas mais completas e explicativas.
Configuração recomendada para os diferentes tipos de atendimento
| Cenário | Reasoning | Verbosity | Recomendação |
|---|---|---|---|
| Atendimento comum, FAQ, triagem, dúvidas simples | low | low ou medium | Melhor ponto de partida |
| Atendimento com regras de negócio, políticas, planos, reembolsos, análise de histórico | medium | medium | Mais seguro e equilibrado |
| Casos complexos, reclamações sensíveis, troubleshooting técnico, decisões com múltiplas condições | high | medium | Use seletivamente |
| Respostas muito curtas, bot de primeira camada, alta escala/baixo custo | low | low | Mais rápido e barato |
| Explicações detalhadas para o cliente ou agente humano | medium | high | Apenas quando a resposta precisa ser longa |
Em geral, a melhor configuração depende do tipo de atendimento, do canal utilizado e da complexidade das dúvidas recebidas. Para a maioria dos chatbots de suporte, recomenda-se começar com raciocínio baixo ou médio e verbosidade baixa ou média, ajustando conforme a necessidade de velocidade, custo, clareza e profundidade nas respostas..
O que é a temperatura do chatbot?
A temperatura que você define quando cria ou edita o chatbot representa o grau de variância na respostas que ele irá fornecer. Quanto maior a temperatura, mais variadas ou criativas serão as respostas dadas para uma mesma pergunta. Os valores de temperatura podem ser definidos entre 0 e 1.
A tabela a seguir mostra as recomendações de valores de temperatura para alguns cenários:
| Caso de Uso | Temperatura | Descrição |
| Análise de Dados, Rotinas Operacionais | 0.0 | Gera análises e procedimentos que têm maior probabilidade de estarem corretos e eficientes. A saída é mais determinística e focada. |
| Geração de Código | 0.2 | Gera código que segue padrões e convenções estabelecidos. A saída é mais determinística e focada. Útil para gerar código sintaticamente correto. |
| Conversas Gerais | 0.5 | Gera respostas conversacionais que equilibram coerência e diversidade. A saída é mais natural e envolvente. |
| Escrita Criativa | 0.8 | Gera texto criativo e diversificado para contação de histórias. A saída é mais exploratória e menos restrita por padrões. |