Créer des actions avec Gemini dans l'IDE

Compatible avec :

Ce document explique comment utiliser Gemini pour générer du code Python personnalisé pour les actions de réponse dans l'environnement de développement intégré (IDE) de Google SecOps. Cette fonctionnalité vous permet de créer des actions en fournissant une description en langage naturel de vos besoins.

Créer une action avec Gemini

  1. Dans le menu de navigation de Google SecOps, accédez à Réponse > IDE.
  2. Dans l'IDE, sélectionnez une intégration et ouvrez le menu Créer une action.
  3. Cliquez sur Générer une action avec Gemini.
  4. Dans la boîte de dialogue Générer une action, procédez comme suit :
    1. Choisissez une intégration dans la liste Intégration.
    2. Saisissez un prompt détaillé dans le champ Saisissez un prompt.
  5. Cliquez sur Générer avec Gemini.
  6. Examinez l'écran d'aperçu, qui affiche la requête saisie, une description de l'action proposée et des détails sur ses entrées et ses sorties.
  7. Cliquez sur Continuer.
  8. Dans l'éditeur qui s'affiche, examinez le code généré. Selon les résultats, choisissez l'une des options suivantes :
    • Accepter : si le code répond à vos exigences, cliquez sur Enregistrer.
    • Modifier : modifiez manuellement le code directement dans l'éditeur pour affiner la logique, puis cliquez sur Enregistrer.
    • Itérer : si le code nécessite des modifications importantes, revenez au champ de requête pour fournir des instructions plus spécifiques et régénérer l'action.
    • Ignorer : quittez la page ou sélectionnez un autre élément. Une boîte de dialogue de confirmation s'affiche pour s'assurer que vous souhaitez quitter sans enregistrer le code généré.
  9. Configurez les caractéristiques techniques de l'action, y compris les paramètres Délai avant expiration, Paramètres et Résultat JSON. Pour en savoir plus, consultez Créer une action à utiliser dans un playbook.
  10. Activez l'option, puis cliquez sur Enregistrer.

L'action est désormais disponible dans Playbook > Actions.

Bonnes pratiques concernant les prompts

Pour obtenir le code le plus précis et le plus exploitable possible de Gemini, suivez ces bonnes pratiques lorsque vous rédigez votre requête :

  • Suggérez des noms et des paramètres spécifiques : suggérez explicitement le nom de l'action et les paramètres qu'elle doit inclure.
  • Concentrez-vous sur des points de terminaison uniques : pour obtenir de meilleurs résultats, utilisez des requêtes pour des actions synchrones qui interagissent avec un seul point de terminaison d'API.
  • Définir la structure JSON : suggérez la structure appropriée pour les résultats JSON afin de vous assurer que le code est conforme aux exigences de votre playbook.
  • Conservez le code dans un seul module : demandez que tout le code de l'action soit écrit dans un seul module pour faciliter l'examen et l'implémentation.
  • Incluez de la documentation et des exemples : ajoutez des liens vers la documentation de l'API, des exemples d'API ou des exemples d'utilisation spécifiques dans votre requête.
  • Référencer des éléments d'intégration existants : vous pouvez référencer d'autres scripts de la même intégration pour guider la logique et le style de génération.

Exemple d'utilisation

Vous pouvez utiliser le prompt suivant pour générer une nouvelle action dans l'intégration de réponse Google Chronicle qui combine plusieurs fonctions existantes en une seule action personnalisée :

Create an action that combines the case tag action and case priority action. 
It should accept the same parameters as each original action and perform the 
same logic based on those parameters. Ensure the action returns a JSON result 
of the affected case in the following format:

{
  "case": case_id,
  "case_tag": tag,
  "priority": priority
}

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.