SZ.chat - Armazenamento | Relatório Premium

Este artigo tem como objetivo orientar o cliente na preparação e utilização do Relatório Premium no Looker Studio, garantindo que os dados sejam corretamente formatados, carregados no BigQuery e vinculados ao dashboard. 

Antes de acessar o Relatório Premium, é necessário executar um script de formatação que organiza os arquivos de sessões em um padrão compatível com o esquema disponibilizado. Esse processo é fundamental para assegurar que as informações sejam exibidas corretamente no relatório. 

A documentação está dividida em etapas práticas: 

• Script: Google Colab 
  
  
• Esquema: Schema JSON 
  
  
  

Etapa 1 – Copiar e Executar o Script no Google Colab 

1. Criar uma cópia do script no Google Drive 

• Acesse o link do script - Link do Script. 
• Clique em "Arquivo" > "Salvar uma cópia no Drive".
  

2. Criar estrutura de pastas no Google Drive 

• Crie uma pasta chamada backups. 
• Dentro de backups, crie outra chamada input. 
• Coloque os arquivos .jsonl a serem formatados na pasta input.
  

3. Definir o nome do arquivo 

• No script do Colab, localize a variável file_name e defina o nome do arquivo .jsonl que foi inserido. file_name = "nome_do_arquivo.jsonl"
  
  

4. Executar o script 

• Clique em "Executar tudo".
  
  
• Permitir a conexão com o Google Drive.
  
  
• Selecione a conta que foi colocado o arquivo no drive  
  
  

5. Obter sessão formatada: 

• O arquivo formatado estará disponível em: backups/output/formatted___reports_sessions.json 
• Faça o download do arquivo 
• Faça o download do schema: Link do Schema
  

Etapa 2 – Inserir os dados no BigQuery 

1. Acessar a página do BigQuery. 

1.1. Caso não tenha um projeto criado ainda, clique no botão "Criar Projeto": 

1.2. Defina um nome e local para o projeto:


Local indica onde o projeto vai ficar na hierarquia de recursos do Google Cloud: 

• Sem organização: o projeto fica “solto”, vinculado à sua conta pessoal (Gmail).
• Organização / Pasta: se você usa Google Workspace (conta corporativa), o projeto fica dentro da sua organização e opcionalmente dentro de uma pasta. Assim ele herda permissões (IAM) e políticas da organização. 

2. Criar um conjunto de dados clicando sobre as opções abaixo:

3. Preencha o campo “Código do conjunto de dados” com um nome para o conjunto. Em seguida, clique em “Criar conjunto de Dados”:

4. Clique no ícone de opções localizado no lado direito do nome do conjunto de dados criado e selecione a opção “Criar Tabela”: 

5. Dentro da aba de criação de tabela, configure da seguinte forma: 

• Create table from (Criar tabela de): selecione “Fazer upload”.
• Em Selecionar Arquivo: clique em Procurar e escolha o arquivo JSON (formatted___reports_sessions.json).
• Formato do arquivo: selecione “JSON delimitado por nova linha”. 
• Esquema: copie e cole o esquema disponibilizado em Link do Schema 
• Tabela: nomeie a nova tabela que será criada dentro do Conjunto de dados. 

6. Em seguida, clique no botão “Criar tabela”. 

6.1. Será iniciado um job de inserção:

7. Quando o job de inserção de dados finalizar, será exibido uma mensagem na tela e a tabela estará disponível para utilizar no template do relatório. 

8. Após isso, dentro da tela de Relatório de Conversas, é preciso fazer uma cópia do template: 

9. Selecione a opção Criar > Fonte de dados. 

10. Escolha a fonte de dados do BigQuery.

11. Selecione o projeto, conjunto de dados e a tabela que foi criada anteriormente e clique em “Conectar”: 

12. Após conexão, os metadados da tabela serão carregados. Então basta clicar em “Adicionar ao relatório”. 

13. Assim, a base de dados está conectada ao template do Looker Studio. Então, clique em “Copiar relatório”. 

14. Se não for alterar nenhuma informação do template, basta clicar em “Leitura”. 

Com o modo de leitura ativado no Looker Studio, você poderá visualizar o dashboard e realizar análises com os dados formatados. 

Para visualizar no SZ, siga os passos abaixo: 

1. No menu lateral do SZ, acesse Relatórios > Premium: 

2. Clique no botão de “Adicionar”: 

3. Insira um título para identificação e o link do relatório gerado e clique em "Salvar”: 

4. Para visualizar, busque pelo nome inserido no título e clique sobre o item: 

Com isso, será possível visualizar os dados dentro do Relatório Premium.