Resumo
Este guia explica como configurar a ação Google Sheets — Search and find row no Astra. Essa ação permite que seu agente leia e recupere linhas de uma planilha do Google Sheets (guia) selecionada e retorne os resultados como uma lista estruturada.
Para garantir que a ação funcione corretamente, sua planilha deve conter uma linha de cabeçalho não vazia na parte superior. Esses cabeçalhos definem a estrutura dos dados que o Astra lê.
Antes de configurar a ação, verifique se sua conta do Google está conectada ao Astra.
Instruções
Siga estas etapas para configurar a ação Google Sheets — Search and find row:
Etapa 1: Abra o modelo de ação
Faça login na sua conta Astra.
Vá para a Action Library.
Selecione Google Sheets — Search and find row.
Abra a página Configuration.
Você configurará várias seções nesta página.
Etapa 2: Configure a intenção da ação
Na seção Action intent:
Insira um Action name.
Escreva um Intent que explique quando o agente deve procurar linhas na planilha.
Por que isso importa
A intenção ajuda o agente a entender quando ele deve usar esta ação.
Instruções claras melhoram a precisão de quando a ação é acionada.
Por exemplo, o agente pode pesquisar a planilha quando um usuário solicitar detalhes do cliente ou quando precisar recuperar informações armazenadas.
Etapa 3: Selecione a conta do Google
Na seção Google account:
Escolha a conta do Google conectada que tem acesso à planilha.
Como isso funciona
O Astra usa a conta selecionada para acessar o Google Sheets por meio da autenticação OAuth segura.
A planilha deve estar acessível a partir dessa conta.
Etapa 4: Selecione a planilha e a guia
Na seção Spreadsheet and worksheet:
Escolha o Drive location.
Selecione a Spreadsheet.
Selecione a Worksheet (tab) que contém os dados.
Importante:
Apenas planilhas localizadas em My Drive ou Shared Drives podem ser usadas.
O Astra lerá os dados apenas da guia selecionada.
Etapa 5: Configure a filtragem de linha
Você pode controlar como o Astra lê as linhas usando a opção Read only relevant rows.
Opção 1: Desative a opção (ler a planilha inteira)
Quando a opção está OFF:
O Astra lê a planilha inteira.
Todas as linhas são retornadas ao agente.
Ideal para:
Planilhas com conjuntos de dados pequenos (cerca de 1.000 linhas ou menos).
Opção 2: Ative a opção (ler apenas as linhas relevantes)
Quando a opção está ON:
O Astra tenta filtrar e retornar apenas as linhas relevantes.
O agente pesquisa os dados em vez de ler a planilha inteira.
Notas importantes sobre a correspondência:
A correspondência é aproximada (difusa) para texto ASCII.
As pesquisas são normalmente:
Insensíveis a maiúsculas e minúsculas
Menos sensíveis a espaços ou pontuação
Para texto não latino, a correspondência é mais literal e pode exigir correspondências mais próximas.
Ideal para:
Planilhas com grandes conjuntos de dados, onde ler a planilha inteira seria ineficiente.
O que acontece quando a ação é executada
Quando a ação é acionada:
O Astra lê a planilha do Google Sheets selecionada.
Ele recupera as linhas com base nas configurações definidas.
As linhas são retornadas ao agente como uma lista estruturada de dados.
Isso permite que seus fluxos de trabalho recuperem dinamicamente informações armazenadas no Google Sheets, como registros de clientes, dados de produtos ou informações de rastreamento interno.