--- sourceDocument: Interfaces conversationnelles Australie sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/conversational-interfaces Release : - australia ft:locale : - fr-FR ft:publication_title : - Interfaces conversationnelles Australie ft:clusterId : - convint bundleId : - convint workflow : - Platform --- # Contrôles dans API Agent virtuel # Contrôles dans API Agent virtuel {#ariaid-title1} * Rversion finale: Australia * * Mis à jour 12 mars 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 minutes de lecture API Agent virtuel vous fournit divers contrôles pour gérer les réponses dans votre conversation. Les contrôles disponibles dans API Agent virtuel sont les suivants : ## Texte de sortie {#va-api-controls__section_qxy_lv5_d3c} { "uiType": "OutputText", "group": "DefaultText", "value": "**bold**\n*italic*\n***bold italic***\n[Google](https://empcygiraffe6.service-now.com/va_link.do?token=77ee77ef77eSZGFlMTc3OWU5NzY2MTExMDUyNjFiMzQ3MTE1M2FmYjTvt6zvt5Qx77es77etWE1nS0ZLOElhU1FQYzhIajh2dmNmZz09WHdPTDYzV3ZpUWF1MGJwRlB0ZktUY29wVWt1UGVueUNIS1FkRHRyUW9idHlmVFZlRWJOODZyRjZYN0VQamxnWUV5WkhZSDRJaWFGWmJRZU1CaXZLYWhudnkwbDdvNFZsMlMzUUw4Q3VRTUJWMHhvTWlRLXZOQnh5M0hveVBuellNVmJCbGlka0RqNTAzVFVUQml0MTZzSnlUTVJoakdZektldXdoYXlM77eu77ev&target_url=https%3A%2F%2Fwww.google.co.in)\n\n- ***ul1***\n- ***ul2***\n\n\n1. ol1\n2. ol2\n\n", "maskType": "NONE | SECURE" } {#va-api-controls__table_nb3_2w5_d3c__entry__2} | Champ | Description | |-|-| | valide | Contient la valeur du texte de sortie. | | maskType | \<\< NONE \>\> indique un texte normal et \<\< SECURE \>\> indique un texte de sortie sécurisé. | [ ] {#va-api-controls__table_nb3_2w5_d3c} ## HTML de sortie {#va-api-controls__section_m53_3w5_d3c} { "uiType": "OutputHtml", "group": "DefaultOutputHtml", "style": "inline", "height": 0, "width": 0, "value": "

Company	Contact	Country
Alfreds Futterkiste	Maria Anders	Germany
Centro comercial Moctezuma	Francisco Chang	Mexico
Ernest Handel	Roland Mendel	Austria
Island Trading	Helen Bennett	UK
Laughing Bacchus Winecellars	Yoshi Tannamuri	Canada
Magazzini Alimentari Riuniti	Giovanni Rovelli	Italy

", "imageUrl": "https://empcygiraffe6.service-now.com//api/now/v1/cs/media/zKFqUx0NJyVaFRJqzeRhFgeMsMo9211mCvrMgKzrRpTWqFJDrXLOadoYGC5CQnwr", "imageHeight": 217, "imageWidth": 501, "links": [ { "link": "https://www.google.co.in", "label": "Alfreds Futterkiste" }, { "link": "https://www.google.co.in", "label": "Ernest Handel" }, { "link": "https://www.google.co.in", "label": "Canada" } ] } {#va-api-controls__table_sfd_mw5_d3c__entry__2} | Champ | Description | |-|-| | valide | Contient la valeur html. | | imageUrl | Contient l'image HTML si l'option \<\< Conversion HTML en image requise \>\> est activée sur sys_cs_provider. | | Hauteur de l'image | Contient la hauteur de l'image si l'option \<\< Conversion HTML en image requise \>\> est activée sur sys_cs_provider. | | largeur d'image | Contient la largeur de l'image si l'option \<\< Conversion HTML en image requise \>\> est activée sur sys_cs_provider. | | liens | Contient des liens dans le code HTML donné si l'option \<\< Conversion HTML en image requise \>\> est activée sur sys_cs_provider. | [ ] {#va-api-controls__table_sfd_mw5_d3c} ## Image de sortie {#va-api-controls__section_as4_yw5_d3c} { "uiType": "OutputImage", "group": "DefaultOutputImage", "value": "https://adaptivecards.io/content/cats/1.png", "altText": "Image alt text" } {#va-api-controls__table_qfk_1x5_d3c__entry__2} | Champ | Description | |-|-| | valide | Contient l'URL de l'image. | | Texte alternatif | Contient le texte alternatif de l'image (non obligatoire). | [ ] {#va-api-controls__table_qfk_1x5_d3c} ## Lien de sortie {#va-api-controls__section_xns_dx5_d3c} { "uiType": "OutputLink", "group": "DefaultOutputLink", "label": "ServiceNow", "header": "The world works with ServiceNow", "type": "link", "value": { "action": "https://empcygiraffe6.service-now.com/va_link.do?token=&target_url=https%3A%2F%2Fwww.servicenow.com", "target": "_blank" } } {#va-api-controls__table_shl_rx5_d3c__entry__2} | Champ | Description | |-|-| | header | En-tête de lien | | étiquette | Étiquette du lien | | valeur-\>action | URL de lien | [ ] {#va-api-controls__table_shl_rx5_d3c} ## Lien multiple {#va-api-controls__section_o4h_5x5_d3c} { "uiType": "GroupedPartsOutputControl", "group": "DefaultGroupedPartsOutputControl", "groupPartType": "Link", "header": "Multilink Header", "values": [ { "action": "https://empcygiraffe6.service-now.com/va_link.do?token=&target_url=https%3A%2F%2Fwww.link1.com", "description": "a short desc", "label": "link 1 label", "context": "KB", "target": "_blank" }, { "action": "https://empcygiraffe6.service-now.com/va_link.do?token=&target_url=https%3A%2F%2Fwww.link2.com", "description": "a short desc", "label": "link 2 label", "context": "ITSM", "target": "_blank" } ] } {#va-api-controls__table_bsk_xx5_d3c__entry__2} | Champ | Description | |-|-| | header | En-tête de contrôle MultiLink | | valeurs | Tableau de liens | [ ] {#va-api-controls__table_bsk_xx5_d3c} **Structure des liens dans le tableau de liens :** {#va-api-controls__table_us4_x3v_d3c__entry__2} | Champ | Description | |-|-| | étiquette | Étiquette du lien | | action | URL de lien | | description | Description de lien | | contexte | Contexte ou taxonomie | [ ] {#va-api-controls__table_us4_x3v_d3c} ## Carte de sortie {#va-api-controls__section_ljw_bjv_d3c} { "uiType": "OutputCard", "group": "DefaultOutputCard", "templateName": "", "data": "", } {#va-api-controls__table_oxm_4jv_d3c__entry__2} | Champ | Description | |-|-| | Nom du modèle | Type de carte ou nom de carte | | données | JSON représentant les données de la carte. Remarque : Le champ de données sera de type chaîne. Vous devez les analyser pour utiliser les données. | [ ] {#va-api-controls__table_oxm_4jv_d3c} **Grande image avec du texte** { "uiType": "OutputCard", "group": "DefaultOutputCard", "templateName": "Large image with text", "data": "{\"image\":\"https://adaptivecards.io/content/cats/1.png\",\"description\":\"Large image description\", \"dataNowSmartLink\":\"W9F4Ld8z\",\"title\":\"Large image\",\"imageAlt\":\"large image alt text\",\"url\":\"\",\"target\":\"_blank\"}", "smartLinksMetadata": { "W9F4Ld8z": { "type": "standard", "source": "", "target": "_blank" } } } **Petite image avec du texte** { "uiType": "OutputCard", "group": "DefaultOutputCard", "templateName": "Small image with text", "data": "{\"image\":\"https://adaptivecards.io/content/cats/1.png\",\"description\":\"Small image with text description\",\"dataNowSmartLink\":\"i6CL61tN\",\"title\":\"Small image with text\",\"imageAlt\":\"small image alt text\",\"url\":\"\",\"target\":\"_blank\"}", "smartLinksMetadata": { "i6CL61tN": { "type": "standard", "source": "", "target": "_blank" } } } **Youtube** { "uiType": "OutputCard", "group": "DefaultOutputCard", "templateName": "Youtube Video Card", "data": "{\"link\":\"https://empcygiraffe6.service-now.com/va_link.do?token=&target_url=servicenow.com\",\"description\":\"The world works with ServiceNow\",\"id\":\"IWsGk-Kh5ko\",\"title\":\"ServiceNow\",\"url\":\"\",\"target\":\"_blank\"}" } **Enregistrement** { "uiType": "OutputCard", "group": "DefaultOutputCard", "templateName": "Card", "data": "{\"sys_id\":\"0c5f3cece1b12010f877971dea0b1449\",\"subtitle\":\"INC0008001\",\"dataNowSmartLink\":\"VLzQTN88\",\"title\":\"Incident\",\"fields\":[{\"fieldLabel\":\"Number\",\"fieldValue\":\"INC0008001\"},{\"fieldLabel\":\"Short description\",\"fieldValue\":\"ATF:TEST2\"},{\"fieldLabel\":\"Caller\",\"fieldValue\":\"survey user\"}],\"table_name\":\"incident\",\"url\":\"https://empcygiraffe6.service-now.com/va_link.do?token=target_url=https%3A%2F%2Fempcygiraffe6.service-now.com%2Fsp%3Fsys_id%3D0c5f3cece1b12010f877971dea0b1449%26id%3Dticket%26table%3Dincident\",\"target\":\"_blank\"}", "smartLinksMetadata": { "VLzQTN88": { "type": "standard", "source": "https://empcygiraffe6.service-now.com/sp?sys_id=0c5f3cece1b12010f877971dea0b1449&id=ticket&table=incident", "target": "_blank" } } } ## Sortie en plusieurs parties {#va-api-controls__section_vlf_qkv_d3c} { "uiType": "MultiPartOutput", "group": "DefaultMultiPartOutput", "navigationBtnLabel": "Click for more", "content": { "uiType": "OutputText", "value": "multipart text output", "maskType": "NONE" } } {#va-api-controls__table_rvm_bmv_d3c__entry__2} | Champ | Description | |-|-| | navigationBtnLabel | Étiquette du bouton de navigation | | contenu | Représente le contrôle défini avec plusieurs parties. Remarque : * Le contenu peut être OutputText, OutputImage, OutputHTML, OutputLink ou OutputCard. * Vous devez envoyer \<\< click_for_more \>\> en réponse pour passer à la partie suivante. {#va-api-controls__ul_njh_hmv_d3c} | [ ] {#va-api-controls__table_rvm_bmv_d3c} ## Texte d'entrée {#va-api-controls__section_zrn_lmv_d3c} { "uiType": "InputText", "group": "DefaultText", "required": true, "nluTextEnabled": false, "entityType": "Text", "label": "enter something", "maskType": "NONE" } {#va-api-controls__table_wj5_nmv_d3c__entry__2} | Champ | Description | |-|-| | étiquette | Étiquette de texte d'entrée | | obligatoire | Vrai ou faux indiquant si le contrôle peut être ignoré ou non. | | maskType | AUCUN ou SÉCURISÉ. * NONE indique une entrée normale. * SECURE indique une entrée sécurisée. {#va-api-controls__ul_p22_wmv_d3c} | | entityType | L'entrée est un texte, un e-mail ou une adresse IP. | | nluTextEnabled | Indique si NLU est activé sur ce nœud ou non. | [ ] {#va-api-controls__table_wj5_nmv_d3c} ## Booléen {#va-api-controls__section_tsw_dnv_d3c} { "uiType": "Boolean", "group": "DefaultPicker", "required": true, "nluTextEnabled": false, "entityType": "Boolean", "label": "select yes/no", "options": [ { "label": "Yes", "value": "yes", "renderStyle": "data" }, { "label": "No", "value": "no", "renderStyle": "data" } ] } {#va-api-controls__table_g2w_fnv_d3c__entry__2} | Champ | Description | |-|-| | étiquette | Invite de contrôle booléen | | obligatoire | Vrai ou faux indiquant si le contrôle peut être ignoré ou non. | | maskType | AUCUN ou SÉCURISÉ. * NONE indique une entrée normale. * SECURE indique une entrée sécurisée. {#va-api-controls__ul_mnn_lnv_d3c} | | entityType | Booléen | | nluTextEnabled | Indique si la NLU est activée à ce nœud ou non. | | options | Options booléennes | [ ] {#va-api-controls__table_g2w_fnv_d3c} **Structure des options dans le tableau des options :** {#va-api-controls__table_xjn_wnv_d3c__entry__2} | Champ | Description | |-|-| | étiquette | Étiquette d'option | | valide | Valeur de l'option | | renderStyle | Données ou bouton | [ ] {#va-api-controls__table_xjn_wnv_d3c} ## Sélecteur {#va-api-controls__section_nrq_14v_d3c} { "uiType": "Picker", "group": "DefaultPicker", "required": true, "nluTextEnabled": false, "label": "Select an option", "itemType": "List", "style": "list", "multiSelect": false, "options": [ { "label": "option 1", "value": "option 1", "renderStyle": "data", "enabled": false }, { "label": "option 2", "value": "option 2", "renderStyle": "data", "enabled": false }, { "label": "option 3", "value": "option 3", "renderStyle": "data", "enabled": false } ], "scriptedData": { "cardData": "{\"title\":\"Choice - Large image with text\",\"description\":\"Choice - Large image with text description\",\"image\":\"https://adaptivecards.io/content/cats/1.png\",\"imageAlt\":\"alt text\"}", "cardName": "Large image with text", "cardTemplate": "", "renderStyle": "card" } } {#va-api-controls__table_cgz_d4v_d3c__entry__2} | Champ | Description | |-|-| | étiquette | Invite de contrôle du sélecteur | | Le style | Liste ou carrousel. Le carrousel indique le contrôle du carrousel. | | obligatoire | Vrai ou faux indiquant si le contrôle peut être ignoré ou non. | | maskType | AUCUN ou SÉCURISÉ. * NONE indique une entrée normale. * SECURE indique une entrée sécurisée. {#va-api-controls__ul_ds3_j4v_d3c} | | entityType | Booléen | | nluTextEnabled | Indique si la NLU est activée à ce nœud ou non. | | options | Options booléennes | | données scriptées | Représente une carte à afficher avec le sélecteur. | [ ] {#va-api-controls__table_cgz_d4v_d3c} **Structure des options dans le tableau des options :** {#va-api-controls__table_ib4_q4v_d3c__entry__2} | Champ | Description | |-|-| | étiquette | Étiquette d'option | | valide | Valeur de l'option | | renderStyle | données ou bouton | [ ] {#va-api-controls__table_ib4_q4v_d3c} **Structure scriptedData :** {#va-api-controls__table_jkd_w4v_d3c__entry__2} | Champ | Description | |-|-| | cardName | Nom du modèle | | cardData | Données de la carte sous forme de chaîne JSON. | [ ] {#va-api-controls__table_jkd_w4v_d3c} ## Carrousel {#va-api-controls__section_jbm_2pv_d3c} { "uiType": "Picker", "group": "DefaultPicker", "required": true, "nluTextEnabled": false, "label": "select an image", "itemType": "Picture", "style": "carousel", "multiSelect": false, "options": [ { "label": "name1", "description": "a description of value_1 item", "attachment": "https://adaptivecards.io/content/cats/1.png", "value": "value_1", "renderStyle": "data", "enabled": false }, { "label": "name2", "description": "a description of value_2 item", "attachment": "https://adaptivecards.io/content/cats/1.png", "value": "value_2", "renderStyle": "data", "enabled": false }, { "label": "name3", "description": "a description of value_3 item", "attachment": "https://adaptivecards.io/content/cats/1.png", "value": "value_3", "renderStyle": "data", "enabled": false } ], "scriptedData": null } {#va-api-controls__table_rq3_gpv_d3c__entry__2} | Champ | Description | |-|-| | étiquette | Invite de contrôle du sélecteur | | Le style | Liste ou carrousel. Le carrousel indique le contrôle du carrousel. | | obligatoire | Vrai ou faux indiquant si le contrôle peut être ignoré ou non. | | maskType | AUCUN ou SÉCURISÉ. * NONE indique une entrée normale. * SECURE indique une entrée sécurisée. {#va-api-controls__ul_pyn_mpv_d3c} | | entityType | Booléen | | nluTextEnabled | Indique si la NLU est activée à ce nœud ou non. | | options | Options booléennes | [ ] {#va-api-controls__table_rq3_gpv_d3c} **Structure des options dans le tableau des options :** {#va-api-controls__table_ttk_spv_d3c__entry__2} | Champ | Description | |-|-| | étiquette | Étiquette d'option | | valide | Valeur de l'option | | description | Description de l'option | | attachment | Image ou image pour l'option | [ ] {#va-api-controls__table_ttk_spv_d3c} ## Date {#va-api-controls__section_c4c_cqv_d3c} { "uiType": "Date", "group": "DefaultDate", "required": true, "nluTextEnabled": false, "entityType": "Date", "label": "test date" } {#va-api-controls__table_rgt_3qv_d3c__entry__2} | Champ | Description | |-|-| | étiquette | Invite de contrôle de la date | | obligatoire | Vrai ou faux indiquant si le contrôle peut être ignoré ou non. | | entityType | Date | | nluTextEnabled | Indique si la NLU est activée à ce nœud ou non. | [ ] {#va-api-controls__table_rgt_3qv_d3c} ## Heure {#va-api-controls__section_vqc_5qv_d3c} { "uiType": "Time", "group": "DefaultDate", "required": true, "nluTextEnabled": false, "entityType": "Time", "label": "Select time" } {#va-api-controls__table_lvw_vqv_d3c__entry__2} | Champ | Description | |-|-| | étiquette | Invite de contrôle de l'heure | | obligatoire | Vrai ou faux indiquant si le contrôle peut être ignoré ou non. | | entityType | Heure | | nluTextEnabled | Indique si la NLU est activée à ce nœud ou non. | [ ] {#va-api-controls__table_lvw_vqv_d3c} ## Date/Heure {#va-api-controls__section_b4l_xqv_d3c} { "uiType": "DateTime", "group": "DefaultDate", "required": true, "nluTextEnabled": false, "entityType": "Time", "label": "Select time" } {#va-api-controls__table_xxj_zqv_d3c__entry__2} | Champ | Description | |-|-| | étiquette | Invite de contrôle de la date et de l'heure | | obligatoire | Vrai ou faux indiquant si le contrôle peut être ignoré ou non. | | entityType | Heure | | nluTextEnabled | Indique si la NLU est activée à ce nœud ou non. | [ ] {#va-api-controls__table_xxj_zqv_d3c} ## Démarrer la conversation {#va-api-controls__section_clp_brv_d3c} { "uiType": "ActionMsg", "actionType": "StartConversation", "conversationId": "e0494b2187332550326d0d05dabb350d" } {#va-api-controls__table_yld_2rv_d3c__entry__2} | Champ | Description | |-|-| | uiType | Message d'action | | actionType | Démarrer la conversation | [ ] {#va-api-controls__table_yld_2rv_d3c} Indique que la conversation a commencé dans API Agent virtuel.