Configurer le cadre de travail de l’action de groupe

  • Rversion finale: Australia
  • Mis à jour 31 juil. 2025
  • 4 minutes de lecture

    • Configurez le cadre de travail d’action de groupe (GAF) pour améliorer la qualité des réponses, la vitesse de rappel et la cohérence des agents IA.

    Avant de commencer

    Il doit y avoir une ACL de lecture ml_platform pour que GAF soit configuré. Si aucune ACL de lecture n’est présente, vous devez la créer et accorder l’accès au rôle approprié, tel que administrateur, ml_admin ou sn_aia.admin. Cette option est requise pour que GAF puisse accéder aux tables et services d’apprentissage machine. Si votre ACL n’est pas configurée correctement, vous pouvez voir l’erreur « Échec de l’initialisation du pipeline : échec du chargement de message_content ensemble de données. Aucune colonne à analyser à partir du fichier."

    Pour accéder à la fonction de prédiction optimisée de GAF, vous pouvez activer Now Assist dans Recherche IA. Pour plus d’informations, consultez Configurer Recherche IA pour le cadre de travail de l’action de groupe.

    Rôle requis : sn_aia.admin

    Pourquoi et quand exécuter cette tâche

    Vous pouvez activer GAF pour que les agents IA utilisent des grappes indexées qui effectuent des exécutions LLM sur des enregistrements représentatifs plutôt que sur tous les enregistrements. GAF est utilisé par certains agents IA et workflows agentiques pour fonctionner de manière optimale. Pour plus d’informations sur GAF et son fonctionnement, voir Cadre de travail de l’action de groupe.

    Vous pouvez avoir différentes configurations GAF pour différents workflows et Now Assist applications agentiques. Vous devez configurer chaque workflow agentique ou application séparément.

    Important :
    La configuration de GAF peut prendre un certain temps, entre 10 minutes et une heure, selon le nombre d’enregistrements dans le regroupement. Le script s’exécute en arrière-plan.

    Procédure

    1. Accédez à la Tous > Définition du système > Scripts - Arrière-plan.
    2. Collez le code suivant dans la zone de texte.

      N’exécutez pas le script tant que les variables groupSkillID et actionSkillID n’ont pas de valeurs. Les valeurs sont acquises dans les étapes suivantes.

      var groupSkillId = ""; 
var actionSkillId = ""; 
var topicSkillId = "43bce9e477e012103f075cea5b5a998f"; 
new sn_gaf.GAFUtils().activate(groupSkillId, topicSkillId, actionSkillId, "run_once");

      Le topicSkillId est le même pour toutes les configurations GAF.

    3. Dans un nouvel onglet de navigateur, accédez à la table Configuration des Now Assist compétences [sn_nowassist_skill_config] en saisissant sn_nowassist_skill_config.list dans le navigateur de filtre.
    4. Dans le champ Nom , entrez *regroupement et recherche pour afficher les enregistrements de regroupement associés à vos workflows et Now Assist applications agentiques.

      Now Assist Table de configuration de la compétence filtrée par *regroupement dans le champ Nom

    5. Ouvrez l’enregistrement de regroupement pour le workflow agentique ou l’application que vous souhaitez configurer.
    6. Dans la Now Assist liste connexe Jeu de variables de configuration, ouvrez l’enregistrement Entrées de regroupement.
    7. Confirmez que les filtres de regroupement incluent tous les enregistrements que vous souhaitez indexer.
      Si vous souhaitez ajouter des filtres pour modifier les enregistrements inclus dans la configuration GAF, faites-le ici. Plus vous incluez d’enregistrements, plus vous disposez d’un temps de configuration plus long, mais ils peuvent contribuer à améliorer la qualité de vos résultats. Vous devez disposer d’au moins 2 000 enregistrements pour réussir le clustering.
      Remarque :
      Votre champ d’application actuel doit être Cadre de travail d’action de groupe pour apporter des changements.

      Now Assist Variable de configuration de la compétence Définir un enregistrement avec des variables définies sur la table Incident, le champ Description brève et le filtre L’état est fermé

    8. Revenez à l’enregistrement de Now Assist regroupement de configurations de compétences et copiez l’sys_id.
      Vous utilisez cette sys_id et deux autres sys_ids dans l’appel de fonction de script en arrière-plan.
    9. Dans l’onglet du navigateur avec le script en arrière-plan, collez la sys_id du script entre les guillemets de la variable groupSkillId.

      Votre variable groupSkillId doit être au même format que la variable topicSkillId .

    10. Dans l’onglet contenant l’enregistrement de configuration de la Now Assist compétence, revenez à la table Configuration de la Now Assist compétence et recherchez *stratégie d’action pour trouver la configuration de la compétence de stratégie d’action pour l’application.
      Assurez-vous que l’enregistrement concerne la même application. Si vous avez collé le sys_id du regroupement ITSM GAF, vous devez ouvrir la stratégie d’action ITSM GAF.
    11. Ouvrez l’enregistrement de stratégie d’action de l’application que vous configurez.
    12. Copiez le sys_id de l’enregistrement de la stratégie d’action.
    13. Dans l’onglet du navigateur avec le script en arrière-plan, collez le sys_id du script entre les guillemets de la variable actionSkillId.

      Votre variable actionSkillId doit être au même format que les variables groupSkillId et topickillId .

      Script GAF terminé avec les trois valeurs renseignées

    14. Exécutez le script d’arrière-plan en sélectionnant Exécuter le script.

      L’exécution de ce script en arrière-plan crée une tâche planifiée appelée GAF : exécuter un flux hors ligne. Vous pouvez afficher la tâche planifiée dans la table Exécutions de script planifiées [sysauto_script].

    Résultats

    GAF est configuré sur votre instance pour cette Now Assist application et peut être utilisé par les agents IA pour rechercher des enregistrements connexes.

    Que faire ensuite

    Pour vérifier que les sorties de regroupement et d’action ont été générées, accédez à la table Solution ML [ml_solution] pour vérifier si la solution de mise en grappe est en cours d’exécution ou terminée. Si cette opération est terminée, vérifiez les tables suivantes pour voir les enregistrements de groupes, les enregistrements en grappe et les enregistrements sous-échantillonnés par groupe sont présents.

    • Groupe d’enregistrements GAF [sn_gaf_record_group]
    • Détail du groupe d’enregistrements GAF [sn_gaf_record_group_detail]
    • Résultat de la stratégie d’action GAF [sn_gaf_action_strategy_result]

    Vous pouvez répéter cette procédure pour d’autres workflows et Now Assist applications agentiques.

    Vous pouvez voir l’erreur « Échec de l’initialisation du pipeline : échec du chargement de message_content ensemble de données. Aucune colonne à analyser à partir du fichier." lors de la tentative de configuration de GAF. Cela peut être dû au fait que votre instance manque de données dans la table ou que les filtres que vous avez configurés ont exclu des enregistrements de la table. Vous pouvez demander Now Support une assistance supplémentaire si vous ne parvenez pas à résoudre cette erreur.