Integrare con Agent Platform

L'integrazione di AlloyDB per PostgreSQL con Gemini Enterprise Agent Platform consente di eseguire query SQL che passano i dati del database direttamente ai modelli di Agent Platform per la generazione di embedding e le previsioni online.

Queste istruzioni sono specifiche per l'utilizzo di AlloyDB e non di AlloyDB Omni. Per integrare un'installazione locale di AlloyDB Omni utilizzando la piattaforma dell'agente, consulta Installa AlloyDB Omni con AlloyDB AI.

Per saperne di più sull'utilizzo dei modelli di ML con AlloyDB, consulta Crea applicazioni di AI generativa utilizzando AlloyDB AI.

Per saperne di più su Agent Platform, consulta la panoramica di Agent Platform.

Prima di iniziare

Accedi al tuo account Google Cloud . 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, 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

Informazioni sull'agente di servizio AlloyDB

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

Concedi il ruolo Vertex AI User all'agente di servizio AlloyDB

Per abilitare l'integrazione del database con Agent Platform, concedi all'agente di servizio AlloyDB il ruolo Vertex AI User. In questo modo, l'agente di servizio AlloyDB può accedere alla piattaforma dell'agente per tuo conto.

Nota: per concedere i ruoli IAM, devi disporre dell'autorizzazione resourcemanager.projects.setiamPolicy. I ruoli Proprietario e Amministratore IAM progetto includono questa autorizzazione. Il ruolo Amministratore AlloyDB include anche le autorizzazioni necessarie per concedere il ruolo Vertex AI User all'agente di servizio. Se non disponi delle autorizzazioni necessarie, contatta l'amministratore della tua organizzazione.

Segui questi passaggi per concedere all'agente di servizio AlloyDB il ruolo Vertex AI User:

Aggiungi le autorizzazioni della piattaforma dell'agente all'agente di servizio AlloyDB per il progetto in cui si trova il cluster del database AlloyDB:

Console

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

   Vai alla pagina di benvenuto

2. Nella console Google Cloud vai alla pagina IAM.

   Vai a IAM

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

4. Attiva 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 del 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 della piattaforma dell'agente.
• PROJECT_NUMBER: il numero del progetto che contiene cluster o istanze AlloyDB.

Nota: la modifica della policy diventa effettiva entro un periodo compreso tra 60 secondi e 7 minuti.

Verifica l'estensione installata

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

Console

1. Nella console Google Cloud , 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 prevedi di richiamare le previsioni dalle istanze del pool di lettura in un secondo momento.

5. Nella scheda Editor 1, completa quanto segue:

   1. Verifica che sia installata l'estensione google_ml_integration versione 1.4.2 o successiva:

      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 client psql all'istanza principale del cluster, come descritto in Connetti un client psql 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 l'estensione google_ml_integration versione 1.4.2 o successiva:

   SELECT extversion FROM pg_extension WHERE extname = 'google_ml_integration';

Passaggi successivi

• Utilizza gli embedding

• Richiama le previsioni

• Quote e limiti di Agent Platform

• Chiama gli endpoint del modello remoto