Configurar um projeto e um ambiente de desenvolvimento

Para começar a usar a plataforma de agentes do Gemini Enterprise, esta página orienta você na criação de um projeto e na ativação das APIs da plataforma de agentes. Google Cloud Se você não tiver permissões para executar essas tarefas, peça a um administrador para configurar um projeto e ativar a Gemini Enterprise Agent Platform para você. Nesta página, também mostramos como configurar a Google Cloud CLI no seu ambiente de desenvolvimento local.

Configurar um projeto

Siga estas etapas para configurar um projeto:

  1. Faça login na sua Google Cloud conta do. Se você começou a usar o Google Cloudagora, 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.

  2. 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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Gemini Enterprise Agent Platform API.

    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 API

  5. 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.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Gemini Enterprise Agent Platform API.

    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 API

    8.

Configurar a autenticação

    Selecione as guias para definir como você quer acessar a API:

    Console

    Quando você usa o Google Cloud console para acessar Google Cloud serviços e APIs, não é necessário configurar a autenticação.

    gcloud

    1. Instale a Google Cloud CLI.

    2. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

    3. Para inicializar a CLI gcloud, execute o seguinte comando: 

      gcloud init

    4. Depois de inicializar a CLI gcloud, atualize-a e instale os componentes necessários: 

      gcloud components update
gcloud components install beta

    Para configurar a CLI gcloud e usar a identidade temporária de conta de serviço para autenticação nas APIs do Google, em vez de suas credenciais de usuário, execute o seguinte comando: 

    gcloud config set auth/impersonate_service_account SERVICE_ACCT_EMAIL

    Para mais informações, consulte Identidade temporária de conta de serviço.

    Bibliotecas de cliente

    Para usar bibliotecas de cliente em um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e configure o Application Default Credentials com suas credenciais de usuário.

    1. Instale a Google Cloud CLI.

    2. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

    3. Depois de inicializar a CLI gcloud, atualize-a e instale os componentes necessários: 

      gcloud components update
gcloud components install beta

    4. Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário: 

      gcloud auth application-default login

      Não é necessário fazer isso se você estiver usando o Cloud Shell.

      Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.

    Saiba mais em Configurar o ADC para um ambiente de desenvolvimento local na documentação de autenticação do Google Cloud .

    Para configurar o arquivo ADC local para usar a identidade temporária de conta de serviço para autenticação nas APIs do Google, em vez de suas credenciais de usuário, execute o seguinte comando: 

    gcloud auth application-default login --impersonate-service-account=SERVICE_ACCT_EMAIL

    Saiba mais em Identidade temporária de conta de serviço.

    REST

    Para usar a API REST em um ambiente de desenvolvimento local, use as credenciais que você vai informar à CLI gcloud.

    1. Instale a Google Cloud CLI.

    2. Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

    3. Depois de inicializar a CLI gcloud, atualize-a e instale os componentes necessários: 

      gcloud components update
gcloud components install beta

    Saiba mais em Autenticar para usar REST na documentação de autenticação do Google Cloud .

    É possível usar a identidade temporária de conta de serviço para gerar um token de acesso para solicitações da API REST. Saiba mais Conta de serviço representada.

    Para informações sobre como configurar a autenticação em um ambiente de produção, consulte Configurar o Application Default Credentials para código em execução em Google Cloud na documentação de autenticação. Google Cloud

Pedir a um administrador para configurar um projeto da Gemini Enterprise Agent Platform para você

Nesta seção, descrevemos como um administrador concede os papéis necessários para usar a Gemini Enterprise Agent Platform.

  1. Determine um nome e ID do projeto significativos para identificar seu projeto. Se você faz parte de uma organização ou planeja criar vários projetos, considere quais convenções de nomenclatura e hierarquias de pasta são seguidas ou podem ser seguidas, para deixar a organização do projeto clara.
  2. Papéis necessários:
    1. O acesso à maioria dos recursos da plataforma de agentes do Gemini Enterprise é concedido pelo Usuário da plataforma de agentes do Gemini Enterprise (roles/aiplatform.user) papel do IAM e é suficiente para a maioria dos usuários da plataforma de agentes do Gemini Enterprise. Para controle total dos recursos da Gemini Enterprise Agent Platform, você pode solicitar a função de administrador da Gemini Enterprise Agent Platform (roles/aiplatform.admin). Para explorar as diferenças entre esses e outros papéis da Gemini Enterprise Agent Platform, consulte Controle de acesso da Gemini Enterprise Agent Platform com o IAM.
    2. Se você também pretende usar instâncias do Vertex AI Workbench em Google Cloud, peça ao administrador para conceder a você o papel do IAM Administrador de notebooks (roles/notebooks.admin) no projeto, bem como o papel do IAM Usuário da conta de serviço (roles/iam.serviceAccountUser) no projeto ou na conta de serviço padrão do Compute Engine.
    3. Além disso, para ativar as APIs necessárias, você precisa do papel do IAM de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin) ou seu administrador precisa ativar as APIs para você, seguindo as primeiras etapas.
  3. Peça para o administrador ativar as APIs do Agent Platform para você. Se você recebeu o papel do IAM de Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin), poderá fazer isso por conta própria.

A seguir