REST Resource: projects.locations.brands.sessionRecords

Risorsa: SessionRecord

Rappresenta un singolo record di sessione.

Rappresentazione 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)
}
Campi
name

string

Identificatore. Il nome della risorsa SessionRecord. Formato: projects/{project}/locations/{location}/brands/{brand}/sessionRecords/{sessionRecord}

sessionStartTime

string (Timestamp format)

Solo output. Il timestamp dell'inizio della sessione.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

storeId

string

Immutabile. L'ID del negozio in cui è stato effettuato l'ordine.

laneId

string

Immutabile. L'ID corsia della sessione dell'ordine.

interactions[]

object (Interaction)

Solo output. I turni della conversazione.

outcomeLabel

string

Solo output. L'etichetta del risultato finale dell'ordine.

outcomeGroupLabel

string

Solo output. L'etichetta del gruppo per il risultato.

audioRecordingPath

string

Solo output. Percorso della registrazione audio completa.

order

object (Order)

Solo output. L'ordine associato al record della sessione.

sessionDuration

string (Duration format)

Solo output. Durata totale della sessione.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

upsellAttemptRecords[]

object (UpsellAttemptRecord)

Solo output. Upsell eseguiti durante la sessione.

audioRecording

string (bytes format)

Solo output. Registrazione audio della sessione. Questo campo viene compilato solo quando viene chiamato sessionRecords.get.

Una stringa con codifica in base64.

trafficType

enum (TrafficType)

Solo output. Il tipo di traffico per la sessione.

channelType

enum (ChannelType)

Solo output. Il tipo di canale utilizzato per la sessione (ad es. drive-through, app mobile, chiamata).

Interazione

Rappresenta una singola interazione in un turno della conversazione.

Rappresentazione 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.
}
Campi
turnPosition

string (int64 format)

Solo output. Ruotare la posizione nella conversazione.

Campo unione interaction. Il tipo di interazione. interaction può essere solo uno dei seguenti tipi:
userUtterance

object (UserUtterance)

Utterance dell'utente.

agentUtterance

object (AgentUtterance)

Utterance dell'agente.

resolveOrder

object (ResolveOrder)

Chiamata ResolveOrder eseguita dall'agente

submitOrder

object (SubmitOrder)

Chiamata SubmitOrder eseguita dall'agente

matchIntent

object (MatchIntent)

Chiamata MatchIntent eseguita dall'agente

clientExecution

object (ClientExecution)

Chiamata ClientExecution eseguita dall'agente

clientOrderUpdate

object (ClientOrderUpdate)

Aggiornamento dello stato dell'ordine avviato dal client

UserUtterance

L'espressione dell'utente.

Rappresentazione JSON
{
  "text": string,
  "createTime": string
}
Campi
text

string

Il testo dell'espressione dell'utente.

createTime

string (Timestamp format)

Solo output. Il timestamp in cui si è verificata l'espressione dell'utente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

AgentUtterance

L'utterance dell'agente.

Rappresentazione JSON
{
  "text": string,
  "createTime": string
}
Campi
text

string

Il testo dell'enunciato dell'agente.

createTime

string (Timestamp format)

Solo output. Il timestamp in cui si è verificata l'espressione dell'agente.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

ResolveOrder

L'interazione di risoluzione dell'ordine.

Rappresentazione JSON
{
  "input": {
    object (ResolveOrderInput)
  },
  "output": {
    object (ResolveOrderOutput)
  }
}
Campi
input

object (ResolveOrderInput)

L'input per l'azione di risoluzione dell'ordine.

output

object (ResolveOrderOutput)

L'output per l'azione di risoluzione dell'ordine.

ResolveOrderInput

L'input per l'interazione di risoluzione dell'ordine.

Rappresentazione JSON
{
  "payload": {
    object
  }
}
Campi
payload

object (Struct format)

Il payload per l'interazione di risoluzione dell'ordine.

ResolveOrderOutput

L'output per l'interazione di risoluzione dell'ordine.

Rappresentazione JSON
{
  "payload": {
    object
  }
}
Campi
payload

object (Struct format)

Il payload per l'output dell'interazione di risoluzione dell'ordine.

SubmitOrder

Questo tipo non contiene campi.

L'interazione di invio dell'ordine.

MatchIntent

L'interazione con l'intento di corrispondenza.

Rappresentazione JSON
{
  "input": {
    object (MatchIntentInput)
  },
  "output": {
    object (MatchIntentOutput)
  }
}
Campi
input

object (MatchIntentInput)

L'input per l'interazione di corrispondenza dell'intent.

output

object (MatchIntentOutput)

L'output per l'interazione con l'intent di corrispondenza.

MatchIntentInput

L'input per l'interazione di corrispondenza dell'intent.

Rappresentazione JSON
{
  "payload": {
    object
  }
}
Campi
payload

object (Struct format)

Il payload per l'input dell'interazione dell'intent di corrispondenza.

MatchIntentOutput

L'output per l'interazione con l'intent di corrispondenza.

Rappresentazione JSON
{
  "payload": {
    object
  }
}
Campi
payload

object (Struct format)

Il payload per l'output dell'interazione di corrispondenza dell'intent.

ClientExecution

L'interazione di esecuzione del client.

Rappresentazione JSON
{
  "toolName": string,
  "input": {
    object (ClientExecutionInput)
  },
  "output": {
    object (ClientExecutionOutput)
  }
}
Campi
toolName

string

Il nome dello strumento per l'interazione di esecuzione del client.

input

object (ClientExecutionInput)

L'input per l'interazione di esecuzione client.

output

object (ClientExecutionOutput)

L'output per l'interazione di esecuzione del client.

ClientExecutionInput

L'input per l'interazione di esecuzione client.

Rappresentazione JSON
{
  "payload": {
    object
  }
}
Campi
payload

object (Struct format)

Il payload per l'input dell'interazione di esecuzione client.

ClientExecutionOutput

L'output per l'interazione di esecuzione del client.

Rappresentazione JSON
{
  "payload": {
    object
  }
}
Campi
payload

object (Struct format)

Il payload per l'output dell'interazione di esecuzione client.

ClientOrderUpdate

Aggiornamento dello stato dell'ordine avviato dal client.

Rappresentazione JSON
{
  "order": {
    object (Order)
  }
}
Campi
order

object (Order)

Un aggiornamento dello stato dell'ordine inviato dal cliente.

UpsellAttemptRecord

Rappresenta un tentativo di upsell. Questi dati vengono utilizzati per visualizzare le informazioni sull'upsell nella cronologia ordini della console, ovvero il tipo di upsell, l'ID turno e se l'upsell è stato accettato. Vengono compilati da Spanner in base ai log elaborati.

Rappresentazione JSON
{
  "turnId": integer,
  "upsellType": string,
  "accepted": boolean
}
Campi
turnId

integer

Solo output. ID del turno in cui si è verificata l'opportunità di upselling.

upsellType

string

Solo output. Il tipo di evento di upsell.

accepted

boolean

Solo output. Indica se l'upsell è stato accettato.

TrafficType

Il tipo di traffico per la sessione. Viene utilizzato per etichettare le metriche di monitoraggio, logging e osservabilità.

Enum
TRAFFIC_TYPE_UNSPECIFIED Il tipo di traffico non è specificato.
EXTERNAL Il traffico proviene da un client esterno.
INTEGRATION_TEST Il traffico proviene da un test di integrazione.
EVAL Il traffico proviene dallo strumento di valutazione.
PROBER Il traffico proviene dal probe.
MANUAL_TEST Il traffico proviene dai test manuali.
INTERNAL_TOOL Il traffico proviene da uno strumento interno.
CONSOLE Il traffico proviene dalla console AI per il cibo.

Metodi

delete

Elimina un SessionRecord.

get

Recupera un SessionRecord specifico.

list

Elenca i SessionRecord per un determinato brand.