Implémenter des informations de conversation

Pour produire des données de conversation sous la forme d’événements d’expérience XDM et vous assurer que ces événements d’expérience de conversation aboutissent dans Adobe Experience Platform sous la forme de jeux de données, instrumentez votre application d’agent ou service pour utiliser des informations de conversation.

Cet article décrit les étapes de mise en œuvre requises.

Schéma et jeux de données

Configurez des jeux de données pour les principaux événements de conversation : invite, réponse, retour d’informations. Les jeux de données d’invite, de réponse et de commentaires doivent étendre le schéma de base d’événement d’expérience XDM avec le groupe de champs Événement de conversation et peuvent éventuellement inclure le groupe de champs Informations agences et d’autres groupes de champs supplémentaires.

Vous pouvez définir des jeux de données distincts pour les invites, les réponses et les commentaires ou combiner les données dans des jeux de données. Par exemple, utilisez un jeu de données pour les invites et les réponses et un autre pour les commentaires. Vous pouvez également utiliser un jeu de données distinct pour chaque type d’événement de conversation, comme illustré dans la section Fonctionnement.

À titre d’illustration, utilisez :

La disposition des jeux de données et la diffusion des événements de conversation dans ces jeux de données sont des préoccupations distinctes. Envoyez chaque événement de conversation dès que les données sont disponibles afin de garantir la stabilité des identifiants de conversation et de tournage. Des identifiants stables facilitent une corrélation appropriée par le service Conversation Blender entre les jeux de données.

Groupe de champs Événement de conversation

Le groupe de champs Événement de conversation est un groupe de champs obligatoire qui utilise l’objet conversation.

L’objet de conversation capture les données pour :

Conversation

Un conversationID unique identifie une conversation. Par exemple : conversationID = "conv-001". Le conversationID permet de regrouper tous les événements de rotation associés dans la même expérience de conversation.

Le schéma prend également en charge conversationName. Nom lisible par l’utilisateur qui décrit le contexte global de la conversation, tel que : France Geography Q&A. Le nom de la conversation est généré automatiquement, mais vous pouvez le mettre à jour. Le nom de la conversation est également renseigné pour signals[].name. Adobe renseigne le conversationName avec la même valeur que le signal signals[].name = « title ». Vous pouvez définir la conversation.conversationName sur n’importe quel jeu de données que vous renseignez et remplacer la valeur fournie par Adobe.

Tourner

Un virage est un cycle d’interaction au sein d’une conversation.

turnID Un turnID unique identifie un virage. Par exemple :

conversationID = "conv-001"
turnID = "turn-001"

Les mêmes conversationID et turnID sont utilisés pour corréler l’invite, la réponse et le retour d’informations associés à ce virage. Cette corrélation fonctionne entre les enregistrements diffusés séparément ou qui se retrouvent dans différents jeux de données. Un turnId ne doit être unique que dans la même conversation, mais peut être réutilisé dans plusieurs conversations. Par exemple, vous pouvez avoir les deux turn-001 comme turnID dans les conversations avec conversationID conv-001 et conv-002.

Invite

Une invite correspond à l’entrée envoyée à l’agent. Dans la plupart des scénarios client, cette entrée correspond à la question, à la requête, à l’instruction ou au message de l’utilisateur ou de l’utilisatrice.

L’invite utilise la représentation suivante : conversation.prompt

Les champs d’invite importants sont les suivants :

Une invite peut contenir plusieurs segments bruts. Par exemple, un utilisateur ou une utilisatrice saisit du texte et inclut une URL.

Réponse

Une réponse correspond au contenu renvoyé par l’agent ou une autre partie répondant.

conversation.response Un responseID unique représente la réponse.

Les champs de réponse importants sont les suivants :

Les types de sources documentés sont les suivants :

Commentaires

Le retour d’informations est l’évaluation ou la réaction explicite de l’utilisateur ou de l’utilisatrice à l’interaction.

La structure de rétroaction comprend : conversation.feedback.

Exemples :

La plage de notes documentée va de -1.0 à 1.0.

Un événement de retour peut être représenté en tant qu’événement de retour uniquement à l’aide de : eventType = "conversation.feedback".

Lorsque la rétroaction s’applique à un virage particulier, conservez les conversationID et turnID appropriés afin que le mélangeur de conversation puisse associer la rétroaction à l’interaction pertinente.

Signal

Un signal est une observation analytique structurée du contenu de la conversation. Le service d’extraction de signal fournit des signaux prêts à l’emploi. Aucune action n’est requise pour fournir des signaux, mais vous pouvez ajouter des signaux dans le cadre de l’intégration.

Un signal possède les champs suivants.

Le service d’extraction de signaux renseigne l’objet signals pour le jeu de données de signaux.

Le conteneur de signals[].attributes.{subjects,intents,tones,sentiment} précédent est obsolète.

Type de source

Vous devez définir une valeur pour source pour chaque objet prompt, response ou feedback dans un événement. Toute valeur est acceptable. Utilisez des valeurs qui vous aident à comprendre l’origine des données. Par exemple :

Type d’objectif (texte brut)

Vous devez définir une valeur pour l’attribut purpose sur tout élément de l’objet raw dans un objet prompt, response ou feedback. Toute valeur de chaîne est acceptable. Ce champ permet de différencier ce qui est stocké dans le texte brut. Les valeurs utiles sont les suivantes, d’autres valeurs sont également valides :

Conversation

Consultez ci-dessous les détails complets d’un objet de conversation.

Groupe de champs Informations sur l’agence

Le groupe de champs Informations agentiques est un groupe de champs facultatif qui utilise l’objet agenticExperience. Utilisez ce groupe de champs si vous souhaitez effectuer le suivi des informations sur les agences.

Pour implémenter des événements qui propagent le groupe de champs Informations sur l’agence avec des données, vous devez vérifier les points suivants :

{
  "_id":"a33e1068-3966-468b-8682-e5e493827ffe",
  "timestamp":"2026-09-11T00:03:15Z",
  "eventType":"agent.interaction",
  "identityMap":{
    "ECID":[
      {
        "id": "12345678901234567890123456789012345678",
        "primary": true
      }
    ]
  },
  "agenticExperience":{
    "conciergeID":"concierge-abc123",
    "name":"Customer Support Experience",
    "version":"1.0.0",
    "environment":"dev",
    "mode":"preview",
    "agents":[
      {
        "agentID":"agent-001",
        "name":"Chatbot Assistant",
        "version":"2.1.3",
        "score":0.92
      },
      {
        "agentID":"agent-002",
        "name":"Voice Assistant",
        "version":"3.0.0",
        "score":0.88
      }
    ],
    "skills":[
      {
        "skillID":"skill-intent-recognition",
        "skillInvocationID":"inv-9f2a-001",
        "name":"Intent Recognition",
        "version":"1.0.0",
        "agentID":"agent-001",
        "invocationSource":"main",
        "score":0.95,
        "failed":false,
        "sequenceNumber":1,
        "timestamp":"2026-09-11T00:03:14Z",
        "skillSource":"inline",
        "executionContext":"inline",
        "reasoning":{
          "narration":"Recognized an intent to verify a geography fact"
        },
        "parameters":[
          { "key":"language", "value":"en-US" },
          { "key":"confidenceThreshold", "value":"0.8" }
        ]
      },
      {
        "skillID":"skill-faq-retrieval",
        "skillInvocationID":"inv-9f2a-002",
        "name":"FAQ Retrieval",
        "version":"1.2.0",
        "agentID":"agent-001",
        "invocationSource":"main",
        "score":0.89,
        "failed":false,
        "sequenceNumber":2,
        "timestamp":"2026-09-11T00:03:15Z",
        "skillSource":"inline",
        "executionContext":"forked",
        "parameters":[
          { "key":"maxResults", "value":"5" }
        ]
      },
      {
        "skillID":"skill-speech-recognition",
        "skillInvocationID":"inv-9f2a-003",
        "name":"Speech Recognition",
        "version":"2.0.1",
        "agentID":"agent-002",
        "invocationSource":"main",
        "score":0.91,
        "failed":false,
        "sequenceNumber":1,
        "timestamp":"2026-09-11T00:03:15Z",
        "skillSource":"deferred",
        "executionContext":"inline",
        "parameters":[
          { "key":"languageModel", "value":"general" },
          { "key":"noiseSuppression", "value":"true" }
        ]
      }
    ]
  }
}

Groupes de champs supplémentaires

Vous pouvez ajouter des groupes de champs facultatifs au schéma que vous utilisez pour les jeux de données d’invite, de réponse et de commentaires. Par exemple :

Le client est chargé de produire les événements de conversation source. Adobe effectue l’extraction du signal et le mélange des données. Le client n’a pas besoin de mettre en œuvre les services d’extraction ou de mélange de signaux.

Type d’événement

Vous devez définir l’une des valeurs suivantes pour eventType (chaîne) pour chaque événement de conversation :

Exemple

Vous trouverez ci-dessous un exemple d’utilisation du groupe de champs Événement de conversation dans divers scénarios.

{
  "_id":"a33e1068-3966-468b-8682-e5e493827fff",
  "timestamp":"2026-09-11T00:03:15Z",
  "eventType":"conversation.turn",
  "identityMap":{
    "ECID":[
      { "id": "12345678901234567890123456789012345678", "primary": true }
    ]
  },
  "web": {
    "webPageDetails": { "URL": "https://www.adobe.com", "name": "Home Page" }
  },
  "agenticExperience":{
    "conciergeID":"concierge-abc123",
    "name":"Customer Support Experience",
    "version":"1.0.0",
    "environment":"dev",
    "mode":"preview",
    "agents":[
      { "agentID":"agent-001", "name":"Chatbot Assistant", "version":"2.1.3", "score":0.92 }
    ]
  },
  "conversation": {
    "conversationID": "conv-001",
    "conversationName": "France Geography Q&A",
    "turnID": "int-001",
    "prompt": {
      "source": "end-user",
      "raw": [
        { "text": "What is the capital of France? This link says it is Lyon.", "purpose": "User Input" },
        { "text": "https://wrong.geography.com/france", "purpose": "link" }
      ]
    }
  }
}

{
  "_id":"a33e1068-3966-468b-8682-e5e493827ffd",
  "timestamp":"2026-09-11T00:03:16Z",
  "eventType":"conversation.turn",
  "identityMap":{
    "ECID":[
      { "id": "12345678901234567890123456789012345678", "primary": true }
    ]
  },
  "web": {
    "webPageDetails": { "URL": "https://www.adobe.com", "name": "Home Page" }
  },
  "agenticExperience":{
    "conciergeID":"concierge-abc123",
    "name":"Customer Support Experience",
    "version":"1.0.0",
    "environment":"dev",
    "mode":"preview",
    "agents":[
      { "agentID":"agent-001", "name":"Chatbot Assistant", "version":"2.1.3", "score":0.92 }
    ]
  },
  "conversation": {
    "conversationID": "conv-001",
    "conversationName": "France Geography Q&A",
    "turnID": "int-001",
    "response": {
      "source": "concierge",
      "raw": [
        { "text": "The capital of France is Paris.", "purpose": "main" },
        { "text": "Would you like to plan a trip to Paris?", "purpose": "advertisement" },
        { "text": "https://en.wikipedia.org/wiki/France", "purpose": "citation" }
      ]
    }
  }
}

{
  "_id":"a33e1068-3966-468b-8682-e5e493827ffb",
  "timestamp":"2026-09-12T00:03:15Z",
  "eventType":"conversation.feedback",
  "identityMap":{
    "ECID":[
      { "id": "12345678901234567890123456789012345678", "primary": true }
    ]
  },
  "web": {
    "webPageDetails": { "URL": "https://www.adobe.com", "name": "Home Page" }
  },
  "conversation": {
    "conversationID": "conv-001",
    "conversationName": "France Geography Q&A",
    "feedback": {
      "source": "end-user",
      "raw": [
        { "text": "Great help", "purpose": "text box" }
      ],
      "rating": {
        "score": 1,
        "classification": "Thumbs Up",
        "reasons": ["Accurate", "Quick response"]
      }
    }
  }
}

{
  "_id":"a33e1068-3966-468b-8682-e5e493827ffa",
  "timestamp":"2026-09-11T00:03:15Z",
  "eventType":"conversation.recommendation",
  "identityMap":{
    "ECID":[
      { "id": "12345678901234567890123456789012345678", "primary": true }
    ]
  },
  "web": {
    "webPageDetails": { "URL": "https://www.adobe.com", "name": "Home Page" }
  },
  "agenticExperience":{
    "conciergeID":"concierge-xyz789",
    "name":"Product Concierge",
    "version":"1.0.0",
    "environment":"prod",
    "mode":"release",
    "agents":[
      { "agentID":"agent-010", "name":"Product Advisor", "version":"1.0.0", "score":0.92 }
    ]
  },
  "conversation": {
    "conversationID": "conv-001",
    "turnID": "int-099",
    "prompt": {
      "source": "end-user",
      "raw": [
        { "text": "What product do you recommend for a new user trying to create a poster?", "purpose": "User Input" }
      ]
    },
    "response": {
      "source": "concierge",
      "raw": [
        { "text": "To create a poster, we would recommend Adobe Express - https://express.adobe.com.", "purpose": "main" },
        { "text": "https://express.adobe.com", "purpose": "link" }
      ]
    }
  },
  "productListItems": [
    { "SKU": "express" }
  ]
}

Collecte de données

Utilisez la stratégie de collecte de données suivante pour Conversation Insights.

Types d’événements

Votre application ou service d’agent envoie un événement dès que possible. Assurez-vous que l’application ou le service n’attend pas de réponse avant d’envoyer l’invite avec les informations disponibles au moment de l’événement.

Cette recommandation implique que :

Corrélation des événements

L’application ou le service de l’agent doit conserver des identifiants stables pour tous les événements associés.

L’application ou le service de l’agent génère des identifiants qui restent stables lors des reprises ou de la rediffusion. Cela permet au traitement en aval d’associer correctement les événements et d’éviter les événements en double involontaires.

Extraction de signal

L’extraction du signal a lieu après la collecte des données. Votre application ou service d’agent peut renseigner des signaux supplémentaires.

Nom du signal

Vous devez définir une valeur pour signals[].name. Toute valeur de chaîne est acceptable. Cependant, Adobe renseigne les noms suivants pendant le processus d’extraction du signal. Évitez d’utiliser ces valeurs pour name les signaux que vous envoyez, car elles risquent d’être remplacées.

Portée du signal

Toute valeur de chaîne est acceptable. Cependant, Adobe remplit les portées suivantes pendant le processus d’extraction du signal. Évitez d’utiliser ces valeurs pour scope les signaux que vous envoyez, car elles risquent d’être remplacées.

{
  "_id":"a33e1068-3966-468b-8682-e5e493827fff",
  "timestamp":"2026-09-11T00:03:15Z",
  "eventType":"conversation.turn",
  "identityMap":{
    "ECID":[
      { "id":"12345678901234567890123456789012345678", "primary":true }
    ]
  },
  "web":{
    "webPageDetails":{ "URL":"https://www.adobe.com", "name":"Home Page" }
  },
  "agenticExperience":{
    "conciergeID":"concierge-abc123",
    "name":"Customer Support Experience",
    "version":"1.0.0",
    "environment":"dev",
    "mode":"preview",
    "agents":[
      { "agentID":"agent-001", "name":"Chatbot Assistant", "version":"2.1.3", "score":0.92 }
    ],
    "skills":[
      {
        "skillID":"skill-intent-recognition",
        "skillInvocationID":"inv-9f2a-001",
        "name":"Intent Recognition",
        "version":"1.0.0",
        "agentID":"agent-001",
        "invocationSource":"main",
        "score":0.95,
        "sequenceNumber":1,
        "timestamp":"2026-09-11T00:03:14Z",
        "skillSource":"inline",
        "executionContext":"inline"
      }
    ]
  },
  "conversation":{
    "conversationID":"conv-001",
    "conversationName":"France Geography Q&A",
    "turnID":"int-001",
    "signals":[
      {
        "scope":"turn",
        "name":"subjects",
        "type":"string",
        "values":[
          { "stringValue":"capital of France", "confidence":0.93, "qualifiers":["geographical","factual-question"] },
          { "stringValue":"Lyon", "confidence":0.87, "qualifiers":["incorrect","misinformation"] }
        ]
      },
      {
        "scope":"turn",
        "name":"intents",
        "type":"string",
        "values":[
          { "stringValue":"seek-information" },
          { "stringValue":"verify-facts" }
        ]
      },
      {
        "scope":"turn",
        "name":"tones",
        "type":"string",
        "values":[
          { "stringValue":"curious" },
          { "stringValue":"uncertain" }
        ]
      },
      {
        "scope":"turn",
        "name":"sentiment",
        "type":"number",
        "values":[
          { "numberValue":0.1 }
        ]
      },
      {
        "scope":"conversation-to-date",
        "name":"subjects",
        "type":"string",
        "values":[
          { "stringValue":"unreliable source", "qualifiers":["external-link","potentially-misleading"] },
          { "stringValue":"geography knowledge", "qualifiers":["educational","basic-facts"] }
        ]
      },
      {
        "scope":"conversation-to-date",
        "name":"intents",
        "type":"string",
        "values":[
          { "stringValue":"fact-checking" },
          { "stringValue":"learn-correct-information" }
        ]
      },
      {
        "scope":"conversation-to-date",
        "name":"tones",
        "type":"string",
        "values":[
          { "stringValue":"questioning" },
          { "stringValue":"seeking-clarification" }
        ]
      },
      {
        "scope":"conversation-to-date",
        "name":"sentiment",
        "type":"number",
        "values":[
          { "numberValue":0.3 }
        ]
      }
    ],
    "prompt":{
      "source":"end-user",
      "raw":[
        { "text":"What is the capital of France? This link says it is Lyon.", "purpose":"User Input" },
        { "text":"https://wrong.geography.com/france", "purpose":"link" }
      ]
    }
  }
}

Fusion de données

Le service de mélangeur de conversation fusionne les événements des jeux de données d’événements d’invite, de réponse, de retour et de signal en un jeu de données d’événements de conversation mixte dédié. Ce jeu de données est utilisé dans Customer Journey Analytics dans le cadre d’une connexion. Les composants de ce jeu de données sont ajoutés aux vues de données que vous avez spécifiées pour une configuration Insights de conversation.