Administrar o Gemini na sua instância do Looker (Google Cloud Core)

Esta página de documentação descreve como administrar os recursos do Gemini no Looker para uma instância do Looker (Google Cloud Core). Ele abrange os seguintes tópicos:

Esta página é destinada a usuários que têm o papel de Administrador do Looker na instância do Looker (Google Cloud Core) e o papel de administrador do Looker (roles/looker.admin) no projeto Google Cloud em que a instância está localizada.

O que é o Gemini no Looker?

O Gemini no Looker representa uma série de recursos do portfólio Gemini para Google Cloud que oferece assistência com tecnologia de IA generativa para ajudar você a analisar e receber insights valiosos dos seus dados.

Saiba como e quando o Gemini para Google Cloud usa seus dados.

Para mais informações sobre os tipos de tarefas em que o Gemini no Looker pode ajudar, consulte a página de documentação Visão geral do Gemini no Looker.

Entender os recursos de compliance do Gemini no Looker

A análise de conversas ainda não está incluída nos limites de autorização FedRAMP High ou FedRAMP Medium. Antes de ativar a configuração Gemini no Looker na sua instância do Looker, converse com o órgão autorizador para saber se as soluções de compliance do Gemini para Google Cloudatendem às necessidades da sua organização.

Para instâncias do Looker (Google Cloud Core), cada pacote de controle do Assured Workloads que ficar disponível vai adicionar recursos do Gemini no Looker às ofertas padrão à medida que os requisitos e processos de mudança desse pacote forem atendidos. A análise de conversas no Looker respeita os recursos de compliance da instância associada do Looker (Google Cloud Core), com a seguinte exceção:

O suporte à residência de dados (DRZ), especificamente para dados em repouso, está disponível para todos os clientes do Looker. Todos os dados em repouso associados à Análise Conversacional residem estritamente na instância do Looker e ficam confinados a uma única região. Os dados em trânsito e o machine learning (ML) são processados usando um serviço global.

Antes de começar

Para receber as permissões necessárias para ativar o Gemini em uma instância do Looker (Google Cloud Core), peça ao administrador para conceder a você o papel do IAM de Administrador do Looker (roles/looker.admin) no projeto em que a instância está localizada. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Para realizar as tarefas a seguir, você precisa ser um administrador do Looker na instância do Looker (Google Cloud Core):

  • Ative as configurações individuais dos recursos que usam a assistência do Gemini na instância do Looker (Google Cloud Core).
  • Conceder permissões aos usuários para usar os recursos do Gemini no Looker

Ativar e desativar o Gemini

Para ativar o Gemini no Looker para o Looker (Google Cloud Core), siga estas etapas no console Google Cloud :

  1. Navegue até o projeto Google Cloud que hospeda o Looker (Google Cloud Core).
  2. Acesse a página Instâncias e clique no nome da instância em que você quer ativar o Gemini.
  3. Clique em Editar.
  4. Abra a seção Gemini no Looker (Google Cloud Core).
  5. Selecione Gemini. Quando essa configuração está ativada, um administrador do Looker pode ativar seletivamente os recursos disponíveis do Gemini no Looker no painel Administrador da instância do Looker (Google Cloud Core).
  6. Para ativar os recursos do Gemini no Looker disponíveis na versão prévia, selecione Recursos do Trusted Tester. Quando essa configuração está ativada, os usuários podem acessar os recursos do Trusted Tester do Gemini no Looker. Essa configuração precisa estar ativada para que os usuários acessem os recursos do Gemini em prévia.
  7. Se quiser, selecione Uso de dados do Trusted Tester. Quando essa configuração está ativada, você concorda que seus dados sejam usados pelo Google, conforme descrito nos termos do Programa Trusted Tester do Gemini para Google Cloud .

Para desativar o Gemini em uma instância do Looker (Google Cloud Core), desmarque a configuração Gemini.

Ativar e desativar seletivamente recursos individuais do Gemini no Looker

A página Gemini no Looker, na seção Plataforma do painel Administrador do Looker (Google Cloud Core), mostra informações sobre o status de ativação das configurações de Gemini, Recursos do Trusted Tester e Uso de dados do Trusted Tester da instância, que são gerenciadas no console Google Cloud . Nesta página, os administradores do Looker também podem gerenciar as configurações de ativação de recursos individuais do Gemini no Looker.

Uma marca de seleção verde ao lado de Status de ativação do Gemini indica que os recursos do Gemini no Looker disponíveis para o público geral podem ser ativados para a instância. Uma marca de seleção verde ao lado de Status de ativação dos recursos do Trusted Tester indica que os recursos do Gemini no Looker em prévia podem ser ativados para a instância.

Para ativar recursos individuais do Gemini no Looker, siga estas etapas na instância do Looker (Google Cloud Core):

  1. No painel Administrador, acesse a seção Plataforma e selecione a página Gemini no Looker.
  2. Ative os seguintes botões para habilitar cada um dos recursos correspondentes disponíveis para todos os usuários:
    • Análise Conversacional: ativa a Análise Conversacional
      • Análise avançada: permite que os criadores de agentes de dados da Análise conversacional ativem a Análise avançada em todas as conversas com o agente de dados. A configuração Análise Conversacional também precisa estar ativada para usar a Análise avançada.
    • Assistentes do Looker: ativa o Assistente de visualização e o Assistente de expressão.
      • Pesquisa semântica: permite que os usuários pesquisem conteúdo salvo no Looker usando consultas em linguagem natural.
    • Consultas verificadas: ativa as consultas verificadas, que são pares predefinidos de perguntas em linguagem natural e as consultas do recurso Detalhar correspondentes e exatas que ensinam seu agente de dados a lidar com solicitações comerciais complexas. A configuração Análise Conversacional também precisa estar ativada para usar consultas verificadas. A configuração Consultas verificadas é ativada por padrão.
  3. Ative as seguintes opções para habilitar cada um dos recursos de pré-lançamento correspondentes:
    • Ativar agentes de painel: permite que os usuários criem agentes de dados em um painel usando a Análise Conversacional.
    • Ativar o resumo do painel: mostra um resumo do painel para entregas programadas. Essa configuração exige que as opções Análise Conversacional, Ativar recursos de trusted testers e Ativar agentes de painel estejam ativadas.
    • Assistente do LookML: permite que os usuários escrevam comandos em linguagem natural que geram sugestões do Gemini para parâmetros do LookML, que podem ser adicionados aos arquivos do projeto.
    • Agentic Workflows: permitem que os usuários solicitem aos agentes e conversas da Análise Conversacional a geração de Agentic Workflows para monitorar mudanças nos dados.
    • Assistente de administrador: ajuda os administradores do Looker a gerenciar funções do Looker.
    • Resumo de NL da ferramenta Analisar: permite que os usuários vejam um resumo de uma Análise do Looker gerado pelo Gemini.
    • Assistente de insights de Análise: ativa o Assistente de insights, que permite aos usuários fazer perguntas em linguagem natural sobre uma Análise e criar e modificar consultas com base nela.
    • Inícios rápidos assistidos por IA: ativa as análises de início rápido geradas pelo Gemini em uma análise detalhada do Looker.
    • Publicar no Gemini Enterprise: permite que os proprietários de agentes de dados da Análise Conversacional publiquem os agentes no Gemini Enterprise quando também têm uma função que contém a permissão publish_agent_externally. Ao ativar essa configuração, você precisa fornecer as seguintes informações sobre a instância de destino do Gemini Enterprise:
      • No campo Número do projeto do GCP, insira o número do projeto do Google Cloud projeto que hospeda a instância de destino do Gemini Enterprise.
      • No campo Região, insira a região da instância do Gemini Enterprise. A região está listada em Localização na página Apps do Gemini Enterprise.
      • No campo ID da instância, insira o ID específico da instância do Gemini Enterprise. Esse ID está localizado na página Apps do Gemini Enterprise. Se você mudar a instância de destino do Gemini Enterprise, todos os agentes publicados na instância original serão despublicados automaticamente.
      • No console Google Cloud , conceda à conta de serviço gerada pelo Looker o papel do IAM Administrador do Discovery Engine no projeto Google Cloud que hospeda a instância do Gemini Enterprise. A conta de serviço adequada para uso é mostrada na página de ativação do Gemini no Looker na instância do Looker.

Você precisa conceder as permissões adequadas aos usuários antes que eles possam usar os recursos do Gemini no Looker.

Conceder permissão do Gemini no Looker aos usuários

A assistência do Gemini está disponível ao realizar várias tarefas na instância do Looker. Para usar qualquer um desses recursos com a ajuda do Gemini, os usuários precisam receber uma função do Looker que aplique a permissão gemini_in_looker aos modelos adequados, além de uma função que contenha permissões para realizar a tarefa com a ajuda do Gemini. É possível atribuir a permissão gemini_in_looker de uma das seguintes maneiras:

Conceder o papel padrão do Gemini

A função padrão do Gemini aplica todas as permissões necessárias para interagir com os agentes de dados da Análise Conversacional e usar o Gemini no Looker em todos os modelos da instância. Você também precisa atribuir a permissão access_data e outras permissões que possam ser necessárias para usar o recurso específico do Gemini no Looker.

Você pode atribuir essa função aos usuários ou grupos adequados.

Como conceder uma função personalizada

Para restringir o acesso dos usuários aos recursos do Gemini no Looker em todos os modelos na instância do Looker, crie uma função personalizada do Looker que aplique a permissão gemini_in_looker apenas a modelos específicos e atribua-a aos usuários ou grupos adequados. Talvez seja necessário remover esses usuários do grupo Usuários padrão do Gemini, que recebe a função padrão Gemini por padrão. Você também precisa atribuir a permissão access_data e outras permissões que possam ser necessárias para usar o recurso específico do Gemini no Looker.

Conceder papéis ou permissões do Conversational Analytics

A função Gerente do agente de análise de conversação consiste no conjunto de permissões Gerente do agente de análise de conversação para todos os modelos na instância do Looker. Os usuários com essa função podem criar, editar, compartilhar e excluir agentes de dados da Análise conversacional.

A função Usuário da Análise Conversacional consiste no conjunto de permissões de usuário da Análise Conversacional para todos os modelos na instância do Looker. Os usuários com essa função podem conversar com qualquer agente de dados da Análise conversacional no Looker.

Você pode atribuir qualquer uma dessas funções aos usuários ou grupos apropriados. Também é possível criar uma função personalizada do Looker que aplique qualquer uma das permissões da Análise de conversas a modelos específicos.

Adicionar usuários ao grupo Usuários padrão do Gemini

O grupo Usuários padrão do Gemini foi criado automaticamente para todas as instâncias do Looker (original) que usam uma configuração de sistema aberto. Os usuários desse grupo recebem a função Gemini, que permite usar os recursos do Gemini no Looker quando também têm uma função que inclui as outras permissões necessárias para usar os recursos do Gemini no Looker.

Você pode editar o grupo Usuários padrão do Gemini para adicionar ou remover usuários ou excluir o grupo inteiro. Também é possível adicionar outras funções ao grupo.

Para mais informações sobre como os usuários são adicionados a esse grupo, consulte a página de documentação Grupos.

Talvez sejam necessárias outras permissões do Looker para realizar as tarefas em que o Gemini ajuda. Consulte a seção Outras permissões nesta página para ver uma lista delas.

Outras permissões

Para usar qualquer recurso do Gemini no Looker, os usuários precisam receber um papel do Looker que contenha permissões para realizar a tarefa com a ajuda do Gemini. Essas permissões estão resumidas na lista a seguir:

  • Para usar a Análise Conversacional ou a API Conversational Analytics para consultar dados do Looker ou criar um agente de dados, você precisa receber uma função do Looker que contenha as permissões access_data e gemini_in_looker para cada modelo que você está consultando. Outras permissões são necessárias dependendo de como você interage com a Análise Conversacional. Esse recurso está disponível quando a configuração Análise Conversacional está ativada.
  • Para usar o Assistente de visualização e criar visualizações personalizadas com a ajuda do Gemini, você precisa receber um papel do Looker que contenha a permissão can_override_vis_config. O Assistente de visualização fica disponível quando a configuração Assistentes do Looker está ativada.
  • Para usar a Análise avançada nos agentes de dados da Análise Conversacional e traduzir suas perguntas em linguagem natural para código Python, além de executar esse código para fornecer análises e visualizações avançadas, você precisa ter uma função com as mesmas permissões necessárias para usar os agentes de dados da Análise Conversacional.
  • Para escrever LookML com a ajuda do Gemini, você precisa ter um papel do Looker que contenha a permissão develop para pelo menos um modelo em um projeto do LookML. Esse recurso fica disponível quando a configuração Assistente do LookML está ativada.
  • Para gerar resumos de Análises, incluindo a finalidade sugerida da Análise e os tipos de dados usados na consulta, você precisa ter um papel que contenha a permissão develop para pelo menos um modelo no projeto do LookML e a permissão explore para ver e interagir com as Análises. Esse recurso está disponível quando a configuração Descobrir resumo de NL está ativada.
  • Para gerar análises de início rápido, você precisa ter um papel do Looker que contenha a permissão develop para pelo menos um modelo em um projeto do LookML. Esse recurso está disponível quando a configuração Início rápido assistido por IA está ativada.
  • Para escrever expressões do Looker com a ajuda do Gemini, você precisa receber um papel do Looker que contenha a permissão create_table_calculations para usar o Gemini e escrever uma expressão de cálculo de tabela ou um papel que contenha a permissão create_custom_fields para escrever uma expressão de campo personalizado. Esse recurso fica disponível quando a configuração Assistentes do Looker está ativada.
  • Para usar o Assistente de insights e fazer perguntas sobre uma Análise detalhada e, em seguida, usar a ajuda do Gemini para criar ou modificar uma Análise detalhada, você precisa receber um papel do Looker que contenha a permissão explore. Esse recurso está disponível quando a configuração Assistente de insights está ativada.
  • Para usar o Assistente do administrador na criação e modificação de funções do Looker, você precisa ter a função de Administrador. Esse recurso está disponível quando a configuração Assistente do administrador está ativada.

Enviar feedback

Você pode enviar feedback sobre cada recurso do Gemini no Looker. As instruções sobre como enviar feedback estão incluídas na documentação de cada recurso.