Usando uma função dedicada desenvolvida pela equipe MaviBot, seu chatbot de IA pode ler inteligentemente valores de uma Planilha Google e armazená-los em uma variável de sistema nas configurações do seu projeto. Isso cria uma fonte de dados dinâmica e sincronizada para seu assistente.

Aplicações práticas

Essa capacidade é essencial para cenários como:

  • Assistente de catálogo de produtos: uma IA que aconselha clientes sobre sua linha de produtos atual, preços e disponibilidade em tempo real.
  • Bot de promoção inteligente: um bot que promove suas ofertas destacando dinamicamente recursos, especificações ou ofertas extraídas 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". Em seguida, uma nova planilha será criada no projeto e aparecerá na seção "Planilhas":

Configurações da planilha

Após criar a planilha, você precisa adicionar linhas e colunas. Para fazer isso, encontre o botão "Ir para" no cartão da planilha desejada e clique nele.

Você verá as seguintes configurações:

Para adicionar uma coluna com um nome, clique no botão "+":

Ao clicar no botão, uma janela modal será aberta onde você pode inserir um nome para a nova coluna.

Após 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 de linhas.

Agora, sua planilha se parece com isso.

Copie (lembre-se) o ID da planilha: para fazer isso, clique na barra de endereço:

Em seguida, vamos configurar os blocos no construtor.

Trabalhando no construtor do 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 guia apropriada no Mavibot e crie um bloco com um gatilho (Bloco de início 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)

  1. project. - é um construtor para definir uma variável na configuração do projeto;
  2. record - nome da variável;
  3. get_records_from_table(1) - função, onde o parâmetro é passado como ID da tabela.

get_records_from_table(table_id, start_row, count, start_col, end_col) – para obter registros de uma tabela

Parâmetro Descrição Nota
! 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 final 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ê executa o bloco em modo de teste, o bot exibirá os valores que serão atribuídos à variável.

Observe

Após configurar a chamada do bloco em 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 você adicionou mais valores à tabela, basta iniciar o bloco em modo de teste. Então os dados na variável do projeto serão atualizados.

O nome da variável pode ser qualquer nome que você goste.

Bloco de transferência de dados

Em seguida, criaremos um bloco "Chat" para transferir dados para o cartão 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 ID do seu bloco.

Observe

Após o teste, substitua "Block call 31241050" pelo comando "start_block_from_ai 31241050".

O comando "Block call 31241050" é de depuração e ajuda a entender quais dados o bot está registrando (veja a seção "Teste").

Para iniciar o bot para clientes, especifique o comando "start_block_from_ai 31241050".

Lendo uma tabela

  1. Navegue para o modo de teste do bot.
  2. 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:

  1. Vá para a seção Configurações do projeto.
  2. Localize a variável para visualizar seus dados atuais.

Na guia "Variáveis" nas configurações do projeto, você verá sua variável com os valores adicionados da tabela. Então agora, dentro do seu projeto, há uma variável com produtos, custo e tudo 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 o papel "Assistente de vendas":

Também definiremos configurações adicionais:

Configurações do assistente de IA

Nas configurações do bot, escreva os seguintes dados:

  1. A posição e as instruções para o bot.

  1. 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 está escrito o ID do bloco com a mensagem final: o bloco Chat transmite dados para o cartão do cliente:

Conhecimento do bot

No campo "Conhecimento do Bot", passe a variável que foi previamente armazenada em cache como um bloco com o gatilho.

Conhecimento do bot.

Desta forma, o bot obterá informações de uma variável nas configurações do projeto e aconselhará seus clientes sobre a linha de produtos disponível.

Formato dos dados

No formato dos dados transmitidos, você especifica os dados que está coletando (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 número de 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.

Desta forma, ao chamar o bloco, as variáveis serão passadas para o cartão do cliente: então você pode trabalhar com as 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 a seu critério:

Testando um bot

"Se você já tem 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 guia com a janela de teste e clique em "Adicionar gatilho":

Agora, na condição do gatilho, você verá o seguinte valor:

Desta forma, o bot será executado apenas na janela de teste e em nenhum outro lugar.

Após depurar o bot, remova esta condição.

Esta mensagem está sendo enviada em modo de teste devido ao comando "Block call 3124105](/docs/chatbot-ai-assistant#data-transfer-format)

Após testar e depurar o bot, escreva o comando nas configurações do bot "start_block_from_ai 31241050".

Esta abordagem permite que você construa qualquer tipo de loja online e aproveite quaisquer valores de dados armazenados em sua tabela.

O único limite real é sua imaginação.