REST Resource: projects.locations.brands.sessionRecords

Recurso: SessionRecord

Representa un solo registro de sesión.

Representación JSON
{
  "name": string,
  "sessionStartTime": string,
  "storeId": string,
  "laneId": string,
  "interactions": [
    {
      object (Interaction)
    }
  ],
  "outcomeLabel": string,
  "outcomeGroupLabel": string,
  "audioRecordingPath": string,
  "order": {
    object (Order)
  },
  "sessionDuration": string,
  "upsellAttemptRecords": [
    {
      object (UpsellAttemptRecord)
    }
  ],
  "audioRecording": string,
  "trafficType": enum (TrafficType),
  "channelType": enum (ChannelType)
}
Campos
name

string

Es el identificador. Es el nombre del recurso de SessionRecord. Formato: projects/{project}/locations/{location}/brands/{brand}/sessionRecords/{sessionRecord}

sessionStartTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de inicio de la sesión.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

storeId

string

Inmutable. Es el ID de la tienda en la que se realizó el pedido.

laneId

string

Inmutable. Es el ID de carril de la sesión de pedido.

interactions[]

object (Interaction)

Solo salida. Los turnos de la conversación.

outcomeLabel

string

Solo salida. Es la etiqueta del resultado final del pedido.

outcomeGroupLabel

string

Solo salida. Es la etiqueta del grupo para el resultado.

audioRecordingPath

string

Solo salida. Es la ruta de acceso a la grabación de audio completa.

order

object (Order)

Solo salida. Es el pedido asociado con el registro de la sesión.

sessionDuration

string (Duration format)

Solo salida. Es la duración total de la sesión.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

upsellAttemptRecords[]

object (UpsellAttemptRecord)

Solo salida. Son las ventas adicionales que se realizaron durante la sesión.

audioRecording

string (bytes format)

Solo salida. Grabación de audio de la sesión. Este campo solo se propaga cuando se llama a sessionRecords.get.

Es una cadena codificada en Base64.

trafficType

enum (TrafficType)

Solo salida. Es el tipo de tráfico de la sesión.

channelType

enum (ChannelType)

Solo salida. Es el tipo de canal que se usó para la sesión (p.ej., autoservicio, app para dispositivos móviles o llamada telefónica).

Interacción

Representa una sola interacción en un turno de la conversación.

Representación JSON
{
  "turnPosition": string,

  // Union field interaction can be only one of the following:
  "userUtterance": {
    object (UserUtterance)
  },
  "agentUtterance": {
    object (AgentUtterance)
  },
  "resolveOrder": {
    object (ResolveOrder)
  },
  "submitOrder": {
    object (SubmitOrder)
  },
  "matchIntent": {
    object (MatchIntent)
  },
  "clientExecution": {
    object (ClientExecution)
  },
  "clientOrderUpdate": {
    object (ClientOrderUpdate)
  }
  // End of list of possible types for union field interaction.
}
Campos
turnPosition

string (int64 format)

Solo salida. Turno en la conversación.

Campo de unión interaction. Es el tipo de interacción. interaction puede ser solo uno de los parámetros siguientes:
userUtterance

object (UserUtterance)

Enunciado del usuario.

agentUtterance

object (AgentUtterance)

Expresión del agente.

resolveOrder

object (ResolveOrder)

Llamada a ResolveOrder realizada por el agente

submitOrder

object (SubmitOrder)

Llamada a SubmitOrder realizada por el agente

matchIntent

object (MatchIntent)

Llamada MatchIntent realizada por el agente

clientExecution

object (ClientExecution)

Llamada a ClientExecution realizada por el agente

clientOrderUpdate

object (ClientOrderUpdate)

Actualización del estado del pedido iniciada por el cliente

UserUtterance

Es la expresión del usuario.

Representación JSON
{
  "text": string,
  "createTime": string
}
Campos
text

string

Es el texto de la expresión del usuario.

createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de cuando se produjo la expresión del usuario.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

AgentUtterance

Es la expresión del agente.

Representación JSON
{
  "text": string,
  "createTime": string
}
Campos
text

string

Es el texto de la expresión del agente.

createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de cuando se produjo la expresión del agente.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

ResolveOrder

La interacción de resolución del pedido

Representación JSON
{
  "input": {
    object (ResolveOrderInput)
  },
  "output": {
    object (ResolveOrderOutput)
  }
}
Campos
input

object (ResolveOrderInput)

Es la entrada para la acción de resolución del pedido.

output

object (ResolveOrderOutput)

Es el resultado de la acción de resolver el pedido.

ResolveOrderInput

Es la entrada para la interacción de resolución de pedidos.

Representación JSON
{
  "payload": {
    object
  }
}
Campos
payload

object (Struct format)

Es la carga útil de la interacción para resolver el pedido.

ResolveOrderOutput

Es el resultado de la interacción de resolución del pedido.

Representación JSON
{
  "payload": {
    object
  }
}
Campos
payload

object (Struct format)

Es la carga útil para el resultado de la interacción de resolución del pedido.

SubmitOrder

Este tipo no tiene campos.

La interacción de envío del pedido

MatchIntent

Es la interacción de coincidencia de intents.

Representación JSON
{
  "input": {
    object (MatchIntentInput)
  },
  "output": {
    object (MatchIntentOutput)
  }
}
Campos
input

object (MatchIntentInput)

Es la entrada para la interacción de coincidencia de intents.

output

object (MatchIntentOutput)

Es el resultado de la interacción de coincidencia de intents.

MatchIntentInput

Es la entrada para la interacción de coincidencia de intents.

Representación JSON
{
  "payload": {
    object
  }
}
Campos
payload

object (Struct format)

Es la carga útil de la entrada de interacción de coincidencia de intents.

MatchIntentOutput

Es el resultado de la interacción de coincidencia de intents.

Representación JSON
{
  "payload": {
    object
  }
}
Campos
payload

object (Struct format)

Es la carga útil para el resultado de la interacción de coincidencia de intents.

ClientExecution

La interacción de ejecución del cliente.

Representación JSON
{
  "toolName": string,
  "input": {
    object (ClientExecutionInput)
  },
  "output": {
    object (ClientExecutionOutput)
  }
}
Campos
toolName

string

Es el nombre de la herramienta para la interacción de ejecución del cliente.

input

object (ClientExecutionInput)

Es la entrada para la interacción de ejecución del cliente.

output

object (ClientExecutionOutput)

Es el resultado de la interacción de ejecución del cliente.

ClientExecutionInput

Es la entrada para la interacción de ejecución del cliente.

Representación JSON
{
  "payload": {
    object
  }
}
Campos
payload

object (Struct format)

Es la carga útil de la entrada de interacción de ejecución del cliente.

ClientExecutionOutput

Es el resultado de la interacción de ejecución del cliente.

Representación JSON
{
  "payload": {
    object
  }
}
Campos
payload

object (Struct format)

Es la carga útil para el resultado de la interacción de ejecución del cliente.

ClientOrderUpdate

Actualización del estado del pedido iniciada por el cliente.

Representación JSON
{
  "order": {
    object (Order)
  }
}
Campos
order

object (Order)

Es una actualización del estado del pedido que envía el cliente.

UpsellAttemptRecord

Representa un intento de venta incremental. Estos datos se usan para mostrar información de ventas incrementales en el historial de pedidos de la consola, es decir, el tipo de venta incremental, el ID de turno y si se aceptó la venta incremental, y se propagan desde Spanner en función de los registros procesados.

Representación JSON
{
  "turnId": integer,
  "upsellType": string,
  "accepted": boolean
}
Campos
turnId

integer

Solo salida. Es el ID del turno en el que se produjo la oportunidad de venta incremental.

upsellType

string

Solo salida. Es el tipo de evento de venta incremental.

accepted

boolean

Solo salida. Indica si se aceptó la venta incremental.

TrafficType

Es el tipo de tráfico de la sesión. Se usa para etiquetar las métricas de supervisión, registro y observabilidad.

Enums
TRAFFIC_TYPE_UNSPECIFIED No se especifica el tipo de tráfico.
EXTERNAL El tráfico proviene de un cliente externo.
INTEGRATION_TEST El tráfico proviene de una prueba de integración.
EVAL El tráfico proviene de la herramienta de evaluación.
PROBER El tráfico proviene del sondeador.
MANUAL_TEST El tráfico proviene de pruebas manuales.
INTERNAL_TOOL El tráfico proviene de una herramienta interna.
CONSOLE El tráfico proviene de la consola de IA de alimentos.

Métodos

delete

Borra un SessionRecord.

get

Obtiene un SessionRecord específico.

list

Enumera los SessionRecords de una marca determinada.