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 para a instância do Looker (Google Cloud Core) e o papel de administrador do Looker (roles/looker.admin) para o Google Cloud projeto em que a instância reside.

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 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 dos recursos do Gemini no Looker

A Análise de conversação ainda não está incluída nos limites de autorização do FedRAMP de nível alto ou médio. Antes de ativar a configuração Gemini no Looker para sua instância do Looker, discuta com o órgão autorizador se as ofertas 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 como ofertas padrão à medida que os requisitos e processos de mudança desse pacote forem atendidos. As Análises de conversação no Looker respeitam 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, na sigla em inglês), especificamente para dados em repouso, está disponível para todos os clientes do Looker. Todos os dados em repouso associados às Análises de conversação residem estritamente na instância do Looker e são confinados a uma única região. Os dados em trânsito podem ser processados usando um serviço global.

Antes de começar

Para receber as permissões necessárias para ativar o Gemini para 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 reside. 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 personalizados papéis ou outros predefinidos papéis.

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

  • Ativar as configurações individuais para 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 Google Cloud console:

  1. Navegue até o Google Cloud projeto que hospeda o Looker (Google Cloud Core).
  2. Navegue até 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 que estão disponíveis na versão de pré-lançamento, 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 ser ativada para que os usuários acessem os recursos do Gemini que estão na versão de pré-lançamento.
  7. Opcionalmente, 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 para 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 Gemini, Recursos do Trusted Tester e Uso de dados do Trusted Tester para a instância, que são gerenciadas no Google Cloud console. Nessa 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 que estão 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 que estão na versão de pré-lançamento 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, navegue até a seção Plataforma e selecione a página Gemini no Looker.
  2. Ative os seguintes botões para ativar cada um dos recursos correspondentes disponíveis para o público geral:
    • Análises de conversação — ativa a Análises de conversação
      • Análises avançadas — permite que os criadores de agentes de dados da Análises de conversação ativem a Análises avançadas para todas as conversas com o agente de dados. A configuração Análises de conversação também precisa ser ativada para usar a Análise avançada.
    • Assistentes do Looker : ativa o Assistente de visualização
  3. Ative os seguintes botões para ativar cada um dos recursos correspondentes da versão de pré-lançamento:
    • Pesquisa semântica : ativa os recursos de pesquisa aprimorada com tecnologia do Gemini. Essa configuração exige que o recurso de pré-lançamento Pesquisa aprimorada esteja ativado para sua instância.
    • Assistente do LookML : permite que os usuários escrevam comandos de linguagem natural que produzem sugestões geradas pelo Gemini para parâmetros do LookML, que podem ser adicionados aos arquivos do projeto.
    • Assistente de expressão : ativa o Assistente de expressão, que permite que os usuários usem linguagem natural para escrever expressões do Looker para cálculos de tabela e campos personalizados.
    • Resumo de NL da Análise : permite que os usuários vejam um resumo gerado pelo Gemini de uma Análise do Looker.
    • Assistente de insights da Análise : ativa o Assistente de insights , que permite que os usuários façam perguntas em linguagem natural sobre uma Análise e criem e modifiquem consultas com base na Análise.
    • Inícios rápidos assistidos por IA : ativa as análises de início rápido geradas pelo Gemini para uma Análise do Looker.
    • Publicar no Gemini Enterprise : permite que os proprietários de agentes de dados das Análises de conversação publiquem os agentes no Gemini Enterprise quando também têm um papel 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 que hospeda a instância de destino do Gemini Enterprise. Google Cloud
      • No campo Região, insira a região da instância do Gemini Enterprise. A região está listada em Local 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.
      • No Google Cloud console, conceda à conta de serviço gerada pelo Looker o papel do IAM de administrador do Gemini Enterprise no Google Cloud projeto que hospeda a instância do Gemini Enterprise.

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 assistidos pelo Gemini, os usuários precisam receber um papel do Looker que aplique a permissão gemini_in_looker aos modelos adequados, bem como um papel que contenha permissões para realizar a tarefa assistida pelo Gemini. Você pode atribuir a permissão gemini_in_looker de uma das seguintes maneiras:

Conceder o papel padrão Gemini

A permissão gemini_in_looker é a única permissão incluída no Gemini papel padrão, que, por padrão, se aplica a todos os modelos na 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 esse papel aos usuários ou grupos adequados.

Conceder uma função personalizada

Para restringir o acesso dos usuários aos recursos do Gemini no Looker para todos os modelos na instância do Looker, você pode criar um papel personalizado do Looker que aplique a permissão gemini_in_looker apenas para modelos específicos e atribuí-lo aos usuários ou grupos adequados. Talvez seja necessário remover esses usuários do grupo Usuários padrão do Gemini, que recebe o papel 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 da Análises de conversação

O papel Gerente de agentes das Análises de conversação consiste no conjunto de permissões do gerente de agentes das Análises de conversação para todos os modelos na instância do Looker. Os usuários com esse papel podem criar, editar, compartilhar e excluir agentes de dados das Análises de conversação que usam as Análises do Looker.

A função Usuário das Análises de conversação consiste no conjunto de permissões Usuário das Análises de conversação para todos os modelos na instância do Looker. Os usuários com esse papel podem conversar com qualquer agente de dados das Análises de conversação no Looker.

Você pode atribuir qualquer um desses papéis aos usuários ou grupos adequados. Também é possível criar um papel personalizado do Looker que aplique qualquer uma das permissões de Análises de conversação 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 nesse grupo recebem o papel Gemini, que concede a capacidade de usar os recursos do Gemini no Looker quando também têm um papel 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 outros papéis 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.

Outras permissões do Looker podem ser necessárias para realizar as tarefas que o Gemini ajuda. Consulte a seção Outras permissões nesta página para conferir uma lista dessas permissões.

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 assistida pelo Gemini. Essas permissões são resumidas na lista a seguir:

  • Para usar a Análises de conversação ou a API Conversational Analytics para consultar dados do Looker ou criar um agente de dados, você precisa receber um papel do Looker que contenha as permissões access_data e gemini_in_looker para cada modelo que você está consultando. Permissões adicionais são necessárias dependendo de como você está interagindo com as Análises de conversação. Esse recurso está disponível quando a configuração Análises de conversação está ativada.
  • Para usar o Assistente de visualização para 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 está disponível quando a configuração Assistentes do Looker está ativada.
  • Para usar a Análise avançada em agentes de dados das Análises de conversação para traduzir suas perguntas em linguagem natural em código Python e executar esse código para fornecer análises e visualizações avançadas, você precisa receber um papel que tenha as mesmas permissões necessárias para usar agentes de dados das Análises de conversação.
  • Para escrever LookML com a ajuda do Gemini, você precisa ter um papel do Looker que contenha a develop permissão para pelo menos um modelo em um projeto do LookML. Esse recurso está disponível quando a configuração Assistente do LookML está ativada.
  • Para gerar resumos da Análise, 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 visualizar e interagir com as Análises. Esse recurso está disponível quando a configuração Resumo de NL da Análise está ativada.
  • Para gerar análises de início rápido, você precisa receber 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ícios rápidos assistidos 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 para 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 está disponível quando a configuração Assistente de expressão está ativada.
  • Para usar o Assistente de insights para fazer perguntas sobre uma Análise e usar a assistência do Gemini para criar ou modificar uma Análise, você precisa receber um papel do Looker que contenha a explore permissão. Esse recurso está disponível quando a configuração Assistente de insights 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.