Assistente de IA com tabelas do MaviBot
Usando uma função dedicada desenvolvida pela equipe do MaviBot, seu chatbot de IA pode ler valores de uma Planilha Google de forma inteligente e armazená-los em uma variável do sistema nas configurações do seu projeto. Isso cria uma fonte de dados dinâmica e sincronizada para o seu assistente.
Aplicações práticas
Essa funcionalidade é essencial para cenários como:
Assistente de catálogo de produtos: uma IA que aconselha clientes sobre o seu portfólio atual de produtos, preços e disponibilidade em tempo real.
Bot inteligente de promoções: um bot que promove suas ofertas destacando dinamicamente recursos, especificações ou promoções extraídos diretamente da sua planilha.
Como preparar sua tabela para integração
Para começar, vá para a seção de planilhas:
Em seguida, você verá o botão "Adicionar planilha", que abre uma janela modal na qual você precisa inserir o nome da planilha:
Insira o nome da planilha e clique no botão "Concluído". Então uma nova planilha será criada no projeto e aparecerá na seção "Planilhas":
Configurações da planilha
Depois de criar a planilha, você precisa adicionar linhas e colunas. Para fazer isso, encontre o botão "Ir para" no کارتão da planilha desejada e clique nele.
Você vê as próximas configurações:
Para adicionar uma coluna com um nome, clique no botão "+":
Quando você clicar no botão, uma janela modal será aberta onde você poderá inserir um nome para a nova coluna.
Depois de inserir o nome da coluna, clique no botão "Concluído"; então a nova coluna será adicionada à planilha. Adicione o número necessário de colunas e depois linhas.
Agora, sua planilha está assim.
Copie (lembre-se) do ID da planilha: para fazer isso, clique na barra de endereço:
Em seguida, vamos para a configuração dos blocos no construtor.
Trabalhando no construtor de Chatbot
Função get_records_from_table()
Para usar a função get_info_from_table(), você precisa de um bloco no construtor do chatbot.
Vá para a aba apropriada no Mavibot e crie um bloco com um gatilho (bloco inicial ou bloco de gatilho):
Defina uma variável (ela será usada para o conhecimento do assistente de IA): neste exemplo, a variável é 'record'.
Exemplo de código da Calculadora
project.record = get_records_from_table(1)
project. - é um construtor para definir uma variável na configuração do projeto;record - nome da variável;get_records_from_table(1) - função, onde o parâmetro é passado como ID da tabela.
Leia mais sobre a função get_record_from_table()
get_records_from_table(table_id, start_row, count, start_col, end_col) – para obter registros de uma tabela
! table_id
ID da tabela (parâmetro obrigatório)
start_row
parâmetro opcional, inteiro. Especifica a linha inicial do intervalo
aceita o número da linha a partir da qual começar a ler os valores da tabela, inclusive. Deve ser especificado sem aspas
count
parâmetro opcional, inteiro. Especifica o número de linhas a recuperar
valor padrão: 1000. Máximo: 5000. Deve ser especificado sem aspas
start_col
parâmetro opcional, string. Especifica a coluna inicial do intervalo
aceita o nome da coluna a partir da qual começar a ler os valores da tabela, inclusive. Deve ser especificado entre aspas
end_col
parâmetro opcional, string. Especifica a coluna final do intervalo
aceita o nome da coluna até a qual ler os valores da tabela, inclusive. Deve ser especificado entre aspas
Para ler todos os dados a partir de um certo ponto: Especifique apenas o início do intervalo. Para ler todos os dados até um certo ponto: Especifique apenas o fim do intervalo.
Em vez de #{none}, escreveremos nossa variável na mensagem usando a construção #{} para ver visualmente quais dados foram gravados na variável do projeto.
Atenção
A variável incorporada na mensagem é necessária para verificar se o bot lê a função corretamente. Quando você executar o bloco no modo de teste, o bot exibirá os valores que serão atribuídos à variável.
Observe
Depois de configurar a chamada do bloco no modo de teste e salvar a variável nas configurações do projeto, não exclua este bloco.
Você pode precisar dele: por exemplo, se tiver adicionado mais valores à tabela, basta executar o bloco no modo de teste. Então os dados na variável do projeto serão atualizados.
O nome da variável pode ser qualquer nome de sua preferência.
Bloco de transferência de dados
Em seguida, criaremos o bloco "Chat" para transferir dados para a ficha do cliente.
"Este bloco também pode transmitir uma mensagem de encerramento do bot, como: 'Estou passando as informações para o gerente! O gerente entrará em contato em até 10 minutos.'"
Em seguida, copie o ID do bloco. Você precisará dele para configurar o assistente de IA no comando "start_block_from_ai 11956" e no comando de teste "Block call 11956", onde em vez do ID do bloco do exemplo, você precisa inserir o seu ID do bloco.
Observe
Após o teste, substitua "Block call 31241050" pelo comando "start_block_from_ai 31241050".
O comando "Block call 31241050" é para depuração e ajuda a entender quais dados o bot está registrando (veja a seção "Teste").
Para iniciar o bot para os clientes, especifique o comando "start_block_from_ai 31241050".
Lendo uma tabela
Navegue até o modo de teste do bot .
Inicie o bloco que contém o gatilho para ler os dados da tabela.
O bloco funcionou corretamente. Você pode ver isso confirmado pelos valores agora armazenados na variável correspondente nas configurações do seu projeto.
Para verificar manualmente:
Vá para a guia Configurações do projeto seção.
Localize a variável para ver seus dados atuais.
Na aba "Variáveis" nas configurações do projeto, você verá sua variável com os valores adicionados nela a partir da tabela. Então, agora, dentro do seu projeto, há uma variável com produtos, custo e tudo o que você especificou na tabela.
Trabalhando no assistente de IA
Vá para a seção "Assistente de IA" e inicie o chatbot com as configurações de IA.
Você precisa escolher a função "Assistente de vendas":
Também definiremos configurações adicionais:
Configurações do assistente de IA
Nas configurações do bot, escreva os seguintes dados:
A posição e as instruções para o bot.
O comando para chamar o bloco e transferir variáveis para o sistema é escrito da seguinte forma:
"Se tudo estiver correto, execute o comando "start_block_from_ai 11956"", onde em vez de N é escrito o ID do bloco com a mensagem final: o bloco Chat transmite dados para a ficha do cliente:
Conhecimento do bot
No campo "Conhecimento do bot", passe a variável que foi armazenada anteriormente como um bloco com o gatilho.
Conhecimento do bot.
Dessa forma, o bot pegará informações de uma variável nas configurações do projeto e orientará seus clientes sobre o sortimento de produtos disponível.
Formato dos dados
No formato dos dados transmitidos, você especifica os dados que está coletando por conta própria (por exemplo, um produto), depois insere a frase com a "chave" e atribui um valor à chave.
o nome do cliente com a chave client_name, o telefone do cliente com a chave phone_number, a cidade e o endereço com a chave city_address, o produto escolhido com a chave product, a quantidade do produto com a chave quantity, o valor total do pedido com a chave total_amount.
Dessa forma, ao chamar o bloco, as variáveis serão passadas para a ficha do cliente: então você pode trabalhar com variáveis, por exemplo, no construtor do chatbot:
Nesta etapa, a configuração do assistente de IA está concluída.
Os parâmetros restantes podem ser definidos conforme sua preferência:
Testando um bot
"Se você já tiver bots em execução, especifique na condição de inicialização do assistente de IA para iniciar apenas na janela de teste."
Passo 1. Clique no construtor de gatilhos
Passo 2. Selecione a aba com a janela de teste e clique em "Adicionar gatilho":
Agora, na condição do gatilho, você verá o seguinte valor:
Dessa forma, o bot será executado apenas na janela de teste e em nenhum outro lugar.
Depois de depurar o bot, remova essa condição.
Esta mensagem está sendo enviada em modo de teste devido ao comando "Block call 3124105
Após testar e depurar o bot, escreva o comando nas configurações do bot "start_block_from_ai 31241050".
Essa abordagem permite que você crie qualquer tipo de loja virtual e aproveite quaisquer valores de dados armazenados na sua tabela.
O único limite verdadeiro é a sua imaginação.
Atualizado