Appeler l'étape de compétence Now Assist

  • Rversion finale: Yokohama
  • Mis à jour 10 avr. 2025
  • 5 minutes de lecture

    • Exécutez une compétence publiée Now Assist à partir d’une action. Configurez les entrées et sorties Now Assist de compétences à partir des entrées et sorties d’étape.

    Rôles et disponibilités

    Disponible en tant qu’étape d’action Studio de workflow . Les utilisateurs disposant du rôle action_designer peuvent créer une action personnalisée avec une ou plusieurs étapes d’action.

    Kit de compétences Now Assist Configuration requise
    Cette étape nécessite le fichier Kit de compétences Now Assist. Pour plus d'informations, consultez Exploring Now Assist Skill Kit.
    Besoins du rôle
    Cette étape nécessite des rôles accordés par le développement délégué ou affectés à l’utilisateur. Pour plus d'informations, consultez Accès de l’utilisateur aux Studio de workflow flux.

    Entrées

    Fournissez une valeur pour chaque entrée dont votre action a besoin. Pour ajouter des valeurs dynamiques, vous pouvez également glisser-déplacer des pastilles à partir du panneau de données ou les sélectionner dans le sélecteur de pilules.

    Aptitude
    Type de données : Reference
    Référence à un enregistrement d’aptitude OneExtend [sys_one_extend_capability]. Lorsque vous sélectionnez un enregistrement d’aptitude, le système vous donne la possibilité d’importer les entrées d’aptitude et de créer des entrées d’action correspondantes pour celles-ci.
    Remarque :
    Certaines entrées d’aptitude utilisent des mots réservés tels que sys_id qui ne peuvent pas être utilisés comme noms d’entrée d’action. Examinez toutes les entrées créées par le processus d’importation et vérifiez que les noms d’entrées d’action sont valides.
    Charge utile
    Type de données : String

    Chaîne au format JSON contenant la charge utile à envoyer à la compétence et au cadre de travail OneExtend pour traitement Now Assist .

    Configuration de la compétence
    Type de données : Reference

    Référence à un enregistrement de configuration de compétence Now Assist [sn_nowassist_skill_config].

    En cas d'échec de cette étape
    Type de données : Choice

    Option permettant de continuer à exécuter l’étape suivante ou d’accéder à l’évaluation des erreurs. Pour utiliser le code d’état d’étape ou le message pour une condition d’erreur d’action personnalisée, reportez-vous à la section Évaluation des erreurs d’action.

    Sorties

    Ces sorties apparaissent dans le panneau Données. Vous pouvez les utiliser comme entrées ailleurs dans votre action.

    Erreur
    Type de données : String

    Message d’erreur produit par la compétence. Cette sortie est vide lorsque la compétence exécute correctement la demande de Now Assist compétence.

    Fournisseur
    Nom du fournisseur LLM qui a répondu à la Now Assist demande de compétences.
    Réponse
    Réponse texte générée par le LLM telle qu’un résumé ou une réponse à une conversation.
    Résultat
    Chaîne au format JSON contenant les résultats générés par le LLM dans la charge utile d’entrée.
    Statut
    État de l’appel au fournisseur.
    Statut de l’étape
    Type de données : Object

    Pastille de données d’objet contenant les détails d’exécution de l’étape. Chaque étape d’une action renvoie un état d’étape.

    Code d’état de l’étape
    Type de données : Integer
    Pastille de données d’entier indiquant si l’étape a généré une erreur. Une étape renvoie une valeur de 1 lorsqu’elle génère une erreur pour une raison quelconque. Par exemple, une étape peut générer une erreur si des données d’entrée obligatoires sont manquantes ou si elle renvoie une sortie dans le mauvais type de données. Une étape renvoie une valeur de 0 lorsqu’elle s’exécute correctement. Vous ne pouvez pas personnaliser ces codes.
    • Réussite [0] : l’étape a réussi.
    • Erreur [1] : L’étape a généré une erreur.
    Message d’état de l’étape
    Type de données : String

    Pastille de données de chaîne contenant le message d’erreur produit par l’étape ou l’opération système. Vous ne pouvez pas personnaliser le message d’état de l’étape.

    Appeler la compétence Synthèse de flux

    Action qui utilise l’étape de compétence Appeler Now Assist pour la compétence de synthèse de flux.

    Cet exemple d’action appelle la compétence Synthétiser le flux, qui fournit un résumé textuel de l’action d’un flux ou d’un flux secondaire. La compétence Synthèse de flux comporte deux entrées de compétence.
    • sys_id. Cette entrée contient l’ID système du composant à synthétiser.
    • type. Cette entrée contient le type de composant à synthétiser.
    Pour prendre en charge les deux entrées de compétence, cet exemple d’action comporte deux entrées d’action correspondantes.
    • Flow to summarize. Cette entrée contient l’ID système du composant à synthétiser.
    • Type. Cette entrée contient le type de composant à synthétiser (flux, flux secondaire ou action).
    Remarque :
    Une action ne peut pas avoir d’entrée avec le nom sys_id, car ce nom est un mot réservé.

    Nous pouvons tester cette action en fournissant ces exemples de valeurs d’entrée.

    Aptitude
    Cet exemple utilise l’enregistrement de l’aptitude OneExtend de synthèse de flux.
    Charge utile
    Cet exemple utilise un objet JSON pour mapper les valeurs d’entrée d’action aux valeurs de compétence. Dans cet exemple, nous fournissons l’ID système du flux de changement - Normal - Autoriser et le type de flux.
    Configuration de la compétence
    Cet exemple utilise l’enregistrement Configuration de la compétence de synthèse de Now Assist flux.

    Exemple de détails d’exécution de la compétence de synthèse de flux d’appels

    Voici les exemples de valeurs de sortie produites par la compétence de synthèse de flux.

    Sortie d’erreur
    Cet exemple ne génère pas de sortie d’erreur.
    Sortie du fournisseur
    Cet exemple utilise le fournisseur Now LLM.
    Sortie de réponse

    Cet exemple utilise la compétence Synthèse de flux pour générer un résumé pour le flux Changement - Normal - Autorisé. En règle générale, vous utiliseriez cette sortie de réponse comme entrée pour une autre action ou logique de flux.

    Ce flux, nommé « Changement - Normal - Autoriser », est conçu pour traiter une demande de changement qui utilise le modèle de changement normal et qui est dans l’état Autoriser, tout en veillant à ce qu’elle ne soit pas en attente.

    Le flux commence par vérifier si le gestionnaire du groupe d’affectation a déjà approuvé la demande de changement. Dans le cas contraire, il applique une politique d’approbation de changement, en particulier pour les approbations de risque.

    Le flux évalue ensuite si le processus d’approbation a été ignoré, rejeté ou approuvé. S’il est ignoré, il ne fait rien. En cas de rejet, il envoie une notification par e-mail aux parties concernées. Si elle est approuvée, elle met à jour l’enregistrement de demande de changement pour le marquer comme approuvé.

    En parallèle, le flux attend que la demande de changement soit en suspens ou inactive, puis ignore toute approbation de demande de changement. Elle évalue également à nouveau le modèle de changement.

    Le flux s’arrête une fois ces tâches terminées.

    Résultat de sortie
    Cet exemple renvoie un objet JSON contenant les éléments de réponse et de flux utilisés pour générer la réponse.
    Sortie d’état
    Cet exemple renvoie une valeur de sortie de réussite.