---
sourceDocument: Interfaces conversationnelles Yokohama
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/conversational-interfaces

 Release :

    - yokohama

ft:locale :

    - fr-FR

ft:publication_title :

    - Interfaces conversationnelles Yokohama

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# API Agent virtuel fonctionnalités disponibles dans la version 3.0.x du Store

# API Agent virtuel fonctionnalités disponibles dans la version 3.0.x du Store {#ariaid-title1}

* Rversion finale: Yokohama
* 
* Mis à jour 30 janv. 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 minutes de lecture

API Agent virtuel La version 3.0.x donne accès à un plus grand nombre des mêmes fonctionnalités que celles disponibles dans Agent virtuel et Messagerie instantanée d'agent, y compris la possibilité de télécharger des fichiers à partir d'une URL privée et des améliorations de la négociation synchrone.

## Mettre fin aux conversations abandonnées Agent virtuel {#va-api-features-v3__section_y1m_khj_dsb}

Si une conversation est incomplète en raison d'une erreur, Agent virtuel le bot principal peut demander de prendre le contrôle. Si le takeControl marqueur est true, Agent virtuel (en tant que bot secondaire) fermera automatiquement la conversation. Si le bot principal souhaite démarrer une conversation, il peut envoyer le message d'action suivant : `<< salut >>/START_CONVERSATION`.  
Vous pouvez demander au bot primaire de prendre le contrôle dans les situations suivantes :

* Délai d'inactivité : l'état d'interaction est Fermé et abandonné. Le motif de l'état est Aucune activité.
* Problèmes techniques : L'état d'interaction est Fermé et abandonné. La raison de l'état est Problèmes de bot.
* Entrée utilisateur non valide : l'état d'interaction est Fermé et abandonné. Le motif de l'état est Entrée utilisateur non valide.
{#va-api-features-v3__ul_zts_y3j_dsb}

Pour demander au bot principal de prendre le contrôle, envoyez le takeControl marqueur dans le corps de la charge utile au bot principal avec une valeur de true.  
Exemple de charge utile du message :

    {​ 
       "requestId": "xxxx-xxxx-xxxx-xxxx",
       "clientSessionId": "xxx-xxx-xxx-xxx",
       "message": {
           "text":"invalid3",
           "typed":true
           }
       "body":[{
           "uiType":"OutputText",
           "group":"DefaultText",
           "value":"Sorry, I didn't get that. Could you help me by answering this?"
           },
           {
           "uiType":"Boolean",
           "group":"DefaultPicker",
           "required":true,
           "nluTextEnabled": false,
           "label":"Choose a value",
           "options":[
              {"label":"Yes"},
              {"label":"No"}
              ]
           }],
        "takeControl":true,
        "score":0
    } 

## Amélioration des erreurs de changement de rubrique et du dépannage {#va-api-features-v3__section_b3w_cks_2rb}

Le changement de rubrique peut échouer pour l'une des raisons suivantes :

* La demande inclut à la fois le nom de la rubrique et l'ID de la rubrique (mot clé Découverte de rubriques) ou le nom de l'intention de rubrique et l'ID de l'intention de rubrique (découverte de rubriques NLU). Spécifiez l'un ou l'autre.
* La demande inclut une rubrique ou un nom d'intention ou un ID non valide.
* Le nom ou l'ID de la rubrique/intention est valide, mais Agent virtuel ne peut pas l'exécuter car il est inactif ou n'appartient pas à une rubrique. Par exemple, si le nom ou l'ID fait référence à un bloc de rubriques ou à un actif de contrôle personnalisé.
* La rubrique demandée est déjà en cours d'exécution.
* La rubrique demandée est valide, mais une condition de sécurité empêche d'y accéder. Par exemple, la rubrique peut ne pas être autorisée à s'exécuter dans le canal ou une autre condition de contrôle d'accès peut s'appliquer.
{#va-api-features-v3__ul_ekg_rnt_2rb}  
Si le changement de rubrique échoue, répond de la manière suivante, API Agent virtuel que vous l'utilisiez de manière synchrone ou asynchrone :

* En cas d'échec du changement de rubrique, la conversation est fermée avec un message indiquant que la conversation ne peut pas continuer. La conversation ne restera plus à l'état ouvert.
* La demande précédente est marquée comme traitée afin qu'une nouvelle demande puisse être effectuée sans attendre le délai d'expiration.
* La raison de la défaillance est consignée dans la table de journal système (Framework de tests automatisésJournaux SystèmeErreurs).
{#va-api-features-v3__ul_xzw_wqt_2rb}

## Améliorations de la négociation synchrone {#va-api-features-v3__synchronous_support_enhancements}

À partir de la version 3.0.x, API Agent virtuel peut être transféré à un agent actif de manière synchrone. Lorsqu'un utilisateur ou un agent termine une conversation, le transfert vers Agent virtuel s'effectue également de manière synchrone. Certains messages système et messages de temps d'attente sont également envoyés de manière synchrone.  
Pour utiliser le transfert synchrone vers un agent actif, tenez compte des instructions suivantes :

* Configurez le point de terminaison de Agent virtuel réponse. Messagerie instantanée d'agent Les messages seront remis au point de terminaison que vous spécifiez.
* Vous devez désactiver manuellement les notifications pour l'instance.
* Si vous utilisez le transfert synchrone vers un agent actif, API Agent virtuel envoie l'indicateur de saisie s'il est activé :

      {
        "uiType": "ActionMsg",
        "actionType": "StartTypingIndicator",
      }

* Les rubriques qui utilisent les fonctionnalités suivantes ne sont pas prises en charge en mode synchrone : [téléchargement de fichiers](https://servicenow-prod.fluidtopics.net/nHYSLXOxxAFDXRVq~4qr4g "Utilisez l’ensemble des contrôles d’entrée fournis par Concepteur d'agent virtuel pour inviter et capturer des informations à partir de l’utilisateur dans une conversation."), bloc [Utilitaire d'action](https://servicenow-prod.fluidtopics.net/QwowBijhuL0igcscYXtP1g "Utilisez l’utilitaire Action d’une Agent virtuel rubrique pour sélectionner les propriétés d’action de flux que le nœud doit créer. L’utilitaire Action s’intègre Agent virtuel au ServiceNow Studio de workflow produit.") de [rubriques et](https://servicenow-prod.fluidtopics.net/QE7x9BsslveihYTLmMp_fA "Agent virtuel Fournit des blocs de rubriques prédéfinis que les auteurs de rubriques ou les administrateurs peuvent utiliser pour exécuter des fonctions ou des tâches spécifiques liées à la plateforme dans des conversations avec des bots. Par exemple, certains blocs de rubriques vous permettent de vérifier la disponibilité de l’agent ou de générer des Recherche IA résultats.") pause.
{#va-api-features-v3__ul_pmt_p2s_2rb}  
Pour désactiver ces fonctionnalités et activer la prise en charge synchrone, procédez comme suit :

1. Accédez à Toussys_cs_channel.liste.
2. Sélectionnez l'enregistrement bot à bot.
3. Décochez la case Activer les notifications pour la désactiver.
4. Si vous ne prévoyez pas d'effectuer le transfert vers un agent actif en mode synchrone, désactivez la case à cocher Indicateur de saisie de support pour le désactiver.
5. Cochez la case Synchrone .  
   Figure 1. Canal bot à bot avec prise en charge synchrone activée
6. Cliquez sur Mettre à jour.
{#va-api-features-v3__ol_icm_x3j_gqb}

## Prise en charge des messages d'action {#va-api-features-v3__section_c4v_wr3_dsb}

En plus de transmettre des messages à un ServiceNow® Agent virtuel bot secondaire, le bot principal ou le client de messagerie instantanée peut transmettre des messages à un agent via Messagerie instantanée d'agent. Utilisez le action paramètre transmis dans le corps de la demande pour spécifier comment le contenu doit être traité.  
API Agent virtuel prend en charge les types de messages d'action suivants :{#va-api-features-v3__table_g3b_cyp_dsb__entry__2}

| Valeur actionType | Description |
|-|-|
| ChatSubHeader | Message sortant indiquant que l'un des événements suivants s'est produit : * Échec de la traduction dynamique. * Le pilote automatique de l'agent actif a été lancé et terminé. {#va-api-features-v3__ul_kmy_xcg_hsb} |
| StartSpinner | Message sortant qui démarre un spinner lorsqu'un message est en attente en raison de processus asynchrones, tels que Recherche IA ou le filtre de vulgarité. |
| EndSpinner | Message sortant qui arrête le spinner qui a été envoyé précédemment. |
| Message StartTypingIndicatorActionMsg | Message sortant indiquant qu'un utilisateur ou un agent a commencé à saisir du texte (après qu'un agent a accepté la conversation instantanée). |
| EndTypingIndicatorActionMsg | Message sortant indiquant qu'un utilisateur ou un agent a arrêté de saisir. |
| SubscribeToSupportQueue (File d'attente d'abonnement) | Indique que la conversation est définie sur la file d'attente de support. |
| S'abonner à ChatPresence | Message sortant indiquant qu'une conversation avec un agent actif a commencé. |
| SwitchToLiveAgent | Message sortant indiquant qu'un agent actif a accepté la conversation. |
| SwitchToVirtualAgent | Message sortant indiquant que la session de l'agent actif est terminée et que la conversation est renvoyée à Agent virtuel. |
| Changer de conversation | Message sortant indiquant qu'une notification a été envoyée. Cette opération crée une nouvelle conversation, puis Agent virtuel bascule vers la nouvelle conversation. |
| Système | Message sortant indiquant l'un des éléments suivants : * Un agent actif est entré dans le chat. * L'agent actif ou l'utilisateur a fermé la messagerie instantanée. * La conversation avec un agent actif a expiré. {#va-api-features-v3__ul_bdd_nlq_dsb} |
[Tableau 1. Types de messages d'action pris en charge]

{#va-api-features-v3__table_g3b_cyp_dsb}

## Prise en charge du marqueur silentMessage {#va-api-features-v3__section_t1b_lrq_dsb}

Un message silencieux est un message qui ne nécessite pas de réponse. Si Agent virtuel vous recevez une demande avec silentMessage=true, tous les messages suivants du bot sont supprimés jusqu'à ce que vous Agent virtuel receviez une demande de désactivation du mode silencieux (silentMessage=false).  
Exemple de charge utile du message du bot primaire :

    { 
       "token": "BOT_TOKEN",
       "botToBot": true,
       "clientSessionId": "884502214730301027f83ee4070f589a",
       "clientVariables": {},
       "requestId": "48450221d23030107300b7756770bc9b",
       "silentMessage": "true",
       "timestamp": 1623916324820,
       "timezone": "GMT",
       "userId": "abel.tuter",
       "emailId": "abel.tuter@example.com" 
    }

Remarque :  
Si silentMessage=true, les notifications ne sont pas remises.

## Chargements sécurisés de fichiers à partir d'une URL privée {#va-api-features-v3__section_xjy_j12_2rb}

API Agent virtuel prend en charge les chargements de fichiers d'une taille maximale de 1 Go à partir d'une URL privée. Le bot principal doit transmettre l'ID d'utilisateur, l'ID d'application du fournisseur facultatif et le nom du fichier. Respectez les directives suivantes :

* L'ID d'application du fournisseur est facultatif.
* L'ID d'utilisateur et l'ID d'application du fournisseur doivent être envoyés avant le nom du fichier dans la charge utile.
* Un rôle doit être indiqué dans la glide.attachment.role propriété pour l'utilisateur final. Pour plus d'informations, voir [Exiger un rôle pour joindre des fichiers](https://www.servicenow.com/docs/access?context=t_DisablingTheDragAndDropFeature&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).
* L'authentification de base ou OAuth est prise en charge, mais pas l'authentification de message.
{#va-api-features-v3__ul_dvc_vn2_2rb}  
Exemple de charge utile du message du bot primaire :

    curl -X POST \
      https://instance.service-now.com/api/now/v1/cccif/media/upload \
      -H 'authorization: Basic YWRtaW46YWRtaW4=' \
      -H 'content-type: multipart/form-data; \
      -F user_id=xxxxxx \
      -F provider_application_id=optionalId \
      -F 'file=@SomeFile.png'

API Agent virtuel envoie l'exemple JSON suivant :

    {
      "result": {
        "mediaUrl": "http://123.456.7.8:8080//api/now/v1/cs/media/string",
        "name":"imagefile.png",
        "state":"pending",
        "attachmentId":"abcdefghijklmno12345"
      }
    }

## Améliorations apportées à Messagerie instantanée d'agent dans la API Agent virtuel version 3.14.3 {#va-api-features-v3__section_qft_pcv_c2c}

* Lorsque le bot principal transfère une messagerie instantanée à un agent actif, API Agent virtuel envoie l'ID de l'agent, en plus du nom et de l'avatar de l'agent, au bot principal.
* API Agent virtuel Envoie l'historique de messagerie instantanée du bot primaire à l'agent actif n'importe où dans la demande au cours d'une conversation en cours. Ce comportement est contrôlé par la propriété système suivante : allow_storing_history_in_ongoing-conversation. Définissez la valeur de la propriété sur vrai pour envoyer l'historique de la messagerie instantanée n'importe où dans la demande.
* L'enregistrement d'interaction contient la transcription de l'historique de la messagerie instantanée ainsi que l'horodatage des messages individuels.
{#va-api-features-v3__ul_fd3_rcv_c2c}