Appeler l'étape de compétence Now Assist

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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é

    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.

    Configuration requise pour le Kit de compétences Now Assist
    Cette étape nécessite le fichier Kit de compétences Now Assist. Pour plus d'informations, consultez Exploring Now Assist Skill Kit.
    Exigences de rôle
    Cette étape nécessite des rôles accordés par Delegated Development 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 les pilules du panneau de données ou les sélectionner dans le sélecteur de pilules.

    Option
    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 le 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 généré par la compétence. Cette sortie est vide lorsque la compétence exécute avec succès 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 de synthèse du flux

    Action qui utilise l’étape de compétence Appeler Now Assist pour la compétence de synthèse du 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 du flux comporte deux entrées de compétence.
    • asset_sys_id. Cette entrée contient l’ID système du composant à synthétiser.
    • asset_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 a 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 tel qu’un flux, un flux secondaire ou une action.
    Remarque :
    Une action ne peut pas avoir d’entrée portant 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.

    Option
    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 Changement - Normal - Autoriser et le type de flux.
    Configuration de la compétence
    Cet exemple utilise l’enregistrement de configuration de la compétence de synthèse du Now Assist flux.

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

    Voici les exemples de valeurs de sortie produites par la compétence de synthèse du 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 de synthèse de flux pour générer un résumé pour le flux Changement - Normal - Autoriser. En règle générale, vous utiliseriez cette sortie de réponse comme entrée d’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 se trouve 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 des changements, 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. En cas d’approbation, l’enregistrement de demande de changement est mis à jour 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. Il é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.