Configurare l'ambiente

Prima di utilizzare LangChain in Vertex AI, devi assicurarti che il tuo ambiente sia configurato. Devi avere un progetto Google Cloud con la fatturazione abilitata, disporre delle autorizzazioni necessarie, configurare un bucket Cloud Storage e installare l'SDK Vertex AI per Python. Consulta i seguenti argomenti per prepararti a iniziare a lavorare con LangChain in Vertex AI.

Configura il progetto Google Cloud

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI and Cloud Storage APIs.

    Enable the APIs

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI and Cloud Storage APIs.

    Enable the APIs

    8.

Ottieni i ruoli richiesti

Per ottenere le autorizzazioni necessarie per utilizzare il motore di ragionamento, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Configurare le autorizzazioni dell'agente di servizio

Le applicazioni di cui esegui il deployment sul motore di ragionamento vengono eseguite come AI Platform Reasoning Account di servizio dell'agente di servizio motore. Questo account dispone del ruolo Vertex AI Reasoning Engine Service Agent che concede le autorizzazioni di base richieste dall'applicazione del motore di ragionamento. Puoi visualizzare l'elenco completo delle autorizzazioni di base nella documentazione di IAM.

Se hai bisogno di autorizzazioni aggiuntive, puoi concedere all'agente di servizio altri ruoli svolgendo i seguenti passaggi:

  1. Vai alla pagina IAM e seleziona "Includi concessioni dei ruoli fornite da Google". casella di controllo.

    Vai a IAM

  2. Trova l'entità corrispondente a service-PROJECT_NUMBER@gcp-sa-aiplatform-re.iam.gserviceaccount.com.

  3. Aggiungi i ruoli richiesti all'entità facendo clic sul pulsante di modifica e poi sul pulsante di salvataggio.

Genera manualmente un agente di servizio Reasoning Engine

Sebbene il provisioning dell'agente del servizio del motore di ragionamento venga eseguito automaticamente durante il deployment del motore di ragionamento, potrebbero verificarsi scenari in cui è necessario generarlo manualmente in precedenza. Ciò è particolarmente importante quando devi concedere ruoli specifici all'agente di servizio del motore di ragionamento per assicurarti che il processo di deployment disponga delle autorizzazioni necessarie ed eviti potenziali errori di deployment.

Ecco i passaggi per generare manualmente un agente di servizio Reasoning Engine:

  1. Genera l'agente di servizio Reasoning Engine utilizzando Google Cloud CLI.

    gcloud beta services identity create --service=aiplatform.googleapis.com --project=PROJECT-ID-OR-PROJECT-NUMBER

  2. Vai alla pagina IAM e fai clic su Concedi accesso.

    Vai a IAM

  3. Nella sezione Aggiungi entità, inserisci service-PROJECT_NUMBER@gcp-sa-aiplatform-re.iam.gserviceaccount.com nel campo Nuove entità.

  4. Nella sezione Assegna ruoli, trova e seleziona i ruoli di cui hai bisogno.

  5. Fai clic sul pulsante Salva.

Crea un bucket Cloud Storage

Il motore di ragionamento posiziona gli artefatti delle applicazioni in un nell'ambito del processo di deployment. Assicurati che il principale autenticato per utilizzare Vertex AI (tu o un account di servizio) abbia accesso Storage Admin a questo bucket. Necessario perché l'SDK Vertex AI per Python invia pacchetti e scrive il tuo codice in questo bucket.

Console Google Cloud

  1. In the Google Cloud console, go to the Cloud Storage Buckets page.

    Go to Buckets page

  2. Click Create bucket.
  3. On the Create a bucket page, enter your bucket information. To go to the next step, click Continue.
    • For Name your bucket, enter a name that meets the bucket naming requirements.
    • For Choose where to store your data, do the following:
      • Select a Location type option.
      • Select a Location option.
    • For Choose a default storage class for your data, select a storage class.
    • For Choose how to control access to objects, select an Access control option.
    • For Advanced settings (optional), specify an encryption method, a retention policy, or bucket labels.
  4. Click Create.

Riga di comando

    Create a Cloud Storage bucket and configure it as follows:
    • Sostituisci STORAGE_CLASS con il tuo preferito classe di archiviazione.
    • Sostituisci LOCATION con la tua località preferita (ASIA, EU o US)
    • Sostituisci BUCKET_NAME con un nome bucket che soddisfa nome bucket standard. 
      • gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

Installa e inizializza l'SDK Vertex AI per Python

Esegui questo comando per installare l'SDK Vertex AI per il motore di ragionamento Python pacchetto:

pip install google-cloud-aiplatform[reasoningengine,langchain]

Esegui questo codice per importare e inizializzare SDK for Reasoning Engine:

import vertexai
from vertexai.preview import reasoning_engines

vertexai.init(
    project="PROJECT_ID",
    location="LOCATION",
    staging_bucket="gs://BUCKET_NAME",
)
  • PROJECT_ID: l'ID del tuo progetto.
  • LOCATION: la tua regione. Al momento, è supportato solo us-central1.
  • BUCKET_NAME: il tuo bucket Google Cloud.

Passaggi successivi