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 admin do Looker para a instância do Looker (Google Cloud Core) e o papel de admin 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 conversacional ainda não está incluída nos limites de autorização do FedRAMP de nível médio ou alto. 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 Cloud' atendem à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 conversacional 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, 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 à análise conversacional residem estritamente na instância do Looker e são confinados a uma única região. Os dados em trânsito e o machine learning (ML) são processados usando um serviço global.

Administração e governança de recursos

Embora você ative o Gemini no Looker no Google Cloud console, não é possível administrar como o Gemini opera no Google Cloud console do ou no Google Admin Console. Depois que o Gemini é ativado, você administra todos os recursos diretamente na instância do Looker.

O Gemini no Looker tem comportamentos independentes de tratamento, retenção e registro de dados quando comparado a aplicativos independentes do Gemini (como o web app do Gemini). Para mais informações, consulte Governança de dados, retenção de histórico e auditoria de registros.

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ê opapel do IAM de admin 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 com papéis personalizados ou outros papéis predefinidos.

Para realizar as tarefas a seguir, você precisa ser um admin 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 do:

  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 admin do Looker pode ativar seletivamente os recursos disponíveis do Gemini no Looker no painel de admin Admin 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 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 ser ativada para que os usuários acessem os recursos do Gemini que estão na versão prévia.
  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 Admin 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 admins 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 em disponibilidade 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 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 Admin, navegue até a seção Plataforma e selecione a página Gemini no Looker.
  2. Ative as seguintes configurações para ativar cada um dos recursos correspondentes com disponibilidade geral:
    • Análise conversacional:
    • Outras opções:
      • Análise avançada : permite que os criadores de agentes de dados de análise conversacional ativem a análise avançada para todas as conversas com o agente de dados. Para usar a análise avançada, você também precisa ativar a configuração de análise conversacional que corresponde ao conteúdo que está consultando (Análise conversacional (página de conversas) ou Agentes do painel). Se as configurações Análise conversacional (página de conversas) e Agentes do painel estiverem desativadas, a Análise avançada não poderá ser ativada. Se a Análise conversacional (página de conversas) ou os Agentes do painel estiverem ativados, a Análise avançada poderá ser ativada, mas ela estará desativada por padrão.
    • Recursos da plataforma:
  3. Em Recursos da plataforma, selecione Ativar recursos do Trusted Tester para conceder aos usuários acesso aos recursos do Trusted Tester do Gemini no Looker que estão na versão prévia. Em seguida, ative as seguintes configurações para ativar cada um dos recursos correspondentes da versão prévia:
    • Ativar o resumo do painel : mostra um resumo do painel para entregas programadas. Essa configuração exige que as configurações Ativar recursos do Trusted Tester e Agentes do painel estejam ativadas.
    • 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.
    • Agentic Workflows: permite que os usuários solicitem agentes e conversas de análise conversacional para gerar Agentic Workflows para monitorar mudanças nos dados. Essa configuração exige a configuração Ativar recursos do Trusted Tester e a configuração de análise conversacional que corresponde ao conteúdo que você está usando (Análise conversacional (página de conversas) para análises ou Agentes do painel para painéis).
    • Assistente de admin : ajuda os admins do Looker a gerenciar os papéis do Looker.
    • Descobrir resumo de NL : 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.
    • Publicar no Gemini Enterprise : permite que os proprietários de agentes de dados de análise conversacional publiquem os agentes no Gemini Enterprise quando também têm um papel que contém a permissão publish_agent_externally. Essa configuração exige que as configurações Ativar recursos do trusted tester e Análise conversacional (página de conversas) estejam ativadas. 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. Se você mudar a instância de destino do Gemini Enterprise, todos os agentes publicados na instância original do Gemini Enterprise serão despublicados automaticamente.
      • No Google Cloud console do, conceda à conta de serviço gerada pelo Looker o papel do IAM de admin do Discovery Engine no Google Cloud projeto que hospeda a instância do Gemini Enterprise. A conta de serviço apropriada a ser usada é mostrada na página de ativação 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 assistidos pelo Gemini, os usuários precisam receber um papel do Looker que aplique a permissão gemini_in_looker aos modelos apropriados, 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 qualquer uma das seguintes maneiras:

Conceder o papel padrão Gemini

O Gemini papel padrão aplica todas as permissões necessárias para interagir com agentes de dados de análise conversacional e usar o Gemini no Looker em 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 apropriados.

Conceder um papel personalizado

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 apropriados. 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 de análise conversacional

O papel Gerente de agentes de análise conversacional consiste no conjunto de permissões Gerente de agentes de análise conversacional para todos os modelos na instância do Looker. Os usuários com esse papel podem criar, editar, compartilhar e excluir agentes de dados de análise conversacional.

O papel Usuário de análise conversacional consiste no conjunto de permissões Usuário de análise conversacional para todos os modelos na instância do Looker. Os usuários com esse papel podem conversar com qualquer agente de dados de análise conversacional no Looker.

Você pode atribuir qualquer um desses papéis aos usuários ou grupos apropriados. Você também pode criar um papel personalizado do Looker que aplique qualquer uma das permissões de análise conversacional 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. Você também pode 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 Permissões adicionais nesta página para conferir uma lista dessas permissões.

Permissões adicionais

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álise conversacional 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 está consultando. Permissões adicionais são necessárias dependendo de como você está interagindo 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 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 de análise conversacional 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 de análise conversacional.
  • 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 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 explore permissão para visualizar 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 perguntas iniciais, você precisa receber 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 Assistentes do Looker 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 Assistentes do Looker 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 permissão explore. Esse recurso está disponível quando a configuração Assistente de insights está ativada.
  • Para usar o Assistente de admin para ajudar na criação e modificação de papéis do Looker, você precisa ter o papel de Admin. Esse recurso está disponível quando a configuração Assistente de admin 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.