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 do Google Cloud em que a instância reside.

O que é o Gemini no Looker?

O Gemini no Looker representa uma série de recursos no portfólio do 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 do FedRAMP High ou do FedRAMP Medium. Antes de ativar a configuração Gemini no Looker para 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 for disponibilizado vai adicionar recursos do Gemini no Looker às ofertas padrão, conforme os requisitos e processos de mudança desse pacote forem atendidos. As análises conversacionais 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), 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 estã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 console doGoogle Cloud , não é possível administrar como o Gemini opera no console do Google Cloud ou no Google Admin Console. Depois que o Gemini for ativado, você vai administrar 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 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 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 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):

  • Ativar as configurações individuais de recursos que usam a assistência do Gemini na instância do Looker (Google Cloud Core)
  • Conceder aos usuários permissões 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 do Google Cloud :

  1. Navegue até o projeto do 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 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 em 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 estar ativada para que os usuários acessem os recursos do Gemini que estão em pré-lançamento.
  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 do Gemini, dos recursos do Trusted Tester e do uso de dados do Trusted Tester para a instância, que são gerenciadas no console do Google Cloud . 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 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 em 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, acesse a seção Plataforma e selecione a página Gemini no Looker.
  2. Ative as seguintes configurações para habilitar cada um dos recursos correspondentes em disponibilidade geral:
    • Análise conversacional:
    • Outras opções:
      • Análise avançada: permite que os criadores de agentes de dados da 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 da 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 de Análise conversacional (página de conversas) e Agentes do painel estiverem desativadas, não será possível ativar a Análise avançada. 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 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 em pré-lançamento. Em seguida, ative as seguintes configurações para habilitar cada um dos recursos de pré-lançamento correspondentes:
    • Ativar o resumo do painel: mostra um resumo do painel para entregas programadas. Essa configuração exige que as opções Ativar recursos de trusted testers e Agentes do painel estejam ativadas.
    • Assistente do LookML: permite que os usuários escrevam comandos em 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 enviem comandos para agentes e conversas da Análise Conversacional para gerar fluxos de trabalho agênticos que monitoram mudanças nos dados. Essa configuração exige a opção Ativar recursos de trusted testers 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 administrador: ajuda os administradores do Looker a gerenciar as funções do Looker.
    • 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 de Análise: ativa o Assistente de Insights, que permite que os usuários façam perguntas em linguagem natural sobre uma Análise, além de 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 para uma Análise 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 tiverem um papel que contenha a permissão publish_agent_externally. Essa configuração exige que as opções Ativar recursos de trusted testers 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 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 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á 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 removidos automaticamente.
      • No console do Google Cloud , conceda à conta de serviço gerada pelo Looker o papel do IAM de administrador do Discovery Engine no projeto do Google Cloud que hospeda a instância do Gemini Enterprise. A conta de serviço apropriada para uso é exibida na página de ativação do Gemini no Looker na instância do Looker.

É necessário 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 para 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, além de um papel que contenha permissões para realizar a tarefa assistida pelo Gemini. É possível atribuir a permissão gemini_in_looker de uma das seguintes maneiras:

Conceder o papel padrão do Gemini

O papel 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 apropriados.

Como conceder um papel personalizado

Para impedir que os usuários acessem os recursos do Gemini no Looker em todos os modelos da instância do Looker, crie um papel personalizado do Looker que aplique a permissão gemini_in_looker apenas a modelos específicos e atribua-o 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álise Conversacional

O papel Gerenciador de Agentes de Análise de Conversação consiste no conjunto de permissões Gerenciador de Agentes de Análise 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 da Análise Conversacional.

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

É possível atribuir qualquer um desses papéis aos usuários ou grupos apropriados. Também é possível criar um papel personalizado do Looker que aplique qualquer uma das permissões das 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 desse grupo recebem o papel Gemini, que permite usar os recursos do Gemini no Looker quando eles 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 por completo. 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.

Talvez sejam necessárias outras permissões do Looker para realizar as tarefas em que o Gemini ajuda. Consulte a seção Permissões adicionais nesta página para ver 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 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, é necessário ter 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ê interage com a Análise Conversacional. Esse recurso fica 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 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 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 ter um papel 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 visualizar e interagir com as Análises. Esse recurso fica disponível quando a configuração Resumo de NL do Explore 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 com a configuração Início Rápido Assistido por IA 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, em seguida, usar a ajuda 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 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 de administrador está ativada.

Enviar feedback

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