Implementieren von Conversation Insights

Um Unterhaltungsdaten als XDM-Erlebnisereignisse zu generieren und sicherzustellen, dass diese Unterhaltungserlebnisereignisse als Datensätze in Adobe Experience Platform landen, instrumentieren Sie Ihre Agenten-Anwendung oder Ihren Service, um Konversationserkenntnisse zu verwenden.

Dieser Artikel dokumentiert die erforderlichen Implementierungsschritte.

Schema und Datensätze

Konfigurieren Sie Datensätze für die primären Konversationsereignisse: Aufforderung, Antwort, Feedback. Die Eingabeaufforderungen-, Antwort- und Feedback-Datensätze müssen das XDM-Erlebnisereignis-Basisschema mit der Konversationsereignis-Feldergruppe erweitern und können optional die Agenteninformations-Feldergruppe und andere zusätzliche Feldergruppen enthalten.

Sie können separate Datensätze für Eingabeaufforderungen, Antworten und Feedback definieren oder Daten zu Datensätzen kombinieren. Verwenden Sie beispielsweise einen Datensatz für Eingabeaufforderungen und Antworten und einen anderen Datensatz für Feedback. Oder verwenden Sie einen separaten Datensatz für jeden Konversationsereignistyp, wie in Funktionsweise dargestellt.

Verwenden Sie zur Veranschaulichung Folgendes:

Das Datensatzlayout und die Bereitstellung von Konversationsereignissen in diesen Datensätzen sind separate Anliegen. Senden Sie jedes Konversationsereignis, sobald Daten verfügbar sind, um stabile Konversationsidentifikatoren und Turnidentifikatoren sicherzustellen. Stabile Kennungen ermöglichen eine ordnungsgemäße Korrelation durch den Conversation Blender-Service über Datensätze hinweg.

Feldergruppe „Konversationsereignis“

Die Konversationsereignis-Feldergruppe ist eine erforderliche Feldergruppe und verwendet das conversation.

Das Konversationsobjekt erfasst Daten für:

Konversation

Eine eindeutige conversationID identifiziert eine Konversation. Beispiel: conversationID = "conv-001". Die conversationID ermöglicht es, alle verwandten Turns-Ereignisse in demselben Konversationserlebnis zu gruppieren.

Das Schema unterstützt auch conversationName. Ein für Menschen lesbarer Name, der den Gesamtkontext der Konversation beschreibt, z. B.: France Geography Q&A. Der Name der Konversation wird automatisch generiert, Sie können den generierten Namen jedoch aktualisieren. Der Name der Konversation wird auch mit signals[].name ausgefüllt. Adobe füllt die conversationName mit demselben Wert wie das Signal signals[].name = „title“. Sie können die conversation.conversationName für jeden Datensatz festlegen, den Sie ausfüllen, und den von Adobe bereitgestellten Wert überschreiben.

abbiegen

Ein Zug ist ein Interaktionszyklus innerhalb eines Gesprächs.

turnID Eine eindeutige turnID identifiziert eine Wendung. Beispiel:

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

Dieselben conversationID und turnID werden verwendet, um die Eingabeaufforderung, die Antwort und das Feedback zu korrelieren, die mit diesem Zug verbunden sind. Diese Korrelation funktioniert über Datensätze hinweg, die separat bereitgestellt werden oder in verschiedenen Datensätzen enden. Eine turnId muss nur innerhalb derselben Konversation eindeutig sein, kann jedoch in allen Konversationen wiederverwendet werden. Beispielsweise können Sie beide turn-001 als turnID in Gesprächen mit conversationID conv-001 und conv-002 haben.

Eingabeaufforderung

Eine Eingabeaufforderung ist die Eingabe, die an den Agenten gesendet wird. In den meisten Kundenszenarien ist diese Eingabe die Frage, Anfrage, Anweisung oder Nachricht des Benutzers.

In der Eingabeaufforderung wird die folgende Darstellung verwendet: conversation.prompt

Wichtige Eingabeaufforderungsfelder sind:

Eine Eingabeaufforderung kann mehrere Rohsegmente enthalten. Beispiel: Ein Benutzer gibt Text ein und fügt eine URL hinzu.

Antwort

Eine Antwort ist der Inhalt, der vom Agenten oder einer anderen antwortenden Partei zurückgegeben wird.

conversation.response Ein eindeutiges responseID stellt die Antwort dar.

Wichtige Antwortfelder sind:

Zu den dokumentierten Quelltypen gehören:

Feedback

Feedback ist die explizite Bewertung oder Reaktion des Benutzers auf die Interaktion.

Die Feedback-Struktur umfasst: conversation.feedback.

Beispiele:

Der dokumentierte Bewertungsbereich reicht von -1.0 bis 1.0.

Ein Feedback-Ereignis kann als reines Feedback-Ereignis dargestellt werden, indem Folgendes verwendet wird: eventType = "conversation.feedback".

Wenn das Feedback für eine bestimmte Drehung gilt, bewahren Sie die entsprechenden conversationID und turnID auf, damit der Konversationsmischer das Feedback mit der relevanten Interaktion verknüpfen kann.

Signal

Ein Signal ist eine strukturierte analytische Beobachtung über Konversationsinhalte. Der Signalextraktionsdienst stellt vorkonfigurierte Signale bereit. Es ist keine Aktion erforderlich, um Signale bereitzustellen. Sie können jedoch Signale als Teil der Integration hinzufügen.

Ein Signal weist die folgenden Felder auf.

Der Signalextraktions-Service füllt das signals für den Signaldatensatz.

Der vorherige signals[].attributes.{subjects,intents,tones,sentiment}-Container wird nicht mehr unterstützt.

Typ der Quelle

Sie müssen einen Wert für source für jedes prompt, response oder feedback Objekt in einem Ereignis festlegen. Jeder Wert ist zulässig. Verwenden Sie Werte, die Ihnen dabei helfen zu verstehen, woher Daten stammen. Beispiel:

Art des Zwecks (Rohtext)

Sie müssen einen Wert für das purpose-Attribut für ein beliebiges Element des raw-Objekts in einem prompt-, response- oder feedback-Objekt festlegen. Jeder Zeichenfolgenwert ist zulässig. In diesem Feld wird unterschieden, was im Rohtext gespeichert wird. Die nützlichen Werte sind unten aufgeführt, andere Werte sind gleichermaßen gültig:

Konversation

Unten finden Sie die vollständigen Details eines Konversationsobjekts.

Agent-Informationsfeldgruppe

Die Feldergruppe Agenteninformationen ist eine optionale Feldergruppe und verwendet das agenticExperience. Erwägen Sie die Verwendung dieser Feldergruppe, wenn Sie agentische Informationen verfolgen möchten.

Um Ereignisse zu implementieren, die die Feldgruppe Agenteninformationen mit Daten weitergeben, sollten Sie Folgendes sicherstellen:

{
  "_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" }
        ]
      }
    ]
  }
}

Zusätzliche Feldergruppen

Sie können dem Schema, das Sie für Eingabeaufforderungen, Antworten und Feedback-Datensätze verwenden, optionale Feldergruppen hinzufügen. Beispiel:

Der Kunde ist für die Erstellung der Quell-Konversationsereignisse verantwortlich. Adobe führt eine Signalextraktion und Datenmischung durch. Der Kunde muss die Signalextraktions- oder Mischdienste nicht implementieren.

Ereignistyp

Für jedes Konversationsereignis müssen Sie einen der folgenden Werte für eventType (Zeichenfolge) festlegen:

Beispiel

Unten finden Sie ein Beispiel für die Verwendung der Feldergruppe „Konversationsereignis“ in verschiedenen Szenarien.

{
  "_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" }
  ]
}

Datenerfassung

Verwenden Sie die folgende Datenerfassungsstrategie für Konversationseinblicke.

Ereignistypen

Ihr Agent-Programm oder Service sendet ein Ereignis so bald wie möglich. Stellen Sie sicher, dass die App oder der Service nicht auf eine Antwort wartet, bevor die Eingabeaufforderung mit den zum Zeitpunkt des Ereignisses verfügbaren Informationen an gesendet wird.

Diese Empfehlung impliziert Folgendes:

Ereigniskorrelation

Die Agentenanwendung oder der Service muss stabile Kennungen für alle zugehörigen Ereignisse beibehalten.

Die Agentanwendung oder der Service generiert IDs, die bei weiteren Zustellversuchen oder erneuten Sendungen stabil bleiben. Dies ermöglicht die nachgelagerte Verarbeitung, um Ereignisse korrekt zu verknüpfen und unbeabsichtigte doppelte Ereignisse zu vermeiden.

Signalextraktion

Die Signalextraktion erfolgt nach der Datenerfassung. Ihre Agentanwendung oder Ihr Service kann zusätzliche Signale ausfüllen.

Signalname

Sie müssen einen Wert für signals[].name festlegen. Jeder Zeichenfolgenwert ist akzeptabel. Adobe füllt jedoch die folgenden Namen während des Signalextraktionsprozesses. Vermeiden Sie diese Werte für die name für alle Signale, die Sie senden, da diese Werte überschrieben werden.

Signalumfang

Jeder Zeichenfolgenwert ist akzeptabel. Adobe füllt jedoch während des Signalextraktionsprozesses die folgenden Bereiche. Vermeiden Sie diese Werte für die scope für alle Signale, die Sie senden, da diese Werte überschrieben werden.

{
  "_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" }
      ]
    }
  }
}

Datenmischung

Der Conversation Blender-Service führt Ereignisse aus Eingabeaufforderungs-, Antwort-, Feedback- und Signalereignis-Datensätzen in einem dedizierten Blended Conversation-Ereignisdatensatz zusammen. Dieser Datensatz wird in Customer Journey Analytics als Teil einer Verbindung verwendet. Die Komponenten in diesem Datensatz werden zu den Datenansichten hinzugefügt, die Sie für eine Conversation Insights-Konfiguration angegeben haben.