- Recurso: SessionRecord
- Interacción
- UserUtterance
- AgentUtterance
- ResolveOrder
- ResolveOrderInput
- ResolveOrderOutput
- SubmitOrder
- MatchIntent
- MatchIntentInput
- MatchIntentOutput
- ClientExecution
- ClientExecutionInput
- ClientExecutionOutput
- ClientOrderUpdate
- UpsellAttemptRecord
- TrafficType
- Métodos
Recurso: SessionRecord
Representa un solo registro de sesión.
| Representación JSON |
|---|
{ "name": string, "sessionStartTime": string, "storeId": string, "laneId": string, "interactions": [ { object ( |
| Campos | |
|---|---|
name |
Es el identificador. Es el nombre del recurso de SessionRecord. Formato: projects/{project}/locations/{location}/brands/{brand}/sessionRecords/{sessionRecord} |
sessionStartTime |
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: |
storeId |
Inmutable. Es el ID de la tienda en la que se realizó el pedido. |
laneId |
Inmutable. Es el ID de carril de la sesión de pedido. |
interactions[] |
Solo salida. Los turnos de la conversación. |
outcomeLabel |
Solo salida. Es la etiqueta del resultado final del pedido. |
outcomeGroupLabel |
Solo salida. Es la etiqueta del grupo para el resultado. |
audioRecordingPath |
Solo salida. Es la ruta de acceso a la grabación de audio completa. |
order |
Solo salida. Es el pedido asociado con el registro de la sesión. |
sessionDuration |
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 “ |
upsellAttemptRecords[] |
Solo salida. Son las ventas adicionales que se realizaron durante la sesión. |
audioRecording |
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 |
Solo salida. Es el tipo de tráfico de la sesión. |
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 |
| Campos | |
|---|---|
turnPosition |
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 |
Enunciado del usuario. |
agentUtterance |
Expresión del agente. |
resolveOrder |
Llamada a ResolveOrder realizada por el agente |
submitOrder |
Llamada a SubmitOrder realizada por el agente |
matchIntent |
Llamada MatchIntent realizada por el agente |
clientExecution |
Llamada a ClientExecution realizada por el agente |
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 |
Es el texto de la expresión del usuario. |
createTime |
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: |
AgentUtterance
Es la expresión del agente.
| Representación JSON |
|---|
{ "text": string, "createTime": string } |
| Campos | |
|---|---|
text |
Es el texto de la expresión del agente. |
createTime |
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: |
ResolveOrder
La interacción de resolución del pedido
| Representación JSON |
|---|
{ "input": { object ( |
| Campos | |
|---|---|
input |
Es la entrada para la acción de resolución del pedido. |
output |
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 |
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 |
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 ( |
| Campos | |
|---|---|
input |
Es la entrada para la interacción de coincidencia de intents. |
output |
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 |
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 |
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 ( |
| Campos | |
|---|---|
toolName |
Es el nombre de la herramienta para la interacción de ejecución del cliente. |
input |
Es la entrada para la interacción de ejecución del cliente. |
output |
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 |
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 |
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 ( |
| Campos | |
|---|---|
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 |
Solo salida. Es el ID del turno en el que se produjo la oportunidad de venta incremental. |
upsellType |
Solo salida. Es el tipo de evento de venta incremental. |
accepted |
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 |
|
|---|---|
|
Borra un SessionRecord. |
|
Obtiene un SessionRecord específico. |
|
Enumera los SessionRecords de una marca determinada. |