Integrare con Agent Platform

Questa pagina descrive in dettaglio come configurare l'integrazione tra AlloyDB per PostgreSQL e Gemini Enterprise Agent Platform, che ti consente di inviare query che passano i tuoi dati ai modelli di Agent Platform.

Queste istruzioni sono specifiche per l'utilizzo di AlloyDB e non di AlloyDB Omni. Per integrare invece un'installazione locale di AlloyDB Omni utilizzando Agent Platform, consulta Installare AlloyDB Omni con AlloyDB AI.

Per ulteriori informazioni sull'utilizzo dei modelli di machine learning con AlloyDB, consulta Creare applicazioni di AI generativa utilizzando AlloyDB AI.

Per ulteriori informazioni su Agent Platform, consulta la panoramica di Agent Platform.

Prima di iniziare

Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

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.

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

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

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.

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

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Informazioni sul service agent AlloyDB

Quando utilizzi AlloyDB con altri Google Cloud servizi, AlloyDB utilizza un service agent Identity and Access Management (IAM) per l'autenticazione a questi servizi. Questo service agent è un'entità IAM controllata da AlloyDB. Concedi i ruoli IAM a questo service agent per consentirgli di accedere ad altri Google Cloud servizi per tuo conto.

Concedi il ruolo Vertex AI User al service agent AlloyDB

Per abilitare l'integrazione del database con Agent Platform, concedi al service agent AlloyDB il ruolo Vertex AI User. In questo modo, il service agent AlloyDB può accedere ad Agent Platform per tuo conto.

Nota: per concedere i ruoli IAM, devi disporre dell'autorizzazione resourcemanager.projects.setiamPolicy. I ruoli Owner e Project IAM Admin includono questa autorizzazione. Il ruolo AlloyDB Admin include anche le autorizzazioni necessarie per concedere il ruolo Vertex AI User al service agent. Se non disponi delle autorizzazioni necessarie, contatta l'amministratore della tua organizzazione.

Per concedere al service agent AlloyDB il ruolo Vertex AI User:

Aggiungi le autorizzazioni di Agent Platform al service agent AlloyDB per il progetto in cui si trova il cluster del database AlloyDB:

Console

1. Vai alla pagina Benvenuto nella Google Cloud console e copia il numero di progetto del progetto che contiene cluster o istanze AlloyDB. Utilizzerai questo numero di progetto nei passaggi successivi.

   Vai a Benvenuto

2. Nella Google Cloud console, vai alla pagina IAM.

   Vai a IAM

3. Seleziona il progetto che deve chiamare gli endpoint di Agent Platform.

4. Attiva l'opzione Includi concessioni di ruoli fornite da Google.

5. Fai clic su Concedi l'accesso.

6. Nel campo Nuove entità, inserisci quanto segue:

       [e-mail]
       

   Sostituisci PROJECT_NUMBER con il numero di progetto.

7. Nel campo Ruolo, inserisci Vertex AI User.

8. Fai clic su Salva.

gcloud

Per utilizzare gcloud CLI, puoi installare e inizializzare Google Cloud CLI oppure puoi utilizzare Cloud Shell.

        gcloud projects add-iam-policy-binding PROJECT_ID 

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

        --role="roles/aiplatform.user"
  

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto che contiene l'endpoint di Agent Platform.
• PROJECT_NUMBER: il numero di progetto del progetto che contiene cluster o istanze AlloyDB.

Nota: la modifica della policy viene applicata entro 60 secondi e 7 minuti.

Verifica l'estensione installata

Verifica se google_ml_integration è installata nel database che contiene i dati su cui vuoi eseguire le previsioni:

Console

1. Nella Google Cloud console, vai alla pagina Cluster.

   Vai a Cluster

2. Per visualizzare la pagina Panoramica del cluster, fai clic sul nome del cluster AlloyDB nella colonna Nome risorsa.

3. Nel menu di navigazione, fai clic su AlloyDB Studio.

4. Nella pagina Accedi ad AlloyDB Studio , esegui l'autenticazione utilizzando il nome del database, il nome utente e la password.

   Nota: AlloyDB Studio si connette all'istanza principale del cluster, dove vengono gestite l'estensione e le previsioni iniziali, anche se in un secondo momento intendi richiamare le previsioni dalle istanze del pool di lettura.

5. Nella scheda Editor 1, completa i seguenti passaggi:

   1. Verifica che sia installata la versione 1.4.2 o successive dell'estensione google_ml_integration:

      SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

   2. Fai clic su Esegui. Attendi che la versione dell'estensione venga visualizzata nel riquadro Risultati.

psql

1. Connetti un psql client all'istanza principale del cluster, come descritto in Connettere un psql client a un'istanza.

   Nota: devi connetterti all'istanza principale anche se intendi richiamare le previsioni mentre sei connesso a un'istanza del pool di lettura.

2. Al prompt dei comandi psql, connettiti al database:

   \c DB_NAME

   Sostituisci DB_NAME con il nome del database su cui vuoi installare l'estensione.

3. Verifica che sia installata la versione 1.4.2 o successive dell'estensione google_ml_integration:

   SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

Passaggi successivi

• Utilizzare gli embedding

• Richiamare le previsioni

• Quote e limiti di Agent Platform

• Chiamare gli endpoint dei modelli remoti