Consultez les connecteurs compatibles avec Application Integration.

Créer des intégrations avec Gemini Code Assist

Gemini Code Assist est un outil collaboratif basé sur l'IA dans Google Cloud qui aide les utilisateurs de tous les niveaux de compétence lorsqu'ils en ont besoin. Dans Application Integration, Gemini Code Assist peut vous aider à:

• Créer des intégrations
• Configurer des tâches de connecteur dans une intégration
• Configurer des tâches d'API REST Call dans une intégration
• Ajouter des conditions de périphérie et ajouter des tâches supplémentaires à une intégration
• Configurer des tâches JavaScript
• Générer une description de l'intégration

Pour en savoir plus sur Gemini pour Google Cloud, consultez la présentation de Gemini pour Google Cloud .

Avant de commencer

1. Dans la console Google Cloud, accédez à la page Application Integration.
   

   Accéder à Application Integration

   L'image suivante montre la page "Intégration d'applications" :

   

   1. Dans la section L'IA vous aide à créer vos intégrations, cliquez sur Explorer.
   2. Dans le volet Gemini dans l'intégration d'applications qui s'affiche, cliquez sur Activer le service pour activer l'API Gemini pour Google Cloud .

      Pour savoir comment activer Gemini Code Assist dans un Google Cloud projet, consultez Configurer Gemini Code Assist pour un projet.

2. Configurez l'intégration d'applications dans votre Google Cloud projet. Pour en savoir plus, consultez Configurer Application Integration.
3. Si vous prévoyez de créer une intégration à l'aide de connecteurs, veillez à configurer les connexions souhaitées dans votre projet Google Cloud .
4. Si vous prévoyez de créer une intégration à l'aide d'API du hub d'API Apigee qui se trouvent dans un projet hôte, assurez-vous d'avoir provisionné le hub d'API dans votre projet et que le compte de service d'intégration des applications dispose du rôle requis pour accéder aux API de l'autre projet.

Remarque:Gemini fournit des recommandations ou des suggestions basées sur les connecteurs et le hub d'API pour vos intégrations à l'aide des connexions configurées dans Integration Connectors (Connecteurs d'intégration) et des API dans le hub d'API Apigee. Si aucune connexion ni aucune API n'est configurée dans votre projet, Gemini risque de ne pas fournir de recommandations ni de suggestions basées sur des connecteurs et des API.

Rôles requis

• Pour obtenir les autorisations nécessaires pour utiliser Gemini, demandez à votre administrateur de vous accorder le rôle IAM Utilisateur de Gemini pour Google Cloud (roles/cloudaicompanion.user) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

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

• Si vous prévoyez de créer une intégration avec le hub d'API Apigee, assurez-vous de disposer du rôle "Lecteur du hub d'API Cloud" (roles/apigeeregistry.viewer) sur le projet contenant les API.
• Si vous prévoyez de créer une intégration avec Integration Connectors, assurez-vous de disposer du rôle Lecteur de connecteurs (roles/connectors.viewer) pour le projet.

Tâches et déclencheurs compatibles

Gemini peut vous aider à ajouter les tâches et déclencheurs suivants:

Déclencheurs

Tasks

Déclencheur d'API Déclencheur Cloud Pub/Sub Déclencheur Salesforce Jira Cloud ServiceNow Zendesk Déclencheur Cloud Scheduler

Tâche de mappage de données Tâche Approbation Tâche Suspendre Tâche JavaScript Cloud Run Functions Tâche Minuteur Tâche "Renvoyer" Tâche Envoyer un e-mail Tâche de connecteur Tâche "Appeler un point de terminaison REST" Tâche Doc AI – Traitement Gemini vous aide également à créer les tâches de contrôle de flux suivantes, mais ne peut pas générer de sous-intégrations: Tâche de boucle "For Each" Tâche "Pour chaque parallèle" Tâche boucle "while" Tâche d'appel d'intégration

Créer une intégration

Gemini vous aide à créer et à développer des intégrations à l'aide de vos instructions en langage naturel (ou requêtes) comme entrée. Vous pouvez ainsi créer et développer des intégrations simples à complexes rapidement et avec un minimum de configurations manuelles.

Fournissez à Gemini une brève requête ou une description du flux d'intégration que vous souhaitez créer. Gemini vous suggérera alors un ou plusieurs flux d'intégration pour vous aider à vous lancer.

Pour créer une intégration à l'aide de Gemini, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page Application Integration.

   Accéder à Application Integration

2. Cliquez sur Étincelle M'aider à créer. Le volet Créer une intégration avec Gemini s'affiche.

   Vous pouvez également accéder à la page Créer une intégration, créer une intégration, puis, dans l'éditeur d'intégration, cliquer sur pen_spark Créer des flux d'intégration avec Gemini pour utiliser Gemini.



1. Si vous souhaitez sélectionner un modèle de requête, choisissez-en un parmi les exemples de modèles de requêtes. Sinon, saisissez une requête pour que Gemini génère des intégrations. Pour savoir comment rédiger de meilleures requêtes, consultez Rédiger de meilleures requêtes.

   Par exemple, supposons que vous ayez ajouté l'invite suivante: Créer une intégration qui extrait un problème Jira, puis crée le ticket Zendesk.

2. Cliquez sur Générer.
   Remarque:Gemini suggère un ou plusieurs flux d'intégration qui valident votre requête :

   • Si vous avez activé API Hub et les connecteurs d'intégration, et que vous remplissez tous les prérequis, les recommandations incluront des tâches "Appeler un point de terminaison REST" et des connecteurs.
   • Si vous avez besoin de mapper des données dans votre intégration, Gemini peut également vous suggérer une tâche de mappage de données. Lorsque vous confirmez l'invite, la tâche de mappage des données est remplacée par une tâche JavaScript.

   Le diagramme suivant montre le volet Créer une intégration avec Gemini avec les suggestions fournies par Gemini:

   

   Utilisez les boutons Précédent et Suivant pour afficher les suggestions fournies.

3. Si vous souhaitez modifier le nom d'intégration suggéré, vous pouvez modifier le champ Nom de l'intégration.
   Remarque:Le nom de l'intégration doit être unique dans le projet Google Cloud .
4. Sélectionnez une région pour l'intégration. Si votre projet ne dispose que d'une seule région provisionnée, le champ Region (Région) est défini sur cette région.
   Remarque:La liste Région affiche les régions provisionnées dans votre projet Google Cloud . Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour en savoir plus, consultez la section Activer une nouvelle région.
5. Si vous souhaitez modifier la requête, cliquez sur Modifier la requête.
6. Pour accepter une suggestion de flux d'intégration, cliquez sur Confirmer. Application Integration affiche la progression des étapes de création de l'intégration. Les intégrations créées à l'aide de Gemini remplacent tous les éléments et variables d'intégration existants.

   

Recommandations contextuelles

Vous pouvez utiliser Gemini pour fournir des recommandations contextuelles pour vos intégrations existantes. Gemini peut vous aider à fournir des recommandations de configuration de connecteur adaptées au contexte en fonction du flux logique de votre intégration existante. Si une connexion de votre intégration comporte plus de 1 000 entités, ce connecteur n'est pas inclus dans les recommandations de Gemini. Pour en savoir plus, consultez la section Limites.

Configurer des tâches de connecteur

Gemini peut vous aider à fournir des recommandations de configuration de connecteur adaptées au contexte en fonction du flux logique de votre intégration existante. Si une connexion de votre intégration comporte plus de 1 000 entités, ce connecteur n'est pas inclus dans les recommandations de Gemini. Pour en savoir plus, consultez la section Limites.

Vous pouvez configurer le connecteur avec les remplacements recommandés par Gemini, ou interagir avec Gemini (à l'aide d'invites) et demander les suggestions de configuration souhaitées.

Pour configurer une tâche de connecteur dans votre intégration à l'aide de Gemini, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Intégrations.

   La page Intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud .

3. Sélectionnez une intégration existante pour l'ouvrir dans l'éditeur d'intégration.
4. Dans la barre de navigation, activez l'option Nouvelle vue du canevas (aperçu). Utilisez ensuite le canevas pour créer votre workflow d'intégration.
5. Pour une tâche de connecteur, cliquez sur Autres actions, puis sur Configurer la tâche.

   Un menu pop-up semblable à l'image suivante s'affiche et affiche un ensemble de recommandations Gemini.

   Remarque:Gemini peut recommander une tâche de connecteurs pour les tâches "Appeler un point de terminaison REST" et inversement.

   

6. Gemini recommande automatiquement un ou plusieurs remplacements ou alternatives pertinents pour le flux logique de votre intégration. Vous pouvez utiliser la requête pour interagir avec Gemini et affiner ou générer à nouveau les recommandations suggérées si vous le souhaitez.

7. Sélectionnez l'une des suggestions de remplacement ou de modification à accepter. Gemini configure la tâche de connecteur sélectionnée.

Configurer des tâches d'API REST Call

Si API Hub est activé dans votre projet, Gemini dans Application Integration peut vous aider à fournir des recommandations de tâche "Appeler un point de terminaison REST" et de configuration de tâche adaptées au contexte en fonction du flux logique de votre intégration existante. Vous pouvez utiliser ces recommandations pour remplacer directement vos tâches existantes ou les modifier sans avoir à passer par un processus de configuration manuel.

Vous pouvez remplacer directement une tâche ou une configuration de tâche par les remplacements recommandés par Gemini, ou interagir avec Gemini (à l'aide d'invites) et demander les suggestions de tâches souhaitées.

Une fois que vous avez rempli tous les prérequis, procédez comme suit pour remplacer ou modifier une tâche existante dans votre intégration à l'aide de Gemini:

1. Dans la console Google Cloud, accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Intégrations.

   La page Intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud.

3. Sélectionnez une intégration existante pour l'ouvrir dans l'éditeur d'intégration.
4. Dans la barre de navigation, activez l'option Nouvelle vue du canevas (aperçu). Utilisez ensuite le canevas pour créer votre workflow d'intégration.
5. Dans le canevas de l'éditeur d'intégrations, sélectionnez la tâche que vous souhaitez remplacer ou modifier.
6. Cliquez sur Autres actions, puis sur Configurer la tâche.

   Un menu pop-up semblable à l'image suivante s'affiche et affiche un ensemble de recommandations Gemini.

   Remarque:Gemini peut recommander une tâche de connecteurs pour les tâches "Appeler un point de terminaison REST" et inversement.

   

7. Gemini recommande automatiquement un ou plusieurs remplacements ou alternatives pertinents pour le flux logique de votre intégration. Vous pouvez utiliser la requête pour interagir avec Gemini et affiner ou générer à nouveau les recommandations suggérées si vous le souhaitez.

8. Il vous suffit de sélectionner l'une des suggestions de remplacement ou de modification à accepter.

   Gemini remplace directement la tâche sélectionnée ou la modifie sans configuration supplémentaire.

Ajouter des conditions d'arêtes et ajouter des tâches supplémentaires

Vous pouvez utiliser Gemini pour ajouter de nouvelles tâches et des conditions de bord à votre flux d'intégration existant.

Pour ajouter une condition de bord ou ajouter de nouvelles tâches à votre intégration à l'aide de Gemini, procédez comme suit:

1. Dans Google Cloud, accédez à la page Application Integration (Intégration d'applications).

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Intégrations.

   La page Intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud .

3. Sélectionnez une intégration existante pour l'ouvrir dans l'éditeur d'intégration.
4. Dans la barre de navigation, activez l'option Nouvelle vue du canevas (aperçu). Utilisez ensuite le canevas pour créer votre workflow d'intégration.
5. Dans l'éditeur d'intégration, sélectionnez l'arc pour lequel vous souhaitez ajouter la condition d'arc ou à partir duquel vous souhaitez ajouter une tâche.
6. Cliquez sur Autres actions, puis sur Créer une branche.

   Un menu pop-up semblable à l'image suivante s'affiche et vous invite à saisir une entrée.

   

7. Saisissez votre requête en spécifiant la condition de bord que vous souhaitez ajouter ou la tâche supplémentaire que vous souhaitez ajouter.

   Voici un exemple de requête que vous pouvez utiliser:

         If order qty>100, send an email

   Pour savoir comment rédiger de meilleures requêtes, consultez Rédiger de meilleures requêtes.

8. Cliquez sur pen_spark Créer.

Gemini insère automatiquement les conditions de bord qualifiées et configure les tâches supplémentaires à partir du bord sélectionné dans votre intégration existante.

9. Cliquez sur Confirmer pour accepter les suggestions d'insertions et d'ajouts.

   Si vous n'aimez pas les suggestions d'insertions ou d'ajouts, cliquez sur Annuler .

Configurer des tâches JavaScript

Vous pouvez utiliser Gemini pour configurer des tâches JavaScript dans votre intégration. Gemini peut vous aider à obtenir des recommandations de configuration de tâches JavaScript adaptées au contexte en fonction du flux logique de votre intégration existante. Vous pouvez utiliser ces recommandations pour remplacer directement vos tâches existantes ou les modifier sans avoir à passer par un processus de configuration manuel.

Ajouter une tâche JavaScript

La tâche JavaScript vous permet d'écrire des extraits de code JavaScript personnalisés pour votre intégration. Pour ajouter les extraits de code à l'aide de Gemini, procédez comme suit:

1. Dans Google Cloud, accédez à la page Application Integration (Intégration d'applications).

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Intégrations.

   La page Intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud .

3. Créez une intégration ou sélectionnez une intégration existante pour l'ouvrir dans l'éditeur d'intégration.
4. Cliquez sur l'élément JavaScript et placez-le dans l'éditeur d'intégrations.
5. Cliquez sur l'élément JavaScript sur le canevas pour afficher le volet de configuration de la tâche JavaScript.
6. Cliquez sur spark Créer un script avec Gemini. Le volet Script avec Gemini s'ouvre. Ensuite, procédez comme suit :
   1. Si vous souhaitez sélectionner un modèle de requête, choisissez-en un parmi les exemples de modèles de requêtes. Sinon, saisissez une requête pour que Gemini génère le code JavaScript. Pour savoir comment rédiger de meilleures requêtes, consultez Rédiger de meilleures requêtes.

      Supposons que vous souhaitiez traiter une commande client. Votre intégration contient les variables customer et item. Pour créer une commande, vous pouvez saisir une invite semblable à celle-ci:

      Create order using customer and items.
      

      

   2. Cliquez sur Générer.

      Gemini suggère une ou plusieurs extraits de code qui répondent à votre requête. Utilisez les boutons Précédent et Suivant pour afficher les suggestions fournies.

   3. Pour ajouter l'extrait de code suggéré à la tâche JavaScript, cliquez sur Confirmer. L'extrait de code s'affiche dans le champ Éditeur JavaScript.

Modifier une tâche JavaScript

La tâche JavaScript vous permet d'écrire des extraits de code JavaScript personnalisés pour votre intégration. Pour ajouter les extraits de code à l'aide de Gemini, procédez comme suit:

1. Dans Google Cloud, accédez à la page Application Integration (Intégration d'applications).

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Intégrations.

   La page Intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud .

3. Sélectionnez une intégration contenant la tâche JavaScript.
4. Cliquez sur l'élément JavaScript et placez-le dans l'éditeur d'intégrations.
5. Cliquez sur l'élément JavaScript sur le canevas pour afficher le volet de configuration de la tâche JavaScript.
6. Cliquez sur Ouvrir l'éditeur de script. La page Éditeur de tâches JavaScript s'affiche.
7. Cliquez sur étincelle Utiliser Gemini pour modifier et comprendre le script > Modifier le script. Le volet Modifier le script avec Gemini s'affiche. Ensuite, procédez comme suit :
   1. Si vous souhaitez sélectionner un modèle de requête, choisissez-en un parmi les exemples de modèles de requêtes. Sinon, saisissez une requête pour que Gemini génère du code JavaScript. Pour savoir comment rédiger de meilleures requêtes, consultez Rédiger de meilleures requêtes.

      Supposons que vous souhaitiez enregistrer la commande lorsque son coût est supérieur à 100. Vous pouvez ensuite saisir une invite semblable à celle-ci:

            Log in the order when the cost is greater than 100.
            

      

   2. Cliquez sur Générer.

      Gemini suggère une ou plusieurs extraits de code qui répondent à votre requête. Utilisez les boutons Précédent et Suivant pour afficher les suggestions fournies.

   3. Pour ajouter les modifications suggérées à l'extrait de code dans la tâche JavaScript, cliquez sur Confirmer. L'extrait de code mis à jour s'affiche dans le champ Éditeur JavaScript.

Comprendre la tâche JavaScript

Gemini peut vous aider à comprendre l'extrait de code de la tâche JavaScript. Pour cela, procédez comme suit :

1. Dans l'intégration, cliquez sur l'élément JavaScript sur le canevas pour afficher le volet de configuration de la tâche JavaScript.
2. Dans le volet de configuration de la tâche, cliquez sur Ouvrir l'éditeur de script. Le volet Éditeur de script s'affiche. Ensuite, procédez comme suit :
   1. Cliquez sur spark > info_spark M'aider à comprendre.

      Si vous souhaitez comprendre une partie du code, vous pouvez sélectionner la partie de l'extrait qui vous intéresse, puis cliquer sur spark > info_spark M'aider à comprendre.

      Le volet Gemini s'affiche:

      

   2. Dans le volet Gemini, saisissez une requête pour que Gemini comprenne l'extrait de code. Pour savoir comment rédiger de meilleures requêtes, consultez Rédiger de meilleures requêtes.

Générer une description de l'intégration

La fonctionnalité de description de l'intégration disponible dans Gemini dans Application Integration fournit un résumé de la description de l'intégration que vous avez créée dans l'éditeur d'intégration. Le résumé de la description de l'intégration est généré dans un langage clair et peut vous aider à comprendre le cas d'utilisation global de l'intégration, l'orchestration sous-jacente et le contexte métier, qui peuvent être difficiles à évaluer en raison de la structure ou de la complexité d'une intégration.

Pour générer un résumé de la description de votre intégration à l'aide de Gemini, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Intégrations.

   La page Intégrations s'affiche et liste toutes les intégrations disponibles dans le projet Google Cloud .

3. Sélectionnez une intégration existante pour l'ouvrir dans l'éditeur d'intégration.
4. Dans la barre d'outils de l'éditeur d'intégrations, cliquez sur  (Récapitulatif de l'intégration). La page des détails de l'intégration s'affiche.
5. Sur la page d'informations sur l'intégration, cliquez sur M'aider à rédiger la description.

   Gemini analyse l'intégration dans l'éditeur d'intégration et génère une description récapitulative détaillée semblable à l'image suivante.

   

6. Cliquez sur OK pour accepter la description de l'intégration générée.

   Vérifiez et validez l'intégration (y compris les variables) avant de l'exécuter.

Quotas et limites

Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.

Limites

Gemini dans Application Integration est soumis aux limites suivantes:

• Si la connexion de votre intégration comporte plus de 1 000 entités, ce connecteur n'est pas inclus dans les recommandations de Gemini.
• L'intégration d'applications est compatible avec la résidence des données. Les intégrations créées à l'aide de Gemini sont compatibles avec la résidence des données. Nous ne stockons aucune donnée, comme les requêtes et les réponses de Gemini. Seules les données en cours d'utilisation et en transit pour la génération à l'aide de Gemini ne sont pas compatibles avec la résidence des données.

Fournir des commentaires

Vous pouvez obtenir de l'aide ou envoyer des commentaires contextuels lorsque vous utilisez Gemini pour créer une intégration. Ces informations nous aident à améliorer Gemini.

Étape suivante

• Découvrez comment rédiger des requêtes plus efficaces.
• Découvrez comment tester et publier une intégration.
• Découvrez comment Gemini pour Google Cloud utilise vos données.
• Découvrez la présentation de Gemini pour Google Cloud .