Integrar com a plataforma de agentes

A integração do AlloyDB para PostgreSQL com a Gemini Enterprise Agent Platform permite executar consultas SQL que transmitem os dados do banco de dados diretamente para os modelos da Agent Platform para geração de embeddings e previsões on-line.

Estas instruções são específicas para o uso do AlloyDB, e não do AlloyDB Omni. Para integrar uma instalação local do AlloyDB Omni usando a Plataforma de Agentes, consulte Instalar o AlloyDB Omni com a IA do AlloyDB.

Para mais informações sobre como usar modelos de ML com o AlloyDB, consulte Criar aplicativos de IA generativa usando a IA do AlloyDB.

Para mais informações sobre a Agent Platform, consulte Visão geral da Agent Platform.

Antes de começar

Faça login na sua conta do Google Cloud . 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 sem custos financeiros.

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 Agent Platform API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

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 Agent Platform API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

To initialize the gcloud CLI, run the following command:

gcloud init

Sobre o agente de serviço do AlloyDB

Quando você usa o AlloyDB com outros serviços do Google Cloud , o AlloyDB usa um agente de serviço do Identity and Access Management (IAM) para se autenticar nesses serviços. Esse agente de serviço é um principal do IAM controlado pelo AlloyDB. Conceda papéis do IAM a esse agente de serviço para que ele possa acessar outros serviços do Google Cloud em seu nome.

Conceda o papel Vertex AI User ao agente de serviço do AlloyDB

Para ativar a integração do banco de dados com a Agent Platform, conceda ao agente de serviço do AlloyDB o papel Vertex AI User. Isso permite que o agente de serviço do AlloyDB acesse a Agent Platform em seu nome.

Observação: para conceder papéis do IAM, é preciso ter a permissão resourcemanager.projects.setiamPolicy. Os papéis de proprietário e administrador do IAM do projeto incluem essa permissão. O papel de administrador do AlloyDB também inclui as permissões necessárias para conceder o papel de usuário da Vertex AI ao agente de serviço. Se você não tiver as permissões necessárias, entre em contato com o administrador da sua organização.

Siga estas etapas para conceder ao agente de serviço do AlloyDB o papel Vertex AI User:

Adicione permissões da plataforma de agente ao agente de serviço do AlloyDB para o projeto em que o cluster do banco de dados do AlloyDB está localizado:

Console

1. Acesse a página Início no console do Google Cloud e copie o número do projeto que tem clusters ou instâncias do AlloyDB. Você vai usar esse número nas próximas etapas.

   Acesse "Boas-vindas"

2. No console do Google Cloud , acesse a página IAM.

   Acessar IAM

3. Selecione o projeto que precisa chamar os endpoints da Agent Platform.

4. Ative Incluir concessões de papel fornecidas pelo Google.

5. Clique em Conceder acesso.

6. No campo Novos participantes, insira o seguinte:

       [e-mail]
       

   Substitua PROJECT_NUMBER pelo número do projeto.

7. No campo Papel, digite Usuário da Vertex AI.

8. Clique em Salvar.

gcloud

Para usar a CLI gcloud, você pode instalar e inicializar a Google Cloud CLI ou usar o Cloud Shell.

        gcloud projects add-iam-policy-binding PROJECT_ID 

        --member="serviceAccount:[e-mail]" 

        --role="roles/aiplatform.user"
  

Substitua:

• PROJECT_ID: o ID do projeto que tem o endpoint da plataforma de agentes.
• PROJECT_NUMBER: o número do projeto que tem clusters ou instâncias do AlloyDB.

Observação: a mudança na política entra em vigor em um período de 60 segundos a 7 minutos.

Verificar a extensão instalada

Verifique se o google_ml_integration está instalado no banco de dados que contém os dados em que você quer executar previsões:

Console

1. No Google Cloud console, acesse a página Clusters.

   Acessar Clusters

2. Para exibir a página Visão geral do cluster, clique no nome do cluster do AlloyDB na coluna Nome do recurso.

3. No menu de navegação, clique em AlloyDB Studio.

4. Na página Fazer login no AlloyDB Studio, autentique-se usando o nome do seu banco de dados, nome de usuário e senha.

   Observação: o AlloyDB Studio se conecta à instância principal do cluster, que é onde o gerenciamento de extensões e as previsões iniciais são processados, mesmo que você pretenda invocar previsões de instâncias do pool de leitura mais tarde.

5. Na guia Editor 1, faça o seguinte:

   1. Verifique se a versão 1.4.2 ou mais recente da extensão google_ml_integration está instalada:

      SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

   2. Clique em Executar. Aguarde até que a versão da extensão apareça no painel Resultados.

psql

1. Conecte um cliente psql à instância principal do cluster, conforme descrito em Conectar um cliente psql a uma instância.

   Observação :é necessário se conectar à instância principal, mesmo que você pretenda invocar previsões enquanto estiver conectado a uma instância de pool de leitura.

2. No prompt de comando psql, conecte-se ao banco de dados:

   \c DB_NAME

   Substitua DB_NAME pelo nome do banco de dados em que você quer instalar a extensão.

3. Verifique se a versão 1.4.2 ou mais recente da extensão google_ml_integration está instalada:

   SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

A seguir

• Trabalhar com embeddings

• Invocar previsões

• Cotas e limites da Agent Platform

• Chamar endpoints de modelo remoto