Implementar Perspectivas de conversación

Para producir datos de conversación como eventos de experiencia XDM y asegurarse de que estos eventos de experiencia de conversación terminen en Adobe Experience Platform como conjuntos de datos, instrumente la aplicación o el servicio del agente para utilizar Perspectivas de conversación.

Este artículo documenta los pasos de implementación necesarios.

Esquema y conjuntos de datos

Configure conjuntos de datos para los eventos de conversación principales: solicitud, respuesta, comentarios. Los conjuntos de datos de solicitud, respuesta y comentarios deben ampliar el esquema base de XDM Experience Event con el grupo de campos Evento de conversación y, opcionalmente, pueden incluir el grupo de campos Información de agente y otros grupos de campos adicionales.

Puede definir conjuntos de datos independientes para preguntas, respuestas y comentarios, o bien combinar datos en conjuntos de datos. Por ejemplo, utilice un conjunto de datos para preguntas y respuestas y otro conjunto de datos para comentarios. O use un conjunto de datos distinto para cada tipo de evento de conversación como se muestra en Cómo funciona.

Para ilustrar, utilice:

El diseño del conjunto de datos y el envío de eventos de conversación a estos conjuntos de datos son preocupaciones independientes. Envíe cada evento de conversación tan pronto como los datos estén disponibles para garantizar identificadores de conversación estables y identificadores de giro. Los identificadores estables facilitan la correlación adecuada mediante el servicio de mezclador de conversaciones entre conjuntos de datos.

Grupo de campos Evento de conversación

El grupo de campos Evento de conversación es un grupo de campos obligatorio y usa el objeto conversation.

El objeto de conversación captura datos para:

Conversación

Un(a) conversationID único(a) identifica una conversación. Por ejemplo: conversationID = "conv-001". conversationID permite que todos los eventos de turnos relacionados se agrupen en la misma experiencia de conversación.

El esquema también admite conversationName. Un nombre legible en lenguaje natural que describe el contexto general de la conversación, como: France Geography Q&A. El nombre de la conversación se genera automáticamente, pero puede actualizar el nombre generado. El nombre de la conversación también se rellena en signals[].name. Adobe rellena conversationName con el mismo valor que la señal signals[].name = “title”. Puede establecer conversation.conversationName en cualquier conjunto de datos que rellene y sobrescribir el valor proporcionado por Adobe.

Turno

Un giro es un ciclo de interacción dentro de una conversación.

turnID Un(a) turnID único(a) identifica un turno. Por ejemplo:

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

Se usan los mismos conversationID y turnID para correlacionar el aviso, la respuesta y los comentarios asociados con ese turno. Esa correlación funciona en registros que se entregan por separado o que terminan en diferentes conjuntos de datos. Un(a) turnId solamente necesita ser único(a) dentro de la misma conversación, pero puede reutilizarse en todas las conversaciones. Por ejemplo, puede tener tanto turn-001 como turnID en conversaciones con conversationID conv-001 y conv-002.

Preguntar

Una solicitud es la entrada enviada al agente. En la mayoría de los casos de clientes, esta entrada es la pregunta, la solicitud, la instrucción o el mensaje del usuario.

La solicitud utiliza la siguiente representación: conversation.prompt

Los campos de solicitud importantes incluyen:

Una solicitud puede contener varios segmentos sin procesar. Por ejemplo, un usuario introduce texto e incluye una dirección URL.

Respuesta

Una respuesta es el contenido devuelto por el agente u otra parte encuestada.

conversation.response Un(a) responseID único representa la respuesta.

Los campos de respuesta importantes incluyen:

Los tipos de fuentes documentados incluyen:

Comentarios

Los comentarios son la evaluación explícita o la reacción del usuario a la interacción.

La estructura de comentarios incluye: conversation.feedback.

Ejemplos:

El rango de puntuación de clasificación documentado es de -1.0 a 1.0.

Un evento de comentarios puede representarse como un evento de solo comentarios mediante: eventType = "conversation.feedback".

Cuando los comentarios se apliquen a un turno en particular, conserva los conversationID y turnID adecuados para que el mezclador de conversaciones pueda asociar los comentarios con la interacción relevante.

Señal

Una señal es una observación analítica estructurada acerca del contenido de una conversación. El servicio de extracción de señales proporciona señales predeterminadas. No se requiere ninguna acción para proporcionar señales, pero puede agregarlas como parte de la integración.

Una señal tiene los siguientes campos.

El servicio de extracción de señales rellena el objeto signals para el conjunto de datos de señales.

El contenedor signals[].attributes.{subjects,intents,tones,sentiment} anterior está obsoleto.

Tipo de Source

Debe establecer un valor para source para cada objeto prompt, response o feedback de un evento. Cualquier valor es aceptable. Utilice valores que le ayuden a comprender desde dónde se originan los datos. Por ejemplo:

Tipo de propósito (texto sin procesar)

Debe establecer un valor para el atributo purpose en cualquier elemento del objeto raw en un objeto prompt, response o feedback. Cualquier valor de cadena es aceptable. Este campo se utiliza para diferenciar lo que se almacena en el texto sin procesar. Los valores útiles están por debajo, otros valores son igualmente válidos:

Conversación

Consulte a continuación todos los detalles de un objeto de conversación.

Grupo de campos Información de agente

El grupo de campos Información de agente es un grupo de campos opcional y utiliza el objeto agenticExperience. Considere utilizar este grupo de campos si desea rastrear información auténtica.

Para implementar eventos que propaguen el grupo de campos Información de agente con datos, debe asegurarse de lo siguiente:

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

Grupos de campo adicionales

Puede agregar grupos de campos opcionales al esquema que utiliza para los conjuntos de datos de solicitud, respuesta y comentarios. Por ejemplo:

El cliente es responsable de producir los eventos de conversación de origen. Adobe realiza la extracción de señales y la mezcla de datos. El cliente no necesita implementar los servicios de extracción o fusión de señales.

Tipo de evento

Debe establecer uno de los siguientes valores para eventType (cadena) para cada evento de conversación:

Ejemplo

Consulte a continuación un ejemplo de uso del grupo de campos Evento de conversación en varios escenarios.

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

Recopilación de datos

Utilice la siguiente estrategia de recopilación de datos para las Perspectivas de conversación.

Tipos de eventos

El servicio o la aplicación del agente envía un evento lo antes posible. Asegúrese de que la aplicación o el servicio no espere una respuesta antes de enviar el mensaje con la información disponible en el momento del evento.

Esta recomendación implica que:

Correlación de eventos

La aplicación o el servicio del agente debe conservar los identificadores estables en todos los eventos relacionados.

La aplicación o el servicio del agente genera ID que permanecen estables durante los reintentos o la reentrega. Esto permite que el procesamiento descendente asocie correctamente los eventos y evite los eventos duplicados no deseados.

Extracción de señal

La extracción de señales se produce después de la recopilación de datos. La aplicación o el servicio del agente puede rellenar señales adicionales.

Nombre de señal

Debe establecer un valor para signals[].name. Cualquier valor de cadena es aceptable; sin embargo, Adobe rellena los siguientes nombres durante el proceso de extracción de señales. Evite utilizar estos valores para name para cualquier señal que envíe, ya que estos valores se sobrescribirán.

Ámbito de señal

Cualquier valor de cadena es aceptable; sin embargo, Adobe rellena los siguientes ámbitos durante el proceso de extracción de señales. Evite utilizar estos valores para scope para cualquier señal que envíe, ya que estos valores se sobrescribirán.

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

Combinación de datos

El servicio de mezcla de conversaciones combina eventos de conjuntos de datos de mensajes, respuestas, comentarios y eventos de señal en un conjunto de datos de eventos de conversación combinados dedicado. Ese conjunto de datos se utiliza en Customer Journey Analytics como parte de una conexión. Los componentes de ese conjunto de datos se agregan a las vistas de datos especificadas para una configuración de Perspectivas de conversación.