Configurer Google Vertex AI pour les importations d'agents IA

Pour importer des agents IA depuis Google Vertex AI, vous devez créer un client OAuth 2.0 dans la console Google Cloud. Ensuite, récupérez les identifiants client et configurez l'accès des utilisateurs de test.

Une fois ces configurations terminées, suivez les étapes décrites dans la section Activer les importations d'agents IA pour une application.

Créer un client OAuth 2.0

  1. Connectez-vous à la console Google Cloud en tant qu'éditeur ou éditeur de plateforme IA affecté au projet cible.
  2. Sélectionnez le projet cible dans le menu déroulant en haut du tableau de bord.
  3. Accédez à API et services > Clients.
  4. Sélectionnez + Créer un client.
  5. Définissez le Type d'application sur Application Web.
  6. Saisissez un nom descriptif pour le client (par exemple, Vertex-Agent-Import-Client).
  7. Dans URI de redirection autorisés, sélectionnez Ajouter un URI et saisissez l'URL de rappel suivante, en remplaçant {domain} par l'URL racine de votre org Okta : 
    {domain}/oauth2/v1/sts/callback
  8. Cliquez sur Créer.
  9. Dans la boîte de dialogue Client OAuth créé, copiez les valeurs ID client et Secret client et conservez-les dans un endroit sécurisé.

Configurer l'accès des utilisateurs de test

  1. Accédez à API et services > Écran de consentement OAuth.
  2. Sélectionnez l'onglet Public.
  3. Effectuez l'une des étapes suivantes en fonction du type d'utilisateur que vous avez configuré :
    • Si le type d'utilisateur est Externe, faites défiler jusqu'à la section Utilisateurs de test, sélectionnez + Ajouter des utilisateurs et saisissez les adresses e-mail des comptes auxquels vous souhaitez accorder l'accès.
    • Si le type d'utilisateur est Interne : aucune configuration supplémentaire n'est requise. Tous les utilisateurs de votre org Google Workspace ont accès.

Tester l'intégration

Une fois la configuration OAuth terminée, effectuez les étapes de vérification suivantes pour confirmer qu'Okta peut authentifier les utilisateurs et récupérer les réponses des agents IA depuis Google Vertex AI.

  1. Générez un jeton d'ID utilisateur valide en établissant une liaison d'autorisation avec votre application OIDC Okta. Dans votre terminal, exécutez votre script d'orchestrateur Python : 
    python3 main_vertex.py

    Confirmez que le script génère un jeton d'accès vérifié et un jeton de porteur Google Cloud de courte durée.

  2. Le script envoie une requête HTTP POST au registre de session Google Vertex AI pour initialiser une session : 
    POST https://{GCP_LOCATION}-aiplatform.googleapis.com/v1/projects/{GCP_PROJECT_ID}/locations/{GCP_LOCATION}/reasoningEngines/{GCP_REASONING_ENGINE_ID}/sessions

    Un ID de ressource de session unique est renvoyé lorsque la session est créée avec succès.

  3. Le script envoie l'invite conversationnelle au routeur de session : 
    POST .../sessions/{session_id}:appendEvent

    L'invite est enregistrée en tant qu'événement USER dans l'historique de la session.

  4. Le script demande la réponse de l'agent à l'aide d'une requête GET : 
    GET https://{GCP_LOCATION}-aiplatform.googleapis.com/v1beta1/projects/{GCP_PROJECT_ID}/locations/{GCP_LOCATION}/reasoningEngines/{GCP_REASONING_ENGINE_ID}/sessions/{session_id}/events

    Le script scanne le tableau sessionEvents renvoyé pour un événement où author est AGENT ou ASSISTANT et affiche le texte de la réponse.

Une exécution réussie produit un résultat similaire à ce qui suit :

Enter custom prompt for vertex ai: Hello
Initializing identity validation against Okta...
Identity verified and access_token generated successfully via Okta!
Minting short-lived Google Cloud platform bearer token...
Forwarding request to Google Vertex AI Reasoning Engine...

=================== VERTEX REASONING ENGINE RESPONSE ===================
Raw Events Payload for analysis:
{
  "sessionEvents": [
    {
      "name": "projects/575096167212/locations/us-west1/reasoningEngines/7643954369880129536/sessions/6809070451898187776/events/5066757525928411136",
      "author": "USER",
      "content": {},
      "invocationId": "inv-e66fb2c3",
      "actions": {},
      "timestamp": "2026-06-15T22:56:34Z",
      "rawEvent": {
        "text": "Hello"
      }
    }
  ]
}
=========================================================================

Étape suivante

Activer les importations agent IA pour une app