Premiers pas avec Gemini

Cette page aide les développeurs à configurer un projet Google Distributed Cloud (GDC) isolé pour utiliser les modèles Gemini. Ce processus inclut la création d'un projet, l'activation de l'API Gemini, l'installation de bibliothèques clientes, la définition de variables d'environnement et l'authentification de vos identifiants. Si vous n'avez jamais utilisé Gemini, découvrez ses fonctionnalités.

Pour commencer à utiliser Gemini avec la console GDC et la CLI gdcloud :

  • Console GDC : activez l'API Gemini et affichez l'état et le point de terminaison du modèle.
  • gcloud CLI : configurez les comptes de service, installez les bibliothèques clientes et authentifiez les requêtes API.

Créer un projet

La création d'un projet dans votre hiérarchie des ressources Distributed Cloud permet d'organiser vos ressources, qui incluent les collaborateurs, les API activées, les identifiants d'authentification et les contrôles d'accès.

Gemini est l'un des modèles d'IA générative proposés par Vertex AI sur GDC. Par conséquent, pour créer un projet, consultez Configurer un projet pour Vertex AI. Vous avez besoin de l'ID de votre projet pour effectuer des appels d'API.

Demander des autorisations de développeur

Vous devez disposer des rôles appropriés dans votre projet pour accéder aux fonctionnalités Gemini et générer des jetons d'API pour l'authentification et l'autorisation des requêtes.

Demandez à l'administrateur IAM de votre projet d'attribuer l'un des rôles Gemini associés à votre compte utilisateur ou de service dans l'espace de noms de votre projet. Pour en savoir plus sur les rôles Gemini, consultez Préparer les autorisations IAM.

Activer l'API Gemini

Vous devez activer l'API Gemini pour votre projet. Si elle est activée, vous pouvez afficher l'état du service et le point de terminaison de l'API Gemini.

Installer les bibliothèques clientes

Des bibliothèques clientes sont disponibles pour le langage de programmation Python. Nous vous recommandons d'utiliser ces bibliothèques clientes pour appeler l'API Gemini, car elles facilitent l'accès aux API.

Pour utiliser le SDK Python compatible avec OpenAI, installez le SDK OpenAI et les autres bibliothèques Python requises :

pip install openai
pip install absl-py
pip install typing
pip install protobuf

Définir les variables d'environnement

Après avoir installé les bibliothèques clientes, vous pouvez interagir avec l'API à partir d'un script Python.

Si vous configurez un compte de service dans votre projet pour effectuer des appels d'API autorisés de manière programmatique, vous pouvez définir des variables d'environnement dans un script Python pour accéder à des valeurs telles que les clés de compte de service.

Pour définir les variables d'environnement requises dans un script Python, procédez comme suit :

  1. Créez un script Python.

  2. Ajoutez le code suivant au script Python :

    Production 

    import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"

    Remplacez APPLICATION_DEFAULT_CREDENTIALS_FILENAME par le nom du fichier JSON contenant les clés de compte de service que vous avez créées dans le projet, par exemple my-service-key.json.

    Développement 

    import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
os.environ["GRPC_DEFAULT_SSL_ROOTS_FILE_PATH"] = "CERT_NAME"

    Remplacez les éléments suivants :

  3. Enregistrez le script Python sous un nom.

  4. Exécutez le script Python pour définir les variables d'environnement :

    python SCRIPT_NAME

    Remplacez SCRIPT_NAME par le nom que vous avez donné à votre script Python.

Configurer l'authentification

Avant de pouvoir utiliser l'API Gemini, vous devez authentifier vos identifiants client et demander l'accès au compte pour les ressources de votre projet. Pour en savoir plus, consultez Authentifier les requêtes API.