Inteligencia artificial

Agente de IA em Kommo

AI Agent é um assistente que automatiza tarefas rotineiras e ajuda sua equipe de vendas a trabalhar com mais eficiência. Usando tecnologias de inteligência artificial, o widget se encarrega de processar solicitações recebidas e qualificar leads de acordo com parâmetros especificados.

Recursos

Saudação automática de clientes
Pré-qualificação de leads
Redirecionando perguntas difíceis
Preenchendo campos de lead
Gerenciamento de banco de dados de conhecimento
Integração com Telegram

Guia de instalacao e configuracao

Guia detalhado para trabalhar com o widget "Agente de IA em Kommo"

CONTEUDO

  1. Configuração de widget
  2. Comportamento do agente
  3. Informações para especialistas
  4. Gerenciamento da base de conhecimento
  5. Importar por URL
  6. Importação em segundo plano
  7. Pesquisa na web
  8. Obtenção de informações de fontes externas usando um link
  9. APIs externas
  10. Nenhuma resposta especializada
  11. Consultor de IA para Telegram
  12. Um exemplo de como o widget funciona
  13. Exemplo de preenchimento de campos

Configuração de widget

Para começar a trabalhar com o agente, precisamos escrever instruções para ele, para isso precisamos ir para as configurações do widget

Estrutura de configurações do widget

As configurações do widget são divididas em várias seções por conveniência:

1. Configurações básicas

  • Gerenciamento da base de conhecimento - botão para abrir a interface de gerenciamento da base de conhecimento (adicionar, editar, importar documentos)
  • Seleção de modelo de IA - Selecione um modelo para gerar respostas. Vários modelos estão disponíveis com diferentes preços e qualidade de respostas
  • Adicionar suporte para pesquisa na web - habilite para que o agente possa pesquisar informações relevantes na Internet e seguir links de instruções

2. Comportamento do agente

  • Caráter da comunicação - Descreva o tom e o estilo de comunicação do agente. Exemplo: "Amigável e profissional. Dirija-se como 'Você'. Use emoji com moderação."
  • Regras Gerais - especifique as regras para todas as caixas de diálogo. Exemplo: “Não discuta concorrentes. Não prometa descontos sem aprovação. Verifique sempre o orçamento do cliente”.
  • Exemplos de respostas - Adicione exemplos de como o agente deve responder. Exemplo: “✅ Bom: 'Agora vou esclarecer para você!' ❌ Ruim: 'Não sei'"

3. Instruções

Nas instruções gerais você deveescrever informações gerais para o agente, por exemplo, o que sua empresa faz, em que cidade você está e quais produtos ela oferece

Instruções adicionais devem indicar ações específicas para o agente. Cada instrução consiste em um título e um texto de instrução. Essas instruções podem ser selecionadas nas configurações do gatilho para reutilização em diferentes cenários

  • Exemplo de instruções para vendas: Título: “Trabalhando com objeções”, Texto: “Se o cliente disser que é caro, descubra seu orçamento e ofereça opções alternativas”
  • Exemplo de instruções para suporte: Título: “Problemas técnicos”, Texto: “Em caso de problemas técnicos, colete informações: o que exatamente não funciona, quando o problema começou, quais ações o cliente tomou”

4. Consultor de IA para Telegram

  • Ativar consultor de IA - ativa o comando /ask no Telegram para aconselhar sua equipe sobre a base de conhecimento
  • Instruções para um consultor - instruções especiais que determinam como o consultor deve ajudar a equipe. Se não for especificado, funciona sem instruções adicionais
  • IDs de chat do Telegram - lista de IDs de chat onde o consultor trabalhará. O comando /ask funciona SOMENTE em chats desta lista

5. Informações para especialistas

  • Selecione os campos de leads, contatos e empresas que serão mostrados ao especialista ao enviar uma pergunta
  • Exemplo: selecione “Telefone”, “E-mail”, “Orçamento da Lead”, “Fonte” – essas informações ajudarão o especialista a entender rapidamente o contexto
  • Se você não selecionar os campos, o especialista verá apenas informações padrão

Se necessário, você pode adicionar muitas instruções para o agente
Depois de terminar de escrever as instruções, você precisa salvar as configurações

Em seguida, você precisa acessar as configurações do pipeline e adicionar uma fonte de lead

Em seguida, você precisa criar um bot:

  • no estágio necessário, clique em +Adicionar gatilho
  • +Vendasbot
  • Nas configurações do gatilho, clique em +Criar um novo bot

Na janela de edição do bot, selecione Widgets

Selecione agente de IA

Em seguida, clique no botão editar

Configurando campos de acionamento

Os seguintes campos estão disponíveis nas configurações do gatilho:

  • Tarefa é o campo principal. Descreva a tarefa que o agente deve realizar durante uma conversa com um cliente. Exemplo: "Pergunte ao cliente sobre seu orçamento, prazo e requisitos do produto. Após coletar as informações, vá para a saída 'qualificada'"
  • Agente não deve responder - Se você ativar esta opção, o agente selecionará apenas uma saída (gatilho) sem enviar respostas ao cliente. Útil para roteamento automático sem comunicação

Seção "Função e regras" (configurações opcionais):

  • Função - Defina a função do agente neste cenário específico. Exemplo: “Você é um gerente de vendas que ajuda um cliente a escolher a tarifa adequada”
  • Regras do cenário - Especifique regras específicas para este cenário. Exemplo: "Não ofereça descontos superiores a 10% sem aprovação. Certifique-se de especificar a cidade de entrega"
  • Modelos - você pode usar modelos preparados e alterá-los para atender às suas necessidades

Seção "Configurações adicionais":

  • Instruções - selecione uma ou mais instruções adicionais daquelas criadas anteriormente nas configurações do widget. Isso permite reutilizar instruções comuns em diferentes gatilhos
  • Bate-papo por telegrama com especialista - especifique um link para o chat onde o agente enviará perguntas caso não saiba a resposta. Para obter o ID do chat use @nova_aiagent_bot

Seção "Passar campos ao agente":

  • Ativar transferência de campo - ative para que o agente possa ver informações dos campos lead, contato e empresa
  • Se não selecionar campos específicos, o agente receberá todos os campos personalizados não vazios + campos padrão básicos (cargo, orçamento, ID)
  • Se você selecionar campos específicoso agente receberá apenas os campos especificados. Exemplo: selecione "Telefone de contato", "Cidade", "Fonte da lead"

Seção “Se não houver resposta do cliente”:

  • Tempo de espera (minutos) — especifique quantos minutos esperar pela resposta do cliente. Exemplo: 60
  • Instruções de lembrete - o que o agente deve fazer se o cliente não responder. Exemplo: "Escreva: 'Boa tarde! Lembro que estou aguardando sua resposta sobre a questão da escolha da tarifa. Estou pronto para ajudar!'"

Seção "Preencher os campos":

  • Ativar preenchimento – o agente preencherá automaticamente os campos do lead com base nas respostas do cliente
  • Por padrão, todos os campos disponíveis são preenchidos
  • Você pode selecionar campos específicos para preencher. Exemplo: selecione "Orçamento", "Prazo", "Requisitos"
  • Não alterar se preenchido - habilite para cada campo para não substituir valores já preenchidos

Acionadores de saída:

  • Primeiro, crie saídas (os resultados do agente). Exemplo: “Qualificado”, “Não direcionado”, “Precisa de aconselhamento do gerente”
  • Em seguida, escreva uma condição de disparo para cada saída. Exemplo de saída “Qualificado”: ​​“O cliente nomeou um orçamento acima de 50.000 rublos, indicou os prazos e está pronto para a reunião”
  • criar resultados de ação
  • clique emSalvar
  • novamente clique no botão editar
  • insira gatilhos de saída do diálogo com o agente
  • clique emSalvar

Função de preenchimento de campos
Com base nas respostas do cliente, o widget pode preencher automaticamente os campos de lead.

  • quando ativado, todos os campos serão preenchidos por padrão
  • ou selecione os campos a serem preenchidos
  • seo campo estiver preenchidoe seu valor não precisar ser alterado, marque a caixa de seleção “Não alterar se preenchido”

Caso um agente não saiba a resposta a uma pergunta, ele pode redirecionar a pergunta para um chat com um especialista. Para obter um número de chat você precisa: Adicionar um bot ao seu chat com colegas ou suporte técnico. Para saber o número do chat você precisa: entrar /iniciar e enviar

  • na busca do Telegram procuramos @nova_aiagent_bot
  • clique em Executar
  • obter número
  • insira este número no campo
  • Marcador de exclusão da base de conhecimento: se você adicionar [NO_KB] à resposta de um especialista, esta resposta não será salva na base de conhecimento. O token não é enviado ao cliente.
  • Selecione ações que devem ser executadas pelo bot após o agente terminar a comunicação com o cliente
  • salvar o Salesbot
  • salvar configurações gatilho

Comportamento do agente

Personalizar o comportamento do agente permite tornar a comunicação com os clientes mais natural e consistente com o estilo da sua empresa. Definir corretamente esses parâmetros ajuda o agente a manter o tom de comunicação desejado e a fornecer respostas mais relevantes.

Natureza da comunicação

Descreva o tom com que um agente deve se comunicar com os clientes. Por exemplo: “Amigável e informal”, “Profissional e discreto”, “Enérgico e motivador”. Este campo define o estilo geral de comunicação do agente.

Regras gerais

Especifique as regras que o agente deve seguir ao se comunicar. Por exemplo:

  • Sempre se dirija como "você"
  • Não use jargões
  • Responda brevemente e direto ao ponto
  • Use emoji nas mensagens

Exemplos de respostas

Adicione exemplos específicos de como um agente deve responder a perguntas comuns. Isso ajuda o agente a compreender melhor o estilo de comunicação e o formato de resposta desejados. Por exemplo:

  • Pergunta: "Quanto custa?" → Resposta: "Terei prazer em lhe informar sobre os preços! O custo depende do pacote escolhido..."
Comportamento do agente

Informações para especialistas

Selecione os campos de leads, contatos e empresas que serão exibidos na mensagem ao especialista quando a pergunta for enviada pelo agente de IA

Informações para especialistas

Gerenciamento da base de conhecimento

A base de conhecimento é necessária para que o agente possa tirar dúvidas sobre seus produtos, serviços, etc. Você pode preencher a base de conhecimento de três maneiras:

  • Adicione seu próprio bloco - digite sua própria resposta para a pergunta
  • Importar por URL - importe informações de um site, Google Docs, Google Sheets ou Notion
  • Importar correspondência Kommo - importar respostas de correspondência com clientes
Gerenciamento da base de conhecimento

Importar por URL

O widget suporta a importação de informações de várias fontes usando o seguinte link:

  • Sites - quaisquer páginas públicas
  • Google Docs - documentos com acesso público
  • Planilhas Google: planilhas públicas
  • Noção - páginas públicas

Configurações de importação:

  • Pesquisar links em uma página - se ativado, o sistema seguirá links e analisará até 300 páginas
  • Importar sem processamento adicional via IA - se habilitado, o texto é salvo “como está” sem estruturação por meio do LLM. Útil se você já possui conteúdo estruturado
Importar por URL

Importação em segundo plano

Grandes importações são realizadas em segundo plano. Você pode acompanhar seu progresso na lista de tarefas:

  • Status da tarefa - pendente, em processamento, concluída, com erro, cancelada
  • Progresso - número de páginas/caixas de diálogo processadas do total
  • Custo - quanto dinheiro foi gasto em importações
  • Número de blocos - quantos blocos de conhecimento foram adicionados ao banco de dados

A lista de tarefas é atualizada automaticamente a cada 5 segundos. Você podeinterromperuma tarefa ativa ouocultaruma tarefa concluída.

Lista de tarefas de importação

Pesquisa na web

O agente de IA pode buscar informações relevantes na Internet caso a base de conhecimento não responda à dúvida do cliente.

Para ativar o recurso, ative a opção "Adicionar suporte para pesquisa na web" nas configurações do widget. Depois disso, o agente poderá:

  • Pesquise informações na Internet
  • Siga os links para detalhes
  • Use as informações encontradas em suas respostas
Configurando a pesquisa na web

Obtenção de informações de fontes externas usando um link

O agente de IA pode receber automaticamente informações atualizadas de fontes externas usando os links fornecidos nas instruções. Este recurso funciona quando a opção "Adicionar suporte para pesquisa na web" está ativada.

Como funciona:

Quando um agente inicia um diálogo com um cliente, ele primeiro segue os links das instruções, obtém informações das páginas e depois as utiliza para responder ao cliente. Isso permite que o agente trabalhe sempre com dados atualizados.

Use exemplos:

1. Recebendo informações pessoais por meio de parâmetros GET

Você pode passar dados do cliente através de parâmetros GET em um link. O agente clicará neste link e receberá informações personalizadas.

Пример инструкции для бронирования отеля:

"Ты помогаешь клиенту забронировать номер в отеле.

Свободные даты и актуальные цены можно посмотреть по ссылке:
https://example.com/api/hotel/availability?room_type={поле_тип_номера}&dates=next_30_days

Используй эту информацию для ответа клиенту о доступных датах и ценах."

Neste exemplo, o agente receberá informações atualizadas sobre os números disponíveis antes de iniciar a conversa.

2. Acionando ações externas por meio de solicitações GET na saída

O agente pode fazer uma solicitação GET quando uma saída específica é acionada para iniciar automaticamente processos em sistemas externos.

Пример инструкции с запуском задачи:

"После успешного согласования услуги перейди к выходу 'создать_задачу'.

При выходе 'создать_задачу' перейди по ссылке:
https://example.com/api/tasks/create?deal_id={ID_сделки}&service={название_услуги}&client_phone={телефон_контакта}

Это автоматически создаст задачу в нашей системе управления."

3. Recuperação de dados de CRM ou sistemas internos

Пример для проверки статуса заказа:

"Проверь статус заказа клиента по ссылке:
https://example.com/api/orders/status?client_id={ID_контакта}

Используй полученную информацию для ответа клиенту о статусе его заказа."

Vantagens:

  • Dados atualizados - as informações são sempre atualizadas, não há necessidade de atualizar a base de conhecimento
  • Personalização - cada cliente recebe informações específicas para sua situação
  • Integração com sistemas externos - você pode lançar ações em outros serviços
  • Flexibilidade – fácil alteração da lógica no lado da API sem alterar as configurações do agente

APIs externas

O recurso APIs externas permite conectar serviços e ferramentas externas aos agentes para expandir seus recursos. Com sua ajuda, o agente pode receber dados de sistemas de terceiros e realizar ações adicionais dentro de scripts. As configurações gerais permitem configurar conexões com APIs externas uma vez e usá-las em diferentes gatilhos do SB.

Em cada gatilho você escolhe quais ferramentas estão disponíveis para o agente, o que proporciona flexibilidade e controle sobre seu comportamento.

Configurando APIs externas

Abra Configurações e vá para a seção “APIs externas”.

Seção APIs externas nas configurações

Clique em +Adicionar ferramenta

Adicionar uma ferramenta

Insira o Título e a Descrição

Nome e descrição da ferramenta

Adicionar configurações HTTP — define qual ação será executada ao acessar uma API externa. Dependendo do método escolhido, o agente entende exatamente o que precisa ser feito com os dados do serviço externo:

  • Método - especifica o que exatamente precisa ser feito ao acessar uma API externa
  • URL é o endereço do serviço externo para o qual o sistema envia a solicitação. Indica exatamente onde ir para receber ou transmitir dados
  • Timeout - define o tempo máximo de espera por uma resposta da API externa. Se o serviço não responder durante esse período, a solicitação será automaticamente encerrada

Em seguida, selecione método de autorização e insira os dados

Configurações de autorização

Se necessário, insira cabeçalhos adicionais - solicite configurações que ajudem a API externa a entender quem está acessando e como processar os dados

Títulos Adicionais

Adicionar parâmetros - permite que você passe dados específicos com os quais a solicitação deve funcionar para a API externa

Parâmetros de solicitação

Salve a configuração da API da ferramenta, adicione a quantidade desejada e Salve a configuração geral

Configurando o gatilho SB

Vá para o gatilho SB desejado e abra suas configurações

Configurações de disparo SB

Em uma seção separada das configurações do gatilho, selecione APIs externas da lista geral que devem ser conectadas ao agente neste cenário.

Selecionando APIs externas em um gatilho

Caso precise alterar os parâmetros da API selecionada, clique no botão Configurar próximo à lista. Uma janela modal será aberta com as mesmas configurações da seção “APIs externas” nas configurações gerais. Todas as alterações serão aplicadas imediatamente.

Configurando uma API a partir de um gatilho

Nenhuma resposta especializada

Se um agente encaminhar uma pergunta para um especialista, mas ele não responder dentro do prazo determinado, o agente poderá continuar a conversa automaticamente.

Configurações:

  • Nenhuma resposta em (minutos): tempo de espera pela resposta de um especialista em minutos
  • Instruções se não houver resposta - o que o agente deve fazer se o especialista não responder. Por exemplo: “Peça desculpas e peça ao cliente que espere” ou “Ofereça-se para deixar um contato para feedback”
Configurando quando não há resposta de um especialista

Consultor de IA para Telegram

Ative a caixa de seleção "Ativar consultor de IA para a equipe /ask no Telegram", anote as instruções para o consultor e adicione uma lista de IDs de bate-papo do Telegram

Consultor de IA para Telegram

Oportunidades:

  • Command /ask - você pode usar um consultor para testar a base de conhecimento diretamente nos chats do Telegram
  • Comando /lembrar texto - usando este comando, o agente adiciona texto à base de conhecimento. Adequado para adicionar rapidamente novos conhecimentos diretamente por meio de chats de trabalho

Um exemplo de como o widget funciona

Exemplo de preenchimento de campos