Leitura de 6 minutos Atualizada: 14/10/2026 Criado pela: Equipe Botmaker

Como utilizar as instruções de IA?

Neste artigo, você aprenderá a adicionar o bloco “Instruções de IA” ao seu bot, configurar sua função, objetivo, tom e limites, escolher o modelo generativo e conectá-lo a variáveis, ações, bases de conhecimento e ações de código.



Instruções de IA é um bloco do Bot Designer que usa inteligência artificial generativa para conversar com seus clientes até cumprir um objetivo. Em vez de criar um bloco de texto para cada resposta possível, você dá ao bloco uma instrução (qual papel ele cumpre, o que precisa alcançar e como) e a IA redige cada resposta de acordo com o que o cliente escreve.


Você conhecia este bloco como "Agente de IA"? É o mesmo bloco: mudamos o nome para Instruções de IA para diferenciá-lo dos novos Agentes de IA do Botmaker 3.0. Seus blocos existentes continuam funcionando da mesma forma; só o nome mudou.


Como configurar o bloco Instruções de IA

Passo 1: Adicione o bloco ao seu fluxo

Acesse o Bot Designer, abra o fluxo em que você quer usar IA generativa e adicione o bloco Instruções de IA a partir do menu de blocos. Posicione-o no ponto da conversa em que você quer que a IA assuma o controle; por exemplo, depois da saudação, quando o cliente pede ajuda para escolher um produto.

pt


Passo 2: Defina o papel e o objetivo principal

No menu lateral, selecione Papel e objetivo principal. Você verá três campos vazios, cada um com um exemplo em cinza que serve de guia:

  • Papel (até 300 caracteres): quem o bot é nesta conversa. Exemplo: Assistente de vendas de uma loja online. Defina-o em uma frase curta, porque o papel orienta todas as respostas e, se for ambíguo, a IA também será.
  • Objetivo (até 300 caracteres): o que o bloco precisa alcançar. Exemplo: Ajudar o usuário a escolher um produto. É a meta que a IA persegue em cada resposta, então escreva um único objetivo concreto.
  • Instruções (até 4.500 caracteres): o passo a passo do que o bloco deve fazer, as perguntas que deve fazer, em que ordem e o que fazer em cada caso. Aqui entra o detalhe que não cabe no papel nem no objetivo.

Para completar o bloco, você deve seguir os passos que estão dentro dele.

pt1

Insira cada elemento na parte da instrução em que você precisa dele, porque assim a IA entende quando e para que usá-lo. Por exemplo: "Pergunte ao cliente o número do pedido e salve-o em $numeroPedido. Depois consulte $BaseEntregas para informar o status." Com cada tipo de elemento, o bloco pode:

  • Variáveis: ler as informações salvas do cliente para personalizar a conversa e também capturar dados das mensagens dele e salvá-los em variáveis, se você pedir isso na instrução.
  • Ações: executar as ações disponíveis para cumprir seu objetivo.
  • Bases de conhecimento: buscar informações ou validar dados no seu conteúdo antes de responder, para não inventar respostas.
  • Ações de código: acionar ações de código como parte do seu objetivo. Por enquanto, o bloco não reconhece os parâmetros nem os valores que elas retornam, então explique na instrução quando usar cada uma.


Passo 3: Configure o tom e o estilo

No menu lateral, selecione Tom e estilo. Aqui você define como o bloco se expressa: se é formal ou próximo, se usa frases curtas, se trata o cliente por você ou de forma mais formal. Essa configuração complementa a que você fez em Identidade e preferências do bot, então use-a para ajustar o estilo deste bloco em particular sem mudar o do resto do bot.

pt tono y estilo


Nesta seção você também pode ativar os botões na resposta. Quando o bloco oferece opções ao cliente (por exemplo, três produtos para escolher), ele as mostra como botões para que o cliente possa tocar em vez de digitar. Você não precisa escrever o texto dos botões na instrução: a própria IA gera o conteúdo de acordo com a conversa.

20251117 gkzTZRRKzKVyOcjOOv1i8Av3zy93 EJ1SE aW1hZ2UgKDgp


Passo 4: Defina os temas que ele não deve tratar

No menu lateral, selecione Não falar sobre. Liste os temas que o bloco deve evitar, como preços da concorrência, opiniões políticas ou orientação jurídica. Este passo funciona como um controle de segurança: evita respostas inadequadas ou que seu negócio não pode respaldar, mesmo que o cliente insista em perguntar.

es no hablar sobre


Passo 5: Escolha o modelo generativo

No menu lateral, selecione Modelo generativo e escolha o modelo de IA que este bloco vai usar. Você pode usar um modelo diferente em cada bloco, de acordo com o que precisar: mais velocidade para respostas simples ou mais capacidade de raciocínio para conversas complexas. Para entender as diferenças entre os modelos, consulte o artigo "Como selecionar um modelo de Inteligência Artificial generativa?".

pt modelo generativo


Passo 6: Salve, ative e teste o bloco

Clique em Salvar (no canto inferior direito) para salvar as alterações. Se preferir descartá-las, clique em Descartar. Verifique se o seletor Ativo, no canto superior direito, está ligado; se estiver desligado, o bloco não responde na conversa.

Depois, clique em Testar, na barra superior do Bot Designer, e converse com seu bot como um cliente faria. Se as respostas não forem as esperadas, volte a Papel e objetivo principal e ajuste a instrução. Quando estiver satisfeito, clique em Publicar para que as alterações cheguem aos seus clientes.


Considerações importantes

  • É o mesmo bloco que "Agente de IA": só o nome mudou. Você não precisa recriar nem migrar os blocos que já tinha.
  • Instruções de IA ou Agentes de IA: use Instruções de IA para guiar uma conversa com IA generativa dentro de um fluxo do Bot Designer. Se o seu bot precisa usar ferramentas, consultar sistemas ou concluir tarefas, recomendamos os Agentes de IA do Botmaker 3.0 (você pode acessá-los pelo link Ir para Agentes de IA, que aparece dentro do bloco).
  • Limites de caracteres: Papel e Objetivo aceitam até 300 caracteres cada um; Instruções, até 4.500. Se o espaço acabar, priorize os passos e as regras que mais impactam o objetivo.
  • Conteúdo dos botões: é gerado pela IA em cada conversa, por isso pode variar de um cliente para outro.
  • Seletor Ativo: se estiver desligado, o bloco não intervém na conversa, mesmo que esteja no fluxo.

Para escrever instruções melhores, compartilhamos com você o artigo "Boas práticas para instruções de IA: use a IA generativa com critério e obtenha melhores resultados".



Lembre-se de visitar nossa Central de Ajuda para obter mais informações.