Appeler Now Assist Étape de compétence

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 4 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

    Renseignez chaque entrée nécessaire pour votre action. 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.

    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]. La charge utile est générée en fonction de la configuration de la compétence que vous sélectionnez.

    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 .

    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 ou le message d’une étape pour une condition d’erreur d’action personnalisée, reportez-vous à la section Évaluation de l’erreur d’action.

    Sorties

    Ces résultats apparaissent dans le panneau de 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

    Pilule 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 d’étape
    Type de données : Integer
    Pastille de données entière indiquant si l’étape a produit une erreur. Une étape renvoie la valeur 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 la valeur 0 lorsqu’elle s’exécute avec succès. Vous ne pouvez pas personnaliser ces codes.
    • Réussite [0] : l’étape a réussi.
    • Erreur [1] : l’étape a produit une erreur.
    Message d’état de l’étape
    Type de données : String

    Pilule 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.
    • 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 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.

    Configuration de la compétence
    Cet exemple utilise l’enregistrement de configuration de la compétence de synthèse du Now Assist 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.

    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.