Usar a CLI do Gemini

Usar a CLI do Gemini

Visualizar

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Nesta página, descrevemos como usar a interface de linha de comando (CLI) do Gemini com uma instância do Workbench da Agent Platform do Gemini Enterprise.

Este documento é destinado a analistas, cientistas e desenvolvedores de dados que trabalham com o Workbench da Agent Platform. Ele pressupõe que você sabe como escrever código em um ambiente de notebook.

Visão geral

A CLI do Gemini é um agente de IA de código aberto que dá acesso ao Gemini diretamente em um terminal. Para mais informações, consulte geminicli.com.

A CLI do Gemini está disponível nas instâncias do Workbench da Agent Platform. Você pode usar a CLI do Gemini para:

• Criar um notebook.
• Executar células de notebook.
• Escrever e editar o código e as células de texto de um notebook.
• Explicar códigos e conceitos técnicos.
• Interagir com o sistema de arquivos local de uma instância do Workbench da Agent Platform, incluindo a execução de operações complexas em vários arquivos com base em uma única instrução de alto nível.
• Executar comandos básicos do shell.
• Executar comandos para interagir com outros Google Cloud serviços, como a Agent Platform do Gemini Enterprise e o BigQuery.

Limitações

Considere as seguintes limitações ao usar a CLI do Gemini com o Workbench da Agent Platform:

• A CLI do Gemini é apenas uma CLI. Uma interface gráfica de chat e ferramentas avançadas no editor não estão incluídas.

• Quando você pede ao Gemini CLI para modificar um notebook, a CLI do Gemini muda o arquivo do notebook diretamente no disco da instância. Por isso, não é possível desfazer as edições feitas pela CLI do Gemini usando o botão Desfazer do editor de notebooks ou Control+Z (Command+Z no macOS). No entanto, você pode pedir para a CLI do Gemini desfazer uma mudança usando um comando de linguagem natural, como Undo your last change.

Antes de começar

Como uma tecnologia em estágio inicial, os produtos do Gemini para Google Cloud podem gerar uma saída plausível, mas que é factualmente incorreta. Recomendamos que você valide todas as saídas dos produtos do Gemini para Google Cloud antes de usá-las. Para mais informações, consulte Gemini para Google Cloud e IA responsável.

Faça login na sua Google Cloud conta do. Se você começou a usar o Google Cloud, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Notebooks, and Agent Platform APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine, Notebooks, and Agent Platform APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Funções exigidas

Para usar a CLI do Gemini no Workbench da Agent Platform, é necessário conceder permissões ao usuário da instância do Workbench da Agent Platform e à conta de serviço da instância.

**Observação** :a CLI do Gemini opera estritamente dentro das permissões do ambiente da instância do Workbench da Agent Platform. Se você (ou a conta de serviço usada pela instância) não tiver permissão para acessar um recurso específico, a CLI do Gemini também não poderá acessá-lo Se um comando falhar devido a permissões, peça ao administrador para conceder as permissões necessárias.

Conceder permissões ao usuário da instância

Para receber as permissões necessárias para usar a CLI do Gemini em uma instância do Workbench da Agent Platform, peça ao administrador para conceder a você o papel do IAM de usuário da Agent Platform (roles/aiplatform.user) no projeto. 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.

Conceder uma permissão à conta de serviço da instância

Para garantir que a conta de serviço da instância do Workbench da Agent Platform tenha a permissão necessária para permitir que a CLI do Gemini seja executada em uma instância do Workbench da Agent Platform, peça ao administrador para conceder o papel do IAM de usuário da Agent Platform (roles/aiplatform.user) à conta de serviço da instância do Workbench da Agent Platform no projeto.

Importante: conceda esse papel à conta de serviço da instância do Workbench da Agent Platform, não à sua conta de usuário. Se o papel não for concedido ao principal correto, poderão ocorrer erros de permissão.

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém a aiplatform.endpoints.predict permissão, que é necessária para permitir que a CLI do Gemini seja executada em uma instância do Workbench da Agent Platform.

O administrador também pode conceder essa permissão à conta de serviço da instância do Workbench da Agent Platform com papéis personalizados ou outros papéis predefinidos.

Usar a CLI do Gemini

1. No Google Cloud console, acesse a página Instâncias.

   Acesse "Instâncias"

2. Ao lado do nome de uma instância do Workbench da Agent Platform, clique Abrir JupyterLab.

   Sua instância do Workbench da Agent Platform abre o JupyterLab.

3. No JupyterLab, clique em Arquivo > Novo inicializador.

4. Na guia Inicializador, na seção Outros, clique no bloco CLI do Gemini.

5. Se esta for a primeira vez que você abre um terminal da CLI do Gemini, insira Y para aceitar os termos e condições.

   Sua instância do Workbench da Agent Platform instala a CLI do Gemini.

6. No terminal da CLI do Gemini, insira um comando.

   Por exemplo, você pode inserir Create a new notebook named 'test-notebook'. Para ver exemplos de comandos que podem ser úteis, consulte Comandos de amostra.

Comandos de amostra

Para ajudar você a ter ideias de como usar a CLI do Gemini, consulte os seguintes comandos de amostra:

• "Crie um notebook que treine um modelo para prever 'faixa de renda' de bigquery-public-data.ml_datasets.census_adult_income, usando o BigQuery e o Python."

• "Resuma o notebook chamado 'test-file' e proponha as próximas etapas do projeto."

• "Quero ter uma visão geral rápida dos notebooks neste diretório. Para cada arquivo .ipynb, mostre as cinco primeiras linhas do arquivo."

• "Crie um script usando o conteúdo do notebook 'test-file'."

• "Mostre como acessar dados de tabelas do BigQuery no Workbench da Agent Platform."

• "Consulte a tabela bigquery-public-data.ml_datasets.census_adult_income para encontrar o número de pessoas com uma faixa de renda de > 50 mil."

• "Defina meu projeto padrão como my-project." Google Cloud

• Crie um bucket do Cloud Storage e faça upload de todos os arquivos CSV do meu diretório atual para ele.

• "Crie uma instância do Compute Engine com uma imagem do Debian 11 e um tipo de máquina n1-standard-4."

• "Crie um arquivo de notebook que execute o código no 'test-script'. Adicione células de texto que expliquem o código."

Controlar o acesso à CLI do Gemini

É possível controlar o acesso à CLI do Gemini no Workbench da Agent Platform usando os seguintes métodos:

• Um administrador pode configurar uma política da organização para restringir o uso de modelos específicos do Gemini no nível da organização, da pasta ou do projeto. Consulte Controlar o acesso aos modelos do Model Garden. A CLI do Gemini continua aparecendo no JupyterLab, mas não responde a comandos.

• Ao não conceder a permissão aiplatform.endpoints.predict, um administrador pode impedir que algumas identidades usem os endpoints do Gemini para inferência.

Usar o comando mágico da CLI do Gemini

Para usar a CLI do Gemini diretamente em uma célula no arquivo do notebook, faça o seguinte:

1. Verifique se a CLI do Gemini está ativada e se o usuário ou criador aceitou os termos e condições.
2. Na primeira linha de uma nova célula, insira %%geminicli_magic.
3. Na mesma célula, insira o comando na linha a seguir.
4. Execute a célula.

A CLI do Gemini adiciona uma nova célula abaixo com a resposta.

Resolver problemas

Se você encontrar um problema ao usar a CLI do Gemini com instâncias do Workbench da Agent Platform, consulte Como solucionar problemas do Workbench da Agent Platform para receber ajuda com problemas comuns.

A seguir

• Saiba mais sobre Gemini.

• Para saber mais sobre os métodos de consulta de dados do BigQuery em notebooks do Workbench da Agent Platform, consulte Consultar dados no BigQuery pelo JupyterLab.