Esta página foi traduzida pela API Cloud Translation.

Começar a usar o Gemini

Esta página ajuda os programadores a configurar um projeto isolado do Google Distributed Cloud (GDC) para usar os modelos Gemini. Este processo inclui a criação de um projeto, a ativação da API Gemini, a instalação de bibliotecas de clientes, a definição de variáveis de ambiente e a autenticação das suas credenciais. Se está a usar o Gemini pela primeira vez, saiba mais sobre as capacidades do Gemini.

Começa a usar o Gemini através da consola GDC e da CLI gdcloud da seguinte forma:

Consola GDC: ative a API Gemini e veja o estado do modelo e o ponto final.
CLI gcloud: configure contas de serviço, instale bibliotecas cliente e autentique pedidos de API.

Criar um projeto

A criação de um projeto na sua hierarquia de recursos da Distributed Cloud organiza os seus recursos, que incluem colaboradores, APIs ativadas, credenciais de autenticação e controlos de acesso.

O Gemini é um dos modelos de IA generativa oferecidos pela Vertex AI no GDC. Por conseguinte, para criar um projeto, consulte o artigo Configure um projeto para o Vertex AI. Precisa do ID do projeto quando faz chamadas API.

Peça autorizações de programador

Tem de ter funções adequadas no seu projeto para aceder às capacidades do Gemini e gerar tokens da API para autenticação e autorização de pedidos.

Peça ao administrador de IAM do projeto para conceder uma das funções do Gemini associadas à sua conta de utilizador ou de serviço no espaço de nomes do projeto. Para obter informações sobre as funções do Gemini, consulte o artigo Prepare as autorizações de IAM.

Ative a API Gemini

Tem de ativar a API Gemini para o seu projeto. Se estiver ativada, pode ver o estado do serviço e o ponto final da API Gemini.

Instale bibliotecas de cliente

As bibliotecas cliente estão disponíveis para a linguagem de programação Python. Recomendamos que use estas bibliotecas cliente para fazer chamadas para a API Gemini, porque facilitam o acesso às APIs.

Para usar o SDK Python compatível com a OpenAI, instale o SDK OpenAI e outras bibliotecas Python necessárias:

pip install openai
pip install absl-py
pip install typing
pip install protobuf

Defina as variáveis de ambiente

Depois de instalar as bibliotecas cliente, pode interagir com a API a partir de um script Python.

Se configurar uma conta de serviço no seu projeto para fazer chamadas de API autorizadas de forma programática, pode definir variáveis de ambiente num script Python para aceder a valores como as chaves da conta de serviço.

Siga estes passos para definir as variáveis de ambiente necessárias num script Python:

Crie um script Python.
Adicione o seguinte código ao script Python:
Produção
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
```
Substitua APPLICATION_DEFAULT_CREDENTIALS_FILENAME pelo nome do ficheiro JSON que contém as chaves da conta de serviço que criou no projeto, como my-service-key.json.
Programação
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
os.environ["GRPC_DEFAULT_SSL_ROOTS_FILE_PATH"] = "CERT_NAME"
```
Substitua o seguinte:
- APPLICATION_DEFAULT_CREDENTIALS_FILENAME: o nome do ficheiro JSON que contém as chaves da conta de serviço que criou no projeto, como my-service-key.json.
- CERT_NAME: o nome do ficheiro de certificado da autoridade de certificação (AC), como org-1-trust-bundle-ca.cert. Para mais informações, consulte o artigo Gere o ficheiro do certificado da AC do conjunto de confiança num ambiente de desenvolvimento.
Guarde o script Python com um nome.
Execute o script Python para definir as variáveis de ambiente:
```
python SCRIPT_NAME
```
Substitua SCRIPT_NAME pelo nome que atribuiu ao seu script Python.

Configure a autenticação

Antes de poder começar a usar a API Gemini, tem de autenticar as suas credenciais de cliente e pedir acesso à conta dos recursos do seu projeto. Para mais informações, consulte o artigo Autenticar pedidos de API.