Configurar, testar, implantar e gerenciar um Agente de IA no AgentFlow

Aprenda como configurar seu Agente de IA, validar suas respostas e implantá-lo no AgentFlow.

Written By Frieda Yip (Super Administrator)

Updated at July 31st, 2026

Table of Contents

Accessing the “Create AI agent” page Etapa 1: Criar o agente de IA Escolher um modelo Nomear o agente Etapa 2: Configurar e testar o agente de IA Configurar a base de conhecimento no nível do agente Por que a base de conhecimento no nível do agente é importante Fazer upload de arquivos Indexação de URL Pesquisa na web Respostas personalizadas Base de conhecimento global Entender o processamento das fontes e dos artigos gerados Permitir que o agente consulte propriedades de contato Definir a prioridade das respostas Configurar o estilo e o ritmo das respostas Divisão semântica de mensagens (ritmo semelhante ao humano) Escrever o Playbook Escrever instruções em Seu Playbook Usar o Playbook otimizado Editar o Playbook otimizado Salvar alterações no Playbook otimizado Usar comandos no Playbook Referenciar uma fonte de conhecimento específica com /source Usar comandos do Shopify no Playbook Ações disponíveis no Shopify Calcular a pontuação de lead (opcional) Testar o agente no Playground de testes Testar respostas por chat Executar uma rodada de teste de respostas Etapa 3: Implantar o agente de IA Selecionar o canal Definir um horário específico para resposta (opcional) Configurar condições de saída Definir o público-alvo da implantação Implantar o agente de IA Gerenciar um agente de IA existente Atualizar a configuração e os testes Gerenciar condições de saída Atualizar as configurações de implantação Criar um novo fluxo Atualizar um fluxo existente

Observação: esta versão da configuração do AgentFlow está disponível atualmente em uma versão de acesso limitado. Se você tiver interesse em experimentá-la, entre em contato com nossa equipe para solicitar acesso antecipado.

 

 

O AgentFlow oferece uma experiência de configuração guiada que ajuda você a criar, configurar, testar e implantar um agente de IA sem precisar criar manualmente a lógica no Flow Builder. Além disso, oferece controles adicionais para personalizar as respostas, orientar o uso da base de conhecimento e gerenciar a implantação com mais precisão.

O processo de configuração utiliza um assistente de 3 etapas que orienta você na criação do agente, na configuração da base de conhecimento e do comportamento, no teste das respostas e na implantação nos canais selecionados.

Esse fluxo de trabalho ajuda as equipes a:

  • Configurar agentes de IA mais rapidamente usando modelos de casos de uso.
  • Testar as respostas antes da publicação.
  • Entender como o agente gera respostas por meio das ferramentas de depuração integradas.

Os casos de uso mais comuns incluem:

  • Comércio: consultor de produtos ou assistente de vendas.
  • Agendamento de serviços: responder a dúvidas e orientar os clientes na conclusão de agendamentos.
  • Educação: ajudar os usuários a explorar programas ou serviços.

O processo de configuração inclui as seguintes etapas:

  1. Criar o agente de IA.
  2. Configurar o agente e testar as respostas.
  3. Implantar o agente nos canais.

 

Accessing the “Create AI agent” page

Siga as etapas abaixo para acessar a página Criar agente de IA:

  1. Clique no ícone no painel lateral esquerdo para acessar a página IA da SleekFlow.
  2. Clique em AgentFlow na barra de navegação superior.

 

Etapa 1: Criar o agente de IA

Há duas maneiras de criar um agente de IA:

  1. Se essa for a primeira vez que você cria um agente de IA, clique em Começar agora.
  2. Se você já tiver criado agentes de IA, clique em Criar novo agente no canto superior direito da página.

A etapa Criar permite escolher um modelo e definir as informações básicas do agente de IA.

 

Escolher um modelo

Comece selecionando um modelo que corresponda ao caso de uso desejado.

As opções disponíveis incluem modelos desenvolvidos para cenários comuns, como:

  • Comércio eletrônico
  • Agendamento de serviços
  • Educação
  • Agente de triagem jurídica

Os modelos oferecem um ponto de partida estruturado com instruções predefinidas no Playbook, que podem ser modificadas posteriormente. Você também pode selecionar Personalizado e configurar o agente de IA do zero.

 

Observação: a seleção de um modelo ainda não salva nenhuma configuração. O agente será criado somente depois que você avançar para a próxima etapa.

 

 

Nomear o agente

Em seguida, forneça as informações básicas do agente.

 

Campo obrigatório:

  • Nome do agente: usado internamente para identificar o agente. Esse nome não fica visível para os clientes.

Campo opcional:

  • Descrição: uma breve descrição interna para ajudar sua equipe a entender a finalidade do agente.

Se você tiver selecionado um modelo para começar, esses campos serão preenchidos automaticamente. Você poderá editá-los para garantir que o nome e a descrição do agente de IA sejam fáceis de reconhecer pelos membros da equipe interna.

Clique em Criar, no canto superior direito da página, para continuar.

 

Etapa 2: Configurar e testar o agente de IA

Nessa etapa, você define como o agente de IA deve se comportar e fornece as informações que ele usará para responder às dúvidas dos clientes.

Você irá:

  • Adicionar fontes de conhecimento
  • Configurar o comportamento das respostas
  • Definir instruções de conversa no Playbook
  • Habilitar a pontuação de lead, opcionalmente
  • Testar o agente no Playground de testes

O Playground de testes permite simular conversas e avaliar as respostas antes de implantar o agente.

 

Configurar a base de conhecimento no nível do agente

Cada agente de IA do AgentFlow possui sua própria Base de conhecimento. Ela controla quais informações o agente pode consultar ao responder aos clientes.

Você pode adicionar fontes diretamente à base de conhecimento no nível do agente durante a configuração. A SleekFlow processa e indexa essas fontes em segundo plano. Dependendo do tipo de fonte e do status do processamento, o agente poderá consultar primeiro o material enviado e, em seguida, os artigos gerados quando estiverem prontos.

É necessário adicionar pelo menos uma fonte de conhecimento antes de testar o agente.

Dica: se a fonte de conhecimento exceder o limite de caracteres disponível, o treinamento poderá ser desativado temporariamente até que o tamanho do conteúdo seja reduzido.

 

 

Por que a base de conhecimento no nível do agente é importante

A base de conhecimento no nível do agente ajuda você a controlar o escopo de conhecimento de cada agente de IA.

Use-a para:

  • Manter cada agente focado no produto, serviço, região ou fluxo de trabalho corretos
  • Evitar que o agente consulte informações não relacionadas
  • Adicionar fontes durante a configuração do agente sem sair do AgentFlow
  • Testar o agente enquanto as fontes e os artigos gerados ainda estão sendo processados

 

Fazer upload de arquivos

O upload de arquivos permite adicionar ao agente de IA conhecimentos provenientes de documentos.

Ao fazer upload de arquivos, o sistema extrai o conteúdo de texto e o utiliza como material de referência quando o agente responde às perguntas dos clientes.

Você pode fazer upload de documentos nos seguintes formatos:

  • .PDF
  • .DOCX
  • .XLSX
  • .CSV
  • .JPG

Limites:

  • Até 20 arquivos
  • Máximo de 50 MB por arquivo

 

Esses arquivos são indexados e usados como material de referência quando o agente responde às perguntas dos clientes.

Siga as etapas abaixo para fazer upload de arquivos como fontes de conhecimento:

  1. Na etapa Configurar, clique em Gerenciar conhecimento.
  2. A janela Gerenciar conhecimento será exibida. Clique no ícone .
  3. Selecione Fazer upload de arquivos no menu suspenso.
  4. Um painel lateral será exibido.
  5. Arraste e solte os arquivos ou clique em Fazer upload de .DOCX, .PDF, .XLSX, .JPG para selecioná-los no seu dispositivo.
  6. Depois que você selecionar os arquivos, o sistema começará a processá-los. Quando o processamento for concluído, uma lista dos arquivos enviados será exibida.

Depois que o escaneamento for concluído, você poderá:

  • Treinar arquivos selecionados: selecionar os arquivos necessários e adicioná-los à base de conhecimento do agente de IA como materiais de treinamento
  • Excluir arquivos selecionados: excluir da lista os arquivos selecionados

Depois que o escaneamento for concluído e você tiver selecionado os arquivos que serão usados como materiais de treinamento, clique em Treinar selecionados para processar o conteúdo.

Observação: somente o conteúdo de texto dos arquivos enviados é extraído para o treinamento. Imagens, layout e outros elementos que não sejam texto não são utilizados, a menos que o texto esteja incorporado em um formato legível.

 

 

Indexação de URL

Você pode fornecer a URL de um site para que o sistema a escaneie e a indexe.

A indexação de URL permite que o agente de IA consulte informações diretamente do seu site.

Ao adicionar uma URL, o sistema escaneia a página da web e extrai o conteúdo de texto. O agente de IA pode então usar essas informações como referência ao responder às perguntas dos clientes.

Quando usar a indexação de URL

A indexação de URL é mais indicada quando seu site já contém informações estruturadas que os clientes costumam procurar, como:

  • Detalhes de produtos ou páginas de catálogo
  • Artigos de perguntas frequentes (FAQ) ou da Central de Ajuda
  • Descrições de serviços
  • Informações sobre preços
  • Páginas de políticas (envio, devoluções etc.)

O uso da indexação de URL permite treinar previamente o agente de IA com conteúdos específicos do site. Isso ajuda o agente a responder com maior precisão e rapidez, pois ele não precisa consultar as informações do site em tempo real.

Siga as etapas abaixo para adicionar URLs para indexação:

  1. Na etapa Configurar, clique em Gerenciar conhecimento.
  2. A janela Gerenciar conhecimento será exibida. Clique no ícone .
  3. Selecione Indexar páginas da web no menu suspenso.
  4. Um painel lateral será exibido.
  5. Insira a URL que deseja indexar.
  6. Se desejar que o sistema inclua automaticamente as subpáginas, ative Escanear todas as subpáginas desta URL.
  7. Clique em Escanear URL.
  8. O sistema escaneará a URL e recuperará os dados, caso você tenha optado por escanear todas as subpáginas.

Quando o escaneamento for concluído, as URLs detectadas serão exibidas na lista.

Nesse momento, o conteúdo do site terá apenas sido escaneado e listado para revisão. Ele ainda não terá sido adicionado à base de conhecimento no nível do agente. Em seguida, você poderá:

  • Adicionar selecionados: adiciona as URLs selecionadas à base de conhecimento no nível do agente.
  • Excluir selecionados: remove as URLs selecionadas da lista.

Importante: o agente de IA só poderá consultar o conteúdo do site depois que você adicionar as URLs selecionadas à base de conhecimento. Se você não adicionar as URLs selecionadas, o conteúdo não será processado nem utilizado nas respostas do agente.

 

Depois de selecionar as URLs que deseja utilizar, clique em Salvar e processar para adicioná-las à base de conhecimento no nível do agente.

 

Pesquisa na web

A pesquisa na web permite que o agente de IA consulte informações de sites específicos em tempo real.

Em vez de depender apenas de conteúdos enviados ou indexados, o agente pode usar a pesquisa na web para buscar informações nos domínios ou URLs que você autorizar ao responder às perguntas dos clientes.

Quando usar a pesquisa na web

A pesquisa na web é mais indicada quando as informações que o agente de IA precisa consultar podem mudar com frequência e devem permanecer atualizadas.

Esse recurso é útil para conteúdos como:

  • Páginas de produtos ou serviços atualizadas regularmente
  • Conteúdos de sites que mudam com frequência
  • Informações públicas que o agente precisa consultar em tempo real

Use essa opção quando quiser que o agente de IA pesquise as informações mais recentes em sites autorizados, em vez de depender apenas de fontes de conhecimento usadas no treinamento.

 

Adicionar sites para pesquisa na web

Observação: ao adicionar uma URL ou um domínio para pesquisa na web, o agente de IA poderá consultar conteúdos de todo esse site. Não é possível incluir ou excluir páginas específicas dentro da URL informada.

 

Siga as etapas abaixo para adicionar sites para pesquisa na web:

  1. Na etapa Configurar, clique em Gerenciar conhecimento.
  2. A janela Gerenciar conhecimento será exibida. Clique no ícone .
  3. Selecione Pesquisa na web em tempo real no menu suspenso.
  4. Um painel lateral será exibido.
  5. Insira o domínio ou a URL que deseja permitir que o agente de IA consulte.
  6. Clique em Adicionar fonte.
  7. Depois que a URL for adicionada, ela será exibida na lista de sites em Pesquisa na web.

 

Nessa lista, você pode:

  • Revisar os sites adicionados para pesquisa na web.
  • Selecionar um ou mais sites.
  • Excluir os sites selecionados caso eles não sejam mais necessários.

Depois de revisar a lista, clique em Salvar e processar para continuar.

Como a pesquisa na web é utilizada

A pesquisa na web não treina o conteúdo dos sites na base de conhecimento do agente de IA. Em vez disso, durante as conversas, o agente analisa o conteúdo do site e recupera informações do domínio adicionado em tempo real.

Como o conteúdo é obtido em tempo real, o tempo de resposta pode ser maior em comparação com conteúdos previamente indexados.

 

 

Respostas personalizadas

As respostas personalizadas permitem criar respostas predefinidas para perguntas frequentes dos clientes.

Em vez de depender de documentos enviados ou de sites indexados, você pode definir diretamente como o agente de IA deve responder a perguntas específicas. Quando um cliente fizer uma pergunta semelhante, o agente de IA poderá retornar a resposta predefinida.

As respostas personalizadas são organizadas em conjuntos de perguntas relacionadas que compartilham uma única resposta.

Quando usar respostas personalizadas

As respostas personalizadas são mais indicadas para informações curtas e objetivas que devem sempre retornar uma resposta consistente, como:

  • Horário de funcionamento
  • Localização das lojas
  • Informações de contato
  • Políticas básicas
  • Perguntas frequentes

Você pode adicionar várias perguntas de treinamento que correspondam à mesma resposta, permitindo que o agente de IA reconheça diferentes formas de os clientes fazerem a mesma pergunta.

Adicionar uma resposta personalizada

Siga as etapas abaixo para criar uma resposta personalizada:

  1. Na etapa Configurar, clique em Gerenciar conhecimento.
  2. A janela Gerenciar conhecimento será exibida. Clique no ícone .
  3. Selecione Respostas personalizadas no menu suspenso.
  4. Um painel lateral será exibido.
  5. Preencha as seguintes informações:
    1. Pergunta: insira a principal pergunta do cliente. Por exemplo: Qual é o horário de funcionamento da empresa?
    2. Variações da pergunta: insira outras formas pelas quais os clientes podem fazer a mesma pergunta. Clique em Adicionar variação para incluir mais variações.
    3. Resposta: insira a resposta predefinida que o agente de IA deverá fornecer quando um cliente fizer essa pergunta ou uma variação semelhante.
  6. Depois de preencher os campos, clique em Adicionar resposta personalizada.

Depois de adicionada, a resposta personalizada será exibida na lista. Você pode adicionar mais respostas personalizadas preenchendo os campos novamente. Quando concluir, clique em Salvar e processar.

 

Gerenciar respostas personalizadas

Depois de criar respostas personalizadas, você poderá gerenciá-las na lista.

Você pode:

  • Visualizar os conjuntos de respostas personalizadas existentes.
  • Selecionar um ou mais conjuntos.
  • Excluir os conjuntos selecionados, caso eles não sejam mais necessários.

Cada conjunto exibe o número de perguntas de treinamento associadas a ele.

 

Base de conhecimento global

Você pode adicionar fontes existentes da Base de conhecimento global da sua organização à base de conhecimento no nível do agente.

O painel Base de conhecimento global é dividido em duas abas:

  • Atribuídas: exibe as fontes que já foram adicionadas à base de conhecimento deste agente de IA.
  • Biblioteca não atribuída: exibe as fontes disponíveis na Base de conhecimento global da organização que ainda não estão atribuídas a este agente de IA.

Na aba Biblioteca não atribuída, você pode:

  • Pesquisar fontes por título ou conteúdo.
  • Filtrar as fontes por tipo ou status.
  • Visualizar o nome, o tipo e o status de processamento de cada fonte.
  • Selecionar uma fonte para visualizar seu conteúdo.
  • Clicar no ícone para adicionar uma fonte à base de conhecimento no nível do agente.

Depois que uma fonte for atribuída, o agente de IA poderá consultá-la ao responder aos clientes.

Observação: atribua apenas fontes relevantes para a finalidade deste agente. Isso ajuda a manter as respostas focadas e reduz a chance de o agente consultar informações não relacionadas.

 

 

Entender o processamento das fontes e dos artigos gerados

Depois que você adiciona uma fonte, a SleekFlow processa e indexa seu conteúdo em segundo plano. Dependendo da fonte e do recurso de IA utilizado, a SleekFlow pode gerar artigos a partir desse conteúdo.

Os artigos gerados são criados após a ingestão da fonte. Eles estruturam e organizam o conteúdo ingerido em um formato que o agente consegue consultar com mais eficiência, além de facilitar a revisão do conhecimento pela sua equipe.

Se um artigo gerado ainda não estiver pronto, o agente poderá consultar diretamente o material enviado. Assim que o artigo gerado estiver disponível, o agente passará a consultá-lo.

Observação: o processamento das fontes e a geração dos artigos ocorrem em segundo plano. Enquanto isso, você pode continuar configurando, testando ou implantando o agente.

 

 

Permitir que o agente consulte propriedades de contato

Você pode permitir que o agente de IA acesse propriedades de contato específicas para personalizar as respostas.
 


 

Para configurar o acesso às propriedades de contato:

  1. Em Acesso aos dados do cliente, clique em Adicionar propriedade.
  2. Selecione as propriedades de contato que o agente poderá consultar.
  3. Clique em Salvar propriedades.

 

Definir a prioridade das respostas

A prioridade das respostas controla como o agente equilibra velocidade e qualidade.

Você pode escolher entre três opções:

  • Ultrarrápido: prioriza a velocidade para fornecer respostas rápidas.
  • Equilibrado: equilibra velocidade e precisão das respostas.
  • Alta qualidade: prioriza respostas mais detalhadas e precisas.

 

Configurar o estilo e o ritmo das respostas

Esta seção inclui configurações que afetam a forma como as respostas são apresentadas no chat. Você pode usá-las para tornar respostas longas mais fáceis de ler e mais naturais antes de implantar o agente.

 

Divisão semântica de mensagens (ritmo semelhante ao humano)

A Divisão semântica de mensagens (ritmo semelhante ao humano) divide automaticamente respostas longas da IA em várias mensagens menores, com base em pausas naturais da conversa. Isso torna as respostas mais fáceis de ler e proporciona uma experiência mais natural no chat.

Quando esse recurso está habilitado, ele ajuda você a:

  • Tornar respostas longas mais fáceis de ler.
  • Criar uma experiência de conversa mais natural.
  • Melhorar a legibilidade em conversas de suporte e vendas.

Basta ativar esse recurso na etapa de configuração do agente. Quando essa configuração estiver habilitada, o agente enviará respostas longas compatíveis como várias mensagens curtas, em vez de uma única mensagem extensa.

Essa configuração altera apenas a forma como a resposta é entregue. Ela não altera as fontes de conhecimento, a lógica do Playbook nem o conteúdo da resposta gerada pelo agente.

 

Escrever o Playbook

O Playbook define como o agente de IA deve conduzir as conversas com os clientes.

O Playbook define como o agente de IA deve conduzir as conversas com os clientes.

Use o Playbook para orientar a forma como o agente responde em diferentes cenários, o tom que deve utilizar, o que deve evitar e quais ações pode executar durante uma conversa.

O cartão Playbook inclui duas abas:

  • Seu Playbook: um editor de texto livre no qual você pode escrever instruções em linguagem natural.
  • Playbook otimizado: uma versão refinada do Playbook organizada em seções editáveis, facilitando a atualização das instruções com campos estruturados para configurar o agente de IA de acordo com as necessidades do seu negócio.
     

Você pode continuar usando a aba Seu Playbook como fonte editável e permitir que a SleekFlow o otimize automaticamente ao testar ou implantar o agente. Também é possível editar e salvar manualmente a versão do Playbook otimizado caso deseje ter mais controle sobre as instruções estruturadas que o agente de IA utiliza.

Observação: não é necessário editar manualmente a aba Playbook otimizado para que o agente funcione. Se você continuar usando a aba Seu Playbook, a SleekFlow otimizará automaticamente a versão mais recente do Playbook durante os testes ou a implantação.

 

 

Escrever instruções em Seu Playbook

se Seu Playbook se preferir gerenciar o Playbook em formato de texto livre.

Ao escrever o Playbook, considere incluir instruções como:

  • Tom e estilo de comunicação: defina como o agente deve se comunicar com os clientes, por exemplo, de forma amigável, profissional ou objetiva.
  • Instruções gerais: descreva a função geral do agente de IA e como ele deve ajudar os clientes.
  • O que o agente deve evitar: defina restrições, como evitar especulações, não fornecer informações sem confirmação ou encaminhar determinadas solicitações.
  • Tratamento de cenários: forneça instruções sobre como o agente deve responder em situações específicas, como solicitações de reembolso, dúvidas sobre produtos ou agendamentos. Você também pode definir quais informações o agente deve coletar em cada cenário, como número do pedido, preferências de produto ou detalhes do agendamento.

Se você selecionou um modelo na Etapa 1, o Seu Playbook já incluirá instruções predefinidas. Você poderá revisá-las e editá-las conforme as necessidades do seu negócio.
 

O Playbook deve conter pelo menos 50 caracteres antes que possa ser salvo.

Quando você testar ou implantar o agente, a SleekFlow otimizará automaticamente a versão mais recente do conteúdo em Seu Playbook antes de prosseguir. Você poderá continuar editando Seu Playbook posteriormente. Sempre que testar ou implantar o agente novamente, a SleekFlow otimizará a versão mais recente.

Dica: use essa opção se preferir manter um único Playbook em formato livre e deixar que a SleekFlow faça a otimização com IA automaticamente.

 

 

Usar o Playbook otimizado

A aba Playbook otimizado apresenta o Playbook em seções estruturadas e editáveis. Isso permite ajustar partes específicas do Playbook sem precisar reescrever toda a versão em texto livre.

Use a aba Playbook otimizado quando quiser ter um controle mais preciso sobre as instruções que o agente de IA utiliza.

A aba Playbook otimizado inclui as seguintes seções:

  • Personalidade: define a função, o tom e o estilo de comunicação do agente.
  • Comportamento: define as regras gerais de comportamento que o agente deve seguir durante as conversas.
  • Resposta para tipo de mídia não compatível: define a resposta utilizada quando o agente recebe um tipo de mensagem que não consegue processar.
  • Proteções: define as situações que o agente deve identificar e como deve responder a elas.
  • Cenários: contém instruções específicas para cada cenário. Cada cenário é exibido como um cartão editável com título, gatilho e instruções.

Se o Playbook de origem estiver vazio ou contiver menos de 50 caracteres, a aba Playbook otimizado exibirá um estado vazio. Volte para Seu Playbook e adicione conteúdo suficiente antes de continuar.

 

Editar o Playbook otimizado

Para editar o Playbook otimizado:

  1. Abra a aba Playbook otimizado.
  2. Edite as seções estruturadas que deseja atualizar.
  3. Clique em Salvar.

     

Before you save manual edits for the first time, the original Playbook remains editable.

 

Salvar alterações no Playbook otimizado

Ao clicar em Salvar pela primeira vez após editar o Playbook otimizado, será exibida uma janela de confirmação.

Essa janela informa que, ao aplicar as alterações, o Playbook original deixará de ser editável.

Você pode:

  • Clicar em Cancelar para voltar sem salvar.
  • Clicar em Salvar para aplicar o Playbook otimizado.

Aviso: salvar edições manuais na aba Playbook otimizado é uma alteração irreversível. Depois de salvar, Seu Playbook se tornará permanentemente somente leitura. Você ainda poderá visualizar e copiar o conteúdo original do Playbook, mas não poderá mais editá-lo.

 

Depois que o Playbook otimizado for salvo, todas as alterações futuras deverão ser feitas nessa aba.

Sempre que você fizer novas alterações na aba Playbook otimizado, um banner será exibido para indicar que há alterações não salvas. Clique em Salvar para aplicá-las.

Se a SleekFlow não conseguir otimizar o Playbook, uma mensagem de erro será exibida. Clique em Tentar novamente para gerar o Playbook otimizado novamente.

 

Usar comandos no Playbook

O editor do Playbook oferece suporte a comandos com barra (/), que permitem inserir ações estruturadas diretamente no fluxo da conversa.

Esses comandos permitem que o agente de IA execute ações como:

  • Aplicar rótulos

Para inserir um comando:

  1. Digite / no editor do Playbook.
  2. Selecione a ação que deseja inserir na lista de comandos.

Na aba Playbook otimizado, você pode visualizar os comandos que já foram adicionados em Seu Playbook, mas ainda não é possível adicionar novas ações usando comandos com barra. Se quiser que o agente execute uma ação na aba Playbook otimizado, descreva a ação desejada em linguagem natural.
 

Observação: o Playbook deve conter uma quantidade mínima de conteúdo antes que o agente de IA possa ser testado.

 

O Playbook define como o agente de IA deve conduzir as conversas com os clientes.

 

Referenciar uma fonte de conhecimento específica com /source

Você pode usar /source no Playbook para instruir o agente de IA a utilizar um arquivo específico da base de conhecimento em determinadas instruções.

Para adicionar uma fonte como ação:

  1. No editor do Playbook, digite  /source
  2. Uma lista das fontes de dados existentes será exibida.
  3. Selecione a fonte de dados na janela exibida.
  4. Clique em Inserir.

Esse recurso é útil quando:

  • O agente precisa consultar um documento específico em um determinado cenário.
  • Você deseja obter respostas mais controladas e consistentes.

Exemplo:

Use um arquivo de política de reembolso para garantir que todas as respostas relacionadas a reembolsos utilizem a mesma fonte de informação.
 

Usar comandos do Shopify no Playbook

Se sua empresa tiver o Shopify conectado à SleekFlow, você poderá adicionar comandos do Shopify no Playbook para definir quando o agente de IA deverá executar ações relacionadas ao Shopify.

Isso permite que você:

  • Controle quando o agente consulta informações de produtos.
  • Defina como o agente deve lidar com ações relacionadas ao carrinho de compras.
  • Garanta um tratamento consistente para consultas relacionadas à loja.

Observação: para usar comandos do Shopify no Playbook, é necessário conectar pelo menos uma loja do Shopify à SleekFlow.

Se o Shopify ainda não estiver conectado:

  • Os comandos do Shopify serão exibidos em vermelho no editor do Playbook.
  • Clique no comando para abrir a janela de conexão.
  • Conclua a conexão com o Shopify.
  • Retorne ao Playbook para continuar a configuração.

Consulte este artigo da Central de Ajuda para saber mais sobre como conectar a integração do Shopify à SleekFlow.

 

 

Ações disponíveis no Shopify

O agente de IA pode usar as seguintes ações do Shopify durante as conversas:

Ação O que faz Use quando...
search_products Encontra produtos correspondentes na sua loja do Shopify e retorna detalhes relevantes dos produtos. Os clientes estão navegando, pedindo recomendações ou comparando produtos.
view_product_details Recupera informações detalhadas sobre um produto específico, incluindo variantes (como tamanho ou cor). Os clientes solicitam mais detalhes sobre um produto específico.
view_cart Recupera o carrinho atual, incluindo itens, opções de envio, descontos e o link para finalização da compra. Os clientes desejam revisar o carrinho ou prosseguir para o checkout.
create_or_update_cart Cria um novo carrinho ou atualiza um carrinho existente, incluindo adicionar ou remover itens, atualizar quantidades, aplicar descontos e adicionar informações de envio. Os clientes adicionam itens ao carrinho, modificam o carrinho ou se preparam para finalizar a compra.
search_store_info Recupera informações da loja, como política de devolução, política de envio, horário de funcionamento e informações de contato. Os clientes fazem perguntas sobre políticas, informações da loja ou perguntas frequentes.

 

Calcular a pontuação de lead (opcional)

Você pode habilitar Calcular pontuação de lead para avaliar a intenção dos clientes durante as conversas.

Quando esse recurso estiver habilitado, o agente atribuirá uma pontuação com base nos critérios definidos por você.

 

Para configurar a pontuação de lead:

  1. Ative a opção Calcular pontuação de lead.
  2. Clique no ícone para configurar as regras de pontuação.
  3. Um painel lateral será exibido.

Os campos do painel lateral já vêm preenchidos com critérios sugeridos. Você pode editá-los e ajustar os pesos de acordo com as necessidades do seu negócio.

Você pode definir os critérios de pontuação usando os seguintes campos:

  • Peso da pontuação de lead (%): informe o peso de cada critério. O peso determina o quanto esse critério contribui para a pontuação final.
  • Critérios: descreva os sinais que o agente de IA deve avaliar ao atribuir uma pontuação. Por exemplo, se o lead está perguntando sobre recursos do produto, comparando opções ou demonstrando intenção de compra.

Você também pode clicar em Adicionar critério para incluir condições adicionais de pontuação.

Observação: o peso total de todos os critérios deve somar 100% antes que a configuração possa ser salva.

 

Se desejar restaurar o conteúdo sugerido originalmente, clique em Usar padrão, no canto superior direito.

Depois de configurar os critérios, clique em Salvar, no canto superior direito, para aplicar as regras de pontuação de lead.

Depois de habilitado, o agente de IA calculará automaticamente a pontuação de lead durante as conversas com base nos critérios definidos. A pontuação de lead ajuda sua equipe a identificar leads com maior potencial e priorizar as ações de acompanhamento.

 

Testar o agente no Playground de testes

O Playground de testes permite testar o agente de IA e revisar como as respostas são geradas antes da implantação.

O painel de testes é exibido no lado direito da página de configuração.

Os testes ficam disponíveis depois que:

  • Você adicionar pelo menos uma fonte à base de conhecimento no nível do agente.
  • O Playbook contiver pelo menos 50 caracteres.

Durante os testes, o agente de IA utilizará a versão mais recente das Configurações otimizadas.

Se as fontes de dados ainda estiverem sendo processadas, o teste por chat poderá continuar disponível. O agente poderá consultar o material enviado enquanto os artigos gerados estiverem sendo preparados. Assim que esses artigos estiverem prontos, as respostas poderão passar a consultá-los.

 

Testar respostas por chat

Depois de adicionar pelo menos uma fonte de conhecimento e configurar o Playbook, você poderá usar a interface de testes por chat para simular conversas com o agente de IA.

 

Para testar respostas:

  1. Clique em Testar respostas por chat.
  2. Use uma das sugestões de início de conversa ou digite sua própria mensagem.
  3. Na tela de testes por chat, você verá as seguintes informações:
    1. Resposta do agente de IA
      1. O cartão principal de resposta mostra como o agente de IA responderia à mensagem do cliente.
      2. Isso permite verificar se a resposta é precisa, clara e está alinhada ao comportamento definido no Playbook.
  4. Ações executadas
    1. A seção Ações executadas mostra as etapas que o agente de IA realizou antes de gerar a resposta.
    2. Isso pode incluir ações como:
      1. Pesquisar na base de conhecimento.
      2. Chamar uma integração ou API.
      3. Calcular a pontuação de lead, quando esse recurso estiver habilitado.
    3. Essa seção ajuda você a entender como o agente de IA chegou à resposta.
  5. Fontes
    1. A seção Fontes mostra quais fontes de conhecimento foram utilizadas na resposta.
    2. Para cada fonte, é possível visualizar:
      1. O nome do arquivo.
      2. Um pequeno trecho de texto utilizado pelo agente de IA.
      3. Isso ajuda a verificar se a resposta está fundamentada na fonte correta.
  6. Feedback da resposta
    1. Abaixo da resposta, você pode indicar se a resposta gerada corresponde às suas expectativas.
    2. Use esse recurso para avaliar rapidamente a qualidade das respostas durante os testes.
  7. Perguntas de acompanhamento sugeridas
    1. O painel de chat também pode exibir perguntas de acompanhamento sugeridas com base na conversa.
    2. Você pode clicar nessas sugestões para continuar testando como o agente de IA responde a perguntas relacionadas.
  8. Campo de entrada de mensagens
    1. Na parte inferior do painel, você pode inserir novas mensagens para continuar a conversa e testar diferentes cenários.
    2. Isso permite simular conversas com múltiplas interações e avaliar como o agente de IA responde ao longo de toda a conversa.

 

Executar uma rodada de teste de respostas

A Rodada de teste de respostas permite avaliar o nível de confiança com que o agente de IA responde a um conjunto de perguntas de teste geradas automaticamente com base nas suas fontes de conhecimento.

Em vez de testar uma mensagem por vez, esse recurso gera várias perguntas a partir do conhecimento enviado e as executa no agente de IA. Assim, você pode identificar rapidamente os tópicos em que o agente responde bem e aqueles que precisam de melhorias antes da implantação.

Para executar uma rodada de teste de respostas:

  1. No Playground de testes, clique em Executar rodada de teste de respostas.
  2. Selecione o idioma do teste.
  3. Clique em Executar teste de desempenho.
  4. Depois que o teste for concluído, você poderá revisar os resultados das seguintes maneiras:
    1. Pontuação geral de confiança
      1. Na parte superior da página de resultados, você verá a pontuação geral de confiança da rodada de teste.
      2. Esse resumo mostra o desempenho geral do agente de IA em todas as perguntas geradas, incluindo o número de respostas em cada categoria de confiança.
    2. Categorias de confiança
      1. Os resultados do teste são agrupados em categorias de confiança, como:
        1. Excelente
        2. Precisa de atenção
      2. Isso ajuda a identificar rapidamente quais respostas apresentam bom desempenho e quais precisam ser melhoradas.
  5. Resultados individuais dos testes
    1. Cada resultado de teste exibe:
      1. A pergunta de teste gerada.
      2. A resposta do agente de IA.
      3. A pontuação de confiança dessa resposta.
      4. A fonte de conhecimento utilizada para gerar a pergunta.
    2. Isso permite revisar como o agente de IA respondeu a cada pergunta e verificar se a resposta está fundamentada na fonte esperada.

Depois de concluir a configuração e os testes do agente de IA, clique em Salvar, no canto superior direito, para prosseguir para a Etapa 3.

 

Etapa 3: Implantar o agente de IA

Depois de configurar e testar o agente de IA, você poderá implantá-lo para que ele comece a responder às conversas dos clientes.

Nesta etapa, você irá:

  • Selecionar o canal em que o agente de IA deverá responder.
  • Definir, opcionalmente, quando o agente poderá responder.
  • Configurar condições de saída que determinam quando o agente deve parar de responder. Nesta etapa, você também poderá adicionar ações de acompanhamento para definir como a conversa deverá ser tratada após o agente de IA sair da conversa.

 

Selecionar o canal

Primeiro, escolha o canal no qual o agente de IA receberá e responderá às mensagens.

Para configurar:

  1. Na etapa Implantar, localize a seção Canal.
  2. Selecione o canal na lista suspensa.
  3. Isso define o canal em que o agente de IA tratará as mensagens recebidas.

Observação: é necessário selecionar pelo menos um canal antes de implantar o agente de IA.

 

 

Definir um horário específico para resposta (opcional)

Você pode controlar quando o agente de IA poderá responder aos clientes ativando Definir horário específico para resposta.

Para configurar o horário de resposta:

  1. Ative Definir horário específico para resposta.
  2. Selecione os dias da semana em que o agente de IA deverá ficar ativo.
  3. Defina os horários De e Até.

Isso permite controlar quando o agente de IA poderá responder. Por exemplo, você pode optar por ativá-lo apenas fora do horário comercial.

O sistema oferece suporte a períodos que atravessam a meia-noite, como das 18h00 às 9h00.

 

Configurar condições de saída

A seção Quando sair permite definir as condições que determinam quando o agente de IA deve parar de responder em uma conversa.

Por padrão, o agente de IA inclui condições de saída predefinidas para cenários comuns. Essas condições determinam quando ele deve interromper a conversa.

As condições de saída padrão incluem:

  • Baixa confiança: quando a confiança da resposta do agente de IA é baixa.
  • Tempo esgotado: quando a conversa permanece inativa por determinado período.
  • Agente humano assume a conversa: quando um agente humano entra na conversa.
  • Erro do sistema: quando o agente de IA encontra um erro do sistema.

Você pode revisar e editar essas condições de saída conforme as necessidades do seu negócio.

Para configurar uma condição de saída:

  1. Localize a seção Quando sair.
  2. Abra a condição de saída desejada.
  3. Defina os critérios de acionamento.
  4. Opcionalmente, adicione uma ação de acompanhamento para ser executada após a saída do agente de IA.

As ações de acompanhamento definem o que acontecerá depois que o agente parar de responder. Na página de implantação, você pode configurar um conjunto limitado de ações, como:

  • Atribuir a conversa a um membro da equipe.
  • Adicionar rótulos à conversa para acompanhamento ou categorização.

Se precisar de uma lógica de saída mais avançada ou de ações adicionais, você poderá continuar editando o fluxo gerado posteriormente no Flow Builder.

Você também pode clicar em Adicionar condição de saída para configurar regras adicionais.

Essas condições ajudam a garantir que as conversas sejam encerradas ou transferidas adequadamente quando o agente de IA não puder mais prestar assistência.

 

Definir o público-alvo da implantação

Você pode limitar quem poderá interagir com o agente de IA durante a implantação. Isso permite testar o agente com um público menor antes de disponibilizá-lo para todos.

Para definir um público-alvo:

  1. Em Público-alvo, selecione Público personalizado.
  2. Clique em Adicionar condição.
  3. Escolha um tipo de condição:
    1. Número de telefone
    2. Palavra-chave
    3. Rótulo do contato
  4. Insira os valores da condição.

 

Implantar o agente de IA

Depois que o canal e as configurações opcionais estiverem definidos:

  1. Clique em Salvar e implantar, no canto superior direito.

Após a implantação:

  • O agente de IA ficará ativo.
  • O agente começará a responder às conversas no canal selecionado.
  • Você será redirecionado para a lista de agentes de IA.
  • O sistema criará automaticamente um fluxo correspondente no Flow Builder.

O fluxo gerado poderá ser utilizado para configurações mais avançadas, como refinar a lógica de saída ou adicionar ações que não estão disponíveis na página de implantação.

Você poderá retornar posteriormente para atualizar a configuração do agente ou ajustar as configurações de implantação, se necessário.

 

Gerenciar um agente de IA existente

Pré-requisito

O agente de IA deve estar ativo no AgentFlow para que possa ser gerenciado ou atualizado.

Na página da lista do AgentFlow, um agente ativo:

  • Exibe Editar como ação principal.
  • Mostra Fluxos ativos em uso: X fluxos no cartão do agente.

 

 

 

Depois de criar e implantar um agente de IA, você poderá voltar a qualquer momento para atualizar sua configuração, testar novamente as respostas ou ajustar as configurações de implantação.

Para gerenciar um agente de IA existente:

  1. Clique no ícone na barra de navegação esquerda para acessar a página IA da SleekFlow.
  2. Na aba AgentFlow, localize o agente que deseja gerenciar.
  3. No cartão do agente, você poderá:
    1. Editar o agente de IA clicando em Editar.
    2. Excluir o agente de IA clicando no ícone.

 

Atualizar a configuração e os testes

Na etapa Configurar, você pode:

  • Adicionar, remover ou atualizar fontes na base de conhecimento no nível do agente.
  • Atualizar as instruções do Playbook.
  • Ajustar a prioridade das respostas e as configurações de comportamento.
  • Atualizar as configurações de pontuação de lead, quando esse recurso estiver habilitado.
  • Executar novamente os testes por chat e as rodadas de teste de respostas antes de salvar as alterações.

 

Gerenciar condições de saída

Na aba Saída, você pode gerenciar as condições globais de saída do agente de IA e as ações de acompanhamento.

Você pode:

  • Adicionar uma nova condição de saída.
  • Editar uma condição de saída existente.
  • Excluir uma condição de saída existente. Observe que, ao excluir uma condição de saída, ela será removida de todos os fluxos existentes.
  • Atualizar as ações de acompanhamento relacionadas ao tratamento da saída.

 

Importante: se você adicionar uma nova condição de saída, será necessário confirmar se deseja reimplantar o agente de IA:

  • Salvar e pausar fluxos
  • Salvar e publicar fluxos
 

Outras alterações, como editar ou excluir condições de saída existentes, serão aplicadas sem necessidade de reimplantação.

 

Atualizar as configurações de implantação

Na etapa Implantar, você pode:

  • Alterar o canal conectado.
  • Atualizar a programação de respostas.
  • Revisar e editar as condições de saída.
  • Ajustar as ações de acompanhamento disponíveis na configuração da implantação.

Depois de fazer as alterações, clique em Salvar e implantar para aplicá-las.

Na aba Implantar, você pode visualizar as implantações atuais do agente de IA e criar ou atualizar fluxos de acordo com o tipo de implantação.

 

Criar um novo fluxo

Para implantar o agente de IA em um fluxo adicional, crie um novo fluxo na aba Implantar e conclua a configuração da implantação.

Dependendo do tipo de implantação, você poderá configurar opções como:

  • Canal conectado.
  • Programação de respostas.

Depois de configurar o fluxo, clique em Salvar e implantar para aplicar a implantação.

 

Atualizar um fluxo existente

Para uma implantação existente que não seja gerenciada pelo Flow Builder, você poderá:

  • Alterar o canal conectado.
  • Atualizar a programação de respostas.

Depois de fazer as alterações, clique em Salvar e implantar para aplicá-las.

 

Implantação gerenciada pelo Flow Builder

Para implantações gerenciadas no Flow Builder, as configurações de implantação não podem ser editadas diretamente no AgentFlow.

 

 

Campos que não podem ser editados

Os campos abaixo só podem ser definidos quando o agente de IA é criado pela primeira vez:

  • Nome do agente
  • Descrição

Se precisar usar um nome ou uma descrição diferentes, crie um novo agente de IA.