Implementare informazioni sulla conversazione

Per produrre dati di conversazione come eventi esperienza XDM e assicurarti che questi eventi di esperienza di conversazione finiscano in Adobe Experience Platform come set di dati, puoi dotare l’applicazione o il servizio dell’agente di strumenti per utilizzare Informazioni sulla conversazione.

Questo articolo documenta i passaggi di implementazione richiesti.

Schema e set di dati

Configura i set di dati per gli eventi di conversazione principali: prompt, risposta, feedback. I set di dati di prompt, risposta e feedback devono estendere lo schema di base dell’evento esperienza XDM con il gruppo di campi Evento di conversazione e possono facoltativamente includere il gruppo di campi Informazioni agenti e altri gruppi di campi aggiuntivi.

Puoi definire set di dati separati per prompt, risposte e feedback oppure combinare dati in set di dati. Ad esempio, utilizza un set di dati per prompt e risposte e un altro set di dati per il feedback. In alternativa, utilizzare un set di dati separato per ogni tipo di evento di conversazione come illustrato in Funzionamento.

Per illustrare, utilizza:

Il layout del set di dati e la consegna di eventi di conversazione in questi set di dati sono problemi separati. Invia ogni evento di conversazione non appena i dati sono disponibili per garantire la stabilità degli identificatori di conversazione e degli identificatori di svolta. Gli identificatori stabili facilitano la corretta correlazione da parte del servizio Conversation Blender tra set di dati.

Gruppo di campi Evento di conversazione

Il gruppo di campi Evento di conversazione è obbligatorio e utilizza l’oggetto conversation.

L’oggetto di conversazione acquisisce i dati per:

Conversazione

Un conversationID univoco identifica una conversazione. Ad esempio: conversationID = "conv-001". conversationID consente di raggruppare tutti gli eventi di turni correlati nella stessa esperienza di conversazione.

Lo schema supporta anche conversationName. Nome leggibile che descrive il contesto generale della conversazione, ad esempio: France Geography Q&A. Il nome della conversazione viene generato automaticamente, ma puoi aggiornarlo. Il nome della conversazione viene popolato anche in signals[].name. Adobe compila conversationName con lo stesso valore del segnale signals[].name = “title”. È possibile impostare conversation.conversationName su qualsiasi set di dati popolato e sovrascrivere il valore fornito da Adobe.

Turno

Un turno è un ciclo di interazione all’interno di una conversazione.

turnID Un turnID univoco identifica un turno. Ad esempio:

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

Gli stessi conversationID e turnID vengono utilizzati per correlare i prompt, la risposta e il feedback associati a tale turno. Tale correlazione funziona tra record consegnati separatamente o finiti in set di dati diversi. Un elemento turnId deve essere univoco all’interno della stessa conversazione, ma può essere riutilizzato in tutte le conversazioni. Ad esempio, è possibile avere turn-001 come turnID nelle conversazioni con conversationID conv-001 e conv-002.

Prompt

Un prompt è l’input inviato all’agente. Nella maggior parte degli scenari dei clienti, questo input è la domanda, la richiesta, l’istruzione o il messaggio dell’utente.

Il prompt utilizza la seguente rappresentazione: conversation.prompt

I campi di richiesta importanti includono:

Un prompt può contenere più segmenti non elaborati. Ad esempio, un utente immette del testo e include un URL.

Risposta

Una risposta è il contenuto restituito dall’agente o da un’altra parte rispondente.

conversation.response Un responseID univoco rappresenta la risposta.

I campi di risposta importanti includono:

I tipi di origine documentati includono:

Feedback

Il feedback è l’esplicita valutazione o reazione dell’utente all’interazione.

La struttura del feedback include: conversation.feedback.

Esempi:

L’intervallo di punteggio di valutazione documentato è compreso tra -1.0 e 1.0.

Un evento di feedback può essere rappresentato come evento di solo feedback utilizzando: eventType = "conversation.feedback".

Quando il feedback si applica a un particolare turno, conserva i conversationID e turnID appropriati in modo che il frullatore di conversazione possa associare il feedback all’interazione rilevante.

Segnale

Un segnale è un’osservazione analitica strutturata sul contenuto di una conversazione. Il servizio Estrazione segnale fornisce segnali predefiniti. Non è richiesta alcuna azione per fornire i segnali, ma puoi aggiungere segnali come parte dell’integrazione.

Un segnale ha i seguenti campi.

Il servizio di estrazione del segnale popola l’oggetto signals per il set di dati dei segnali.

Il contenitore signals[].attributes.{subjects,intents,tones,sentiment} precedente è obsoleto.

Tipo di Source

È necessario impostare un valore per source per ogni oggetto prompt, response o feedback in un evento. Qualsiasi valore è accettabile. Utilizza valori che ti aiutano a capire da dove provengono i dati. Ad esempio:

Tipo di scopo (testo non elaborato)

È necessario impostare un valore per l’attributo purpose su qualsiasi elemento dell’oggetto raw in un oggetto prompt, response o feedback. Qualsiasi valore stringa è accettabile. Questo campo viene utilizzato per differenziare ciò che è memorizzato nel testo non elaborato. Di seguito sono riportati i valori utili, mentre altri valori sono ugualmente validi:

Conversazione

Per informazioni complete su un oggetto di conversazione, vedere di seguito.

Gruppo di campi Informazioni agente

Il gruppo di campi Informazioni sull’agente è facoltativo e utilizza l’oggetto agenticExperience. Valuta l’utilizzo di questo gruppo di campi per tenere traccia delle informazioni sugli agenti.

Per implementare gli eventi che propagano il gruppo di campi Informazioni agente con i dati, è necessario assicurarsi che:

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

Gruppi di campi aggiuntivi

Puoi aggiungere gruppi di campi facoltativi allo schema utilizzato per i set di dati di prompt, risposta e feedback. Ad esempio:

Il cliente è responsabile della produzione degli eventi di conversazione sorgente. Adobe esegue l’estrazione del segnale e la fusione dei dati. Il cliente non ha bisogno di implementare i servizi di estrazione del segnale o di miscelazione.

Tipo di evento

È necessario impostare uno dei seguenti valori per eventType (stringa) per ogni evento di conversazione:

Esempio

Di seguito è riportato un esempio di utilizzo del gruppo di campi Evento di conversazione in vari scenari.

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

Raccolta dati

Utilizza la seguente strategia di raccolta dati per Informazioni su conversazioni.

Tipi di evento

L’applicazione o il servizio agente invia un evento il prima possibile. Assicurati che l’app o il servizio non attenda una risposta prima di inviare il messaggio con le informazioni disponibili al momento dell’evento.

Questa raccomandazione implica che:

Correlazione degli eventi

L’applicazione o il servizio agente deve conservare identificatori stabili in tutti gli eventi correlati.

L’applicazione o il servizio agente genera ID che rimangono stabili durante i nuovi tentativi o la riconsegna. Questo consente all’elaborazione a valle di associare correttamente gli eventi ed evitare duplicati non intenzionali.

Estrazione del segnale

L’estrazione del segnale avviene dopo la raccolta dei dati. L’applicazione o il servizio agente può compilare segnali aggiuntivi.

Nome segnale

Impostare un valore per signals[].name. Qualsiasi valore stringa è accettabile; tuttavia, Adobe compila i seguenti nomi durante il processo di estrazione del segnale. Evitare di utilizzare questi valori per name per i segnali inviati, poiché questi valori verranno sovrascritti.

Ambito segnale

Qualsiasi valore stringa è accettabile; tuttavia, Adobe compila i seguenti ambiti durante il processo di estrazione del segnale. Evitare di utilizzare questi valori per scope per i segnali inviati, poiché questi valori verranno sovrascritti.

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

Fusione dei dati

Il servizio di fusione delle conversazioni unisce gli eventi dai set di dati di prompt, risposta, feedback e eventi di segnale in un set di dati di eventi di conversazione misti dedicato. Tale set di dati viene utilizzato in Customer Journey Analytics come parte di una connessione. I componenti all’interno di tale set di dati vengono aggiunti alle visualizzazioni dati specificate per una configurazione di Informazioni sulla conversazione.