Vous pouvez ajouter des actions lors de la création du data store ou ultérieurement. Cette page explique comment ajouter des actions après la création du data store et comment gérer la liste des actions.
Ajouter des actions
Console
Pour ajouter des actions au data store, procédez comme suit :
Dans la Google Cloud console, accédez à la page Gemini Enterprise.
Dans le menu de navigation, cliquez sur Datastores.
Sélectionnez le data store de votre choix.
Dans le menu de navigation, sélectionnez Actions.
Sur la page Actions :
- Si aucune action n'a été ajoutée lors de la création du data store, cliquez sur Activer les actions. Ensuite, sur la page Activer les actions , procédez comme suit pour ajouter des actions :
- Pour un data store fédéré :
- Sélectionnez les actions dans la liste.
- Cliquez sur Activer les actions.
- Pour un data store d'ingestion :
- Développez la section Paramètres d'authentification et fournissez les informations d'authentification.
- Cliquez sur Se connecter et connectez-vous au data store pour valider votre compte.
- Cliquez sur Continuer.
- Facultatif : développez les Paramètres avancés et fournissez les informations nécessaires.
- Sélectionnez les actions à activer.
- Cliquez sur Activer les actions.
- Développez la section Paramètres d'authentification et fournissez les informations d'authentification.
- Pour un data store fédéré :
- Pour ajouter des actions à la liste existante, procédez comme suit :
- Sélectionnez les actions dans la liste.
- Cliquez sur Activer les actions.
- Si aucune action n'a été ajoutée lors de la création du data store, cliquez sur Activer les actions. Ensuite, sur la page Activer les actions , procédez comme suit pour ajouter des actions :
Pour vous réauthentifier à l'aide d'identifiants différents de ceux utilisés pour créer le data store, procédez comme suit :
- Cliquez sur Se réauthentifier sur la page Actions.
- Fournissez les informations d'authentification.
- Cliquez sur Se connecter pour autoriser Gemini Enterprise à accéder au data store.
- Cliquez sur Mettre à jour pour mettre à jour les nouvelles informations d'authentification.
Pour afficher ou modifier les paramètres du data store pour les actions, procédez comme suit :
- Cliquez sur Afficher/Modifier les paramètres pour modifier les informations spécifiques au connecteur. Par exemple, pour Microsoft Outlook, SharePoint et OneDrive, fournissez l'ID de locataire.
- Cliquez sur Enregistrer pour mettre à jour les détails des paramètres.
Afficher les actions
Console
Pour afficher la liste des actions d'un data store, procédez comme suit :
Dans la Google Cloud console, accédez à la page Gemini Enterprise.
Dans le menu de navigation, cliquez sur Datastores.
Sélectionnez le data store de votre choix.
Dans le menu de navigation, sélectionnez Actions. Les actions que vous avez activées lors de la création du data store s'affichent sous forme de tableau sur la page Actions.
Désactiver les actions
Console
Pour désactiver des actions, procédez comme suit :
Dans la Google Cloud console, accédez à la page Gemini Enterprise.
Dans le menu de navigation, cliquez sur Datastores.
Sélectionnez le data store de votre choix.
Sélectionnez Actions dans le menu de navigation.
Sélectionnez les actions à désactiver dans le tableau.
Cliquez sur Désactiver les actions.
Gérer les actions personnalisées
Gemini Enterprise est compatible avec les champs et les entités personnalisés pour permettre la recherche et les actions avancées dans les datastores. Une fois que vous avez créé un data store, vous pouvez récupérer les opérations disponibles à partir de votre source de données et sélectionner celles à exposer en tant qu'actions. Pour optimiser les performances, vous pouvez également affiner les descriptions de chaque action et de ses champs pour le modèle d'IA.
Vous pouvez utiliser ces actions personnalisées en plus des actions par défaut fournies par Gemini Enterprise. Pour voir les actions proposées par défaut, consultez Actions compatibles.
Vous pouvez configurer des actions et des champs personnalisés de différentes manières :
- Entités personnalisées : générez des actions personnalisées à partir des entités personnalisées définies dans votre data store, puis affinez les descriptions des actions et des champs.
- Champs personnalisés : modifiez les actions standards existantes en décrivant comment les champs personnalisés doivent être renseignés.
Avant de commencer
Assurez-vous que les entités et les opérations personnalisées sont configurées et exposées par les sources de données tierces distantes avant de tenter de recharger les actions dans la Google Cloud console.
Configurer des actions personnalisées basées sur des entités personnalisées
Vous pouvez générer automatiquement un nouvel ensemble d'actions personnalisées en fonction des entités personnalisées définies dans votre data store connecté.
Pour générer et activer des actions personnalisées :
Dans la Google Cloud console, accédez à la Gemini Enterprise page.
Dans le menu de navigation, cliquez sur Datastores.
Sélectionnez un data store.
Dans le menu de navigation, cliquez sur Actions.
Sur la page Actions, cliquez sur Recharger les actions personnalisées pour générer la liste des actions.
Examinez les actions personnalisées détectées automatiquement dans la liste des actions. Par défaut, toutes les actions nouvellement générées sont marquées comme Désactivées.
Sélectionnez les actions personnalisées que vous souhaitez rendre disponibles.
Cliquez sur Activer les actions. L'état est marqué comme Activé pour les actions sélectionnées.
Cliquez sur Enregistrer.
Facultatif : pour améliorer l'expérience utilisateur, enrichissez les descriptions des actions et des champs dans la spécification :
- Sur la page Actions, sélectionnez une action dont vous souhaitez modifier la spécification.
- Cliquez sur Télécharger la spécification pour télécharger le fichier JSON de spécification.
- Ouvrez le fichier JSON téléchargé dans un éditeur de texte et modifiez les descriptions et les types de données dans le
inputSchema. Par exemple, vous pouvez ajouter une instruction telle que "Toujours définir la valeur par défaut sur 10" à la description d'un paramètre. - Dans la Google Cloud console, cliquez sur Importer la spécification pour importer le fichier JSON mis à jour. Le fichier de spécification est validé pour les erreurs de syntaxe de base.
- Cliquez sur Enregistrer.
Configurer des champs personnalisés pour des actions standards
Pour certains datastores, des actions standards sont fournies automatiquement, et la compatibilité avec les champs personnalisés est activée par défaut lors de la création du data store. Toutefois, vous pouvez définir explicitement comment le modèle doit gérer des champs personnalisés spécifiques en modifiant la spécification de l'outil.
Pour mettre à jour une action standard avec des définitions de champs personnalisés :
Dans la Google Cloud console, accédez à la Gemini Enterprise page.
Dans le menu de navigation, cliquez sur Datastores.
Sélectionnez un data store.
Dans le menu de navigation, cliquez sur Actions.
Cliquez sur Gérer la spécification.
Sélectionnez l'outil ou l'action standard que vous souhaitez mettre à jour.
Cliquez sur Télécharger la spécification pour télécharger le fichier JSON de spécification.
Ouvrez le fichier JSON téléchargé dans un éditeur de texte et ajoutez vos définitions de champs personnalisés, vos descriptions et vos types de données au
inputSchema.Dans la Google Cloud console, cliquez sur Importer la spécification pour importer le fichier JSON mis à jour. Le fichier de spécification est validé pour les erreurs de syntaxe de base.
Cliquez sur Enregistrer.
Limites
Si votre jeton d'actualisation expire, l'activation des actions personnalisées peut échouer avec une erreur, ou les actions peuvent ne pas s'afficher comme activées. Pour résoudre ce problème, rechargez la page Actions ou réautorisez l'application connectée pour actualiser votre jeton.