Esta página foi traduzida pela API Cloud Translation.

Comece a usar o Gêmeos

Esta página ajuda os desenvolvedores a configurar um projeto isolado do Google Distributed Cloud (GDC) para usar modelos do Gemini. Esse processo inclui criar um projeto, ativar a API Gemini, instalar bibliotecas de cliente, definir variáveis de ambiente e autenticar suas credenciais. Se você não conhece o Gemini, saiba mais sobre os recursos dele.

Para começar a usar o Gemini, use o console do GDC e a CLI gdcloud da seguinte maneira:

Console do GDC: ative a API Gemini e confira o status e o endpoint do modelo.
CLI gdcloud: configure contas de serviço, instale bibliotecas de cliente e autentique solicitações de API.

Criar um projeto

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

O Gemini é um dos modelos de IA generativa oferecidos pela Vertex AI no GDC. Portanto, para criar um projeto, consulte Configurar um projeto para a Vertex AI. Você precisa do ID do projeto ao fazer chamadas de API.

Solicitar permissões de desenvolvedor

Você precisa ter as funções adequadas no seu projeto para acessar os recursos do Gemini e gerar tokens de API para autenticação e autorização de solicitações.

Peça ao administrador do IAM do projeto para conceder um dos papéis associados do Gemini à sua conta de usuário ou serviço no namespace do projeto. Para informações sobre papéis do Gemini, consulte Preparar permissões do IAM.

Ativar a API Gemini

É necessário ativar a API Gemini no seu projeto. Se ativada, você pode conferir o status do serviço e o endpoint da API Gemini.

Instalar bibliotecas de cliente

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

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

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

Definir as variáveis de ambiente

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

Se você configurar uma conta de serviço no projeto para fazer chamadas de API autorizadas de forma programática, poderá definir variáveis de ambiente em um script Python para acessar valores como as chaves da conta de serviço.

Siga estas etapas para definir as variáveis de ambiente necessárias em um script Python:

Crie um script em 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 arquivo JSON que contém as chaves da conta de serviço criadas no projeto, como my-service-key.json.
Desenvolvimento
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
os.environ["GRPC_DEFAULT_SSL_ROOTS_FILE_PATH"] = "CERT_NAME"
```
Substitua:
- APPLICATION_DEFAULT_CREDENTIALS_FILENAME: o nome do arquivo JSON que contém as chaves da conta de serviço criadas no projeto, como my-service-key.json.
- CERT_NAME: o nome do arquivo de certificado da autoridade de certificação (CA), como org-1-trust-bundle-ca.cert. Para mais informações, consulte Gerar o arquivo de certificado da CA do pacote de confiança em um ambiente de desenvolvimento.
Salve o script do Python com um nome.
Execute o script Python para definir as variáveis de ambiente:
```
python SCRIPT_NAME
```
Substitua SCRIPT_NAME pelo nome que você deu ao script Python.

Configurar a autenticação

Antes de começar a usar a API Gemini, autentique suas credenciais de cliente e solicite acesso à conta dos recursos do projeto. Para mais informações, consulte Autenticar solicitações de API.