Configurer l'environnement

Avant de travailler avec LangChain dans Vertex AI, vous devez vous assurer que votre environnement est configuré. Vous devez disposer d'un projet Google Cloud avec la facturation activée, disposer des autorisations requises, configurer un bucket Cloud Storage et installer le SDK Vertex AI pour Python. Utilisez les rubriques suivantes pour vous assurer que vous êtes prêt à commencer à utiliser LangChain dans Vertex AI.

Configurer un projet Google Cloud

1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

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

   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

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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   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

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

7. Enable the Vertex AI and Cloud Storage APIs.

   Enable the APIs

Obtenir les rôles requis

Pour obtenir les autorisations nécessaires pour utiliser Reasoning Engine, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

• Utilisateur Vertex AI (roles/aiplatform.user)
• Administrateur de l'espace de stockage (roles/storage.admin)

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Configurer les autorisations de votre agent de service

Les applications que vous déployez sur Reasoning Engine s'exécutent en tant que compte de service Agent de service AI Platform Reasoning Engine. Ce compte dispose d'un rôle Agent de service Reasoning Engine Vertex AI qui accorde les autorisations de base requises par votre application Reasoning Engine. Vous pouvez afficher la liste complète des autorisations de base dans la documentation IAM.

Si vous avez besoin d'autorisations supplémentaires, vous pouvez attribuer des rôles supplémentaires à cet agent de service en procédant comme suit:

1. Accédez à la page IAM, puis cochez la case "Inclure les attributions de rôles fournies par Google".

   Accéder à IAM

2. Recherchez le compte principal correspondant à [e-mail].

3. Ajoutez les rôles requis au compte principal en cliquant sur le bouton de modification, puis sur le bouton d'enregistrement.

Créer un bucket Cloud Storage

Reasoning Engine préproduit les artefacts de vos applications dans un bucket Cloud Storage dans le cadre du processus de déploiement. Assurez-vous que le compte principal authentifié pour utiliser Vertex AI (vous-même ou un compte de service) dispose d'un accès Storage Admin à ce bucket. Cela est nécessaire, car le SDK Vertex AI pour Python empaquette et écrit votre code dans ce 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.

Ligne de commande

Create a Cloud Storage bucket and configure it as follows:
• Remplacez STORAGE_CLASS par la classe de stockage de votre choix.
• Remplacez LOCATION par l'emplacement de votre choix (ASIA, EU ou US)
• Remplacez BUCKET_NAME par Ce nom doit respecter les exigences relatives aux noms de buckets.

gcloud storage buckets create gs://BUCKET_NAME --default-storage-class STORAGE_CLASS --location LOCATION

Installer et initialiser le SDK Vertex AI pour Python

Exécutez la commande suivante pour installer le package Reasoning Engine du SDK Vertex AI pour Python :

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

Exécutez le code suivant pour importer et initialiser le SDK pour Reasoning Engine :

import vertexai
from vertexai.preview import reasoning_engines

vertexai.init(
    project="PROJECT_ID",
    location="LOCATION",
    staging_bucket="gs://BUCKET_NAME",
)

• PROJECT_ID : ID de votre projet
• LOCATION : votre région. Pour le moment, seule la région us-central1 est prise en charge.
• BUCKET_NAME : votre bucket Google Cloud

Étapes suivantes

• Développer une application