REST Resource: projects.locations.brands.sessionRecords

Ressource: SessionRecord

Stellt einen einzelnen Sitzungsdatensatz dar.

JSON-Darstellung
{
  "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)
}
Felder
name

string

ID. Der Ressourcenname des SessionRecord. Format: projects/{project}/locations/{location}/brands/{brand}/sessionRecords/{sessionRecord}

sessionStartTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann die Sitzung begonnen hat.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

storeId

string

Nicht veränderbar. Die ID des Geschäfts, in dem die Bestellung aufgegeben wurde.

laneId

string

Nicht veränderbar. Die Lane-ID der Bestellsitzung.

interactions[]

object (Interaction)

Nur Ausgabe. Die Unterhaltungsrunden.

outcomeLabel

string

Nur Ausgabe. Das Label für das Endergebnis der Bestellung.

outcomeGroupLabel

string

Nur Ausgabe. Das Gruppenlabel für das Ergebnis.

audioRecordingPath

string

Nur Ausgabe. Pfad zur vollständigen Audioaufnahme.

order

object (Order)

Nur Ausgabe. Die Bestellung, die mit dem Sitzungsdatensatz verknüpft ist.

sessionDuration

string (Duration format)

Nur Ausgabe. Gesamtdauer der Sitzung.

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".

upsellAttemptRecords[]

object (UpsellAttemptRecord)

Nur Ausgabe. Upsells, die während der Sitzung durchgeführt wurden.

audioRecording

string (bytes format)

Nur Ausgabe. Audioaufnahme für die Sitzung. Dieses Feld wird nur ausgefüllt, wenn „sessionRecords.get“ aufgerufen wird.

Ein base64-codierter String.

trafficType

enum (TrafficType)

Nur Ausgabe. Der Traffictyp für die Sitzung.

channelType

enum (ChannelType)

Nur Ausgabe. Der für die Sitzung verwendete Channeltyp, z.B. Drive-through, App für Mobilgeräte oder Telefonanruf.

Interaktion

Stellt eine einzelne Interaktion in einer Runde der Unterhaltung dar.

JSON-Darstellung
{
  "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.
}
Felder
turnPosition

string (int64 format)

Nur Ausgabe. Position in der Unterhaltung ändern.

Union-Feld interaction. Der Typ der Interaktion. Für interaction ist nur einer der folgenden Werte zulässig:
userUtterance

object (UserUtterance)

Nutzeräußerung.

agentUtterance

object (AgentUtterance)

Äußerung des Kundenservicemitarbeiters.

resolveOrder

object (ResolveOrder)

Der Agent hat „ResolveOrder“ aufgerufen

submitOrder

object (SubmitOrder)

Vom Agent ausgeführter „SubmitOrder“-Aufruf

matchIntent

object (MatchIntent)

Vom Agent ausgeführter MatchIntent-Aufruf

clientExecution

object (ClientExecution)

Vom Agent ausgeführter ClientExecution-Aufruf

clientOrderUpdate

object (ClientOrderUpdate)

Vom Client ausgelöste Aktualisierung des Bestellstatus

UserUtterance

Die Äußerung des Nutzers.

JSON-Darstellung
{
  "text": string,
  "createTime": string
}
Felder
text

string

Der Text der Nutzeräußerung.

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel für die Äußerung des Nutzers.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

AgentUtterance

Die Äußerung des Agents.

JSON-Darstellung
{
  "text": string,
  "createTime": string
}
Felder
text

string

Der Text der Äußerung des KI-Agenten.

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitstempel, der angibt, wann die Äußerung des Agents erfolgt ist.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

ResolveOrder

Die Interaktion zum Beheben von Bestellungen.

JSON-Darstellung
{
  "input": {
    object (ResolveOrderInput)
  },
  "output": {
    object (ResolveOrderOutput)
  }
}
Felder
input

object (ResolveOrderInput)

Die Eingabe für die Aktion zum Schließen von Bestellungen.

output

object (ResolveOrderOutput)

Die Ausgabe für die Aktion „resolve order“.

ResolveOrderInput

Die Eingabe für die Interaktion zum Beheben von Bestellungen.

JSON-Darstellung
{
  "payload": {
    object
  }
}
Felder
payload

object (Struct format)

Die Nutzlast für die Interaktion zum Schließen der Bestellung.

ResolveOrderOutput

Die Ausgabe für die Interaktion mit der Auflösungsreihenfolge.

JSON-Darstellung
{
  "payload": {
    object
  }
}
Felder
payload

object (Struct format)

Die Nutzlast für die Ausgabe der Interaktion zum Beheben von Bestellungen.

SubmitOrder

Dieser Typ hat keine Felder.

Die Interaktion zum Senden der Bestellung.

MatchIntent

Die Interaktion für den Abgleichs-Intent.

JSON-Darstellung
{
  "input": {
    object (MatchIntentInput)
  },
  "output": {
    object (MatchIntentOutput)
  }
}
Felder
input

object (MatchIntentInput)

Die Eingabe für die Interaktion mit dem Intent „match“.

output

object (MatchIntentOutput)

Die Ausgabe für die Interaktion mit dem Intent „Abgleichen“.

MatchIntentInput

Die Eingabe für die Interaktion mit dem Intent „match“.

JSON-Darstellung
{
  "payload": {
    object
  }
}
Felder
payload

object (Struct format)

Die Nutzlast für die Eingabe der Interaktion mit der Absicht „Abgleich“.

MatchIntentOutput

Die Ausgabe für die Interaktion mit dem Intent „Abgleichen“.

JSON-Darstellung
{
  "payload": {
    object
  }
}
Felder
payload

object (Struct format)

Die Nutzlast für die Ausgabe der Interaktion mit dem Intent „Abgleichen“.

ClientExecution

Die Interaktion bei der Clientausführung.

JSON-Darstellung
{
  "toolName": string,
  "input": {
    object (ClientExecutionInput)
  },
  "output": {
    object (ClientExecutionOutput)
  }
}
Felder
toolName

string

Der Toolname für die Clientausführungsinteraktion.

input

object (ClientExecutionInput)

Die Eingabe für die Interaktion zur Clientausführung.

output

object (ClientExecutionOutput)

Die Ausgabe für die Clientausführung.

ClientExecutionInput

Die Eingabe für die Interaktion zur Clientausführung.

JSON-Darstellung
{
  "payload": {
    object
  }
}
Felder
payload

object (Struct format)

Die Nutzlast für die Eingabe der Clientausführungsinteraktion.

ClientExecutionOutput

Die Ausgabe für die Clientausführung.

JSON-Darstellung
{
  "payload": {
    object
  }
}
Felder
payload

object (Struct format)

Die Nutzlast für die Ausgabe der Clientausführungsinteraktion.

ClientOrderUpdate

Vom Client ausgelöste Aktualisierung des Bestellstatus.

JSON-Darstellung
{
  "order": {
    object (Order)
  }
}
Felder
order

object (Order)

Eine vom Client gesendete Aktualisierung des Bestellstatus.

UpsellAttemptRecord

Stellt einen Upselling-Versuch dar. Diese Daten werden verwendet, um Upsell-Informationen im Bestellverlauf der Console anzuzeigen, nämlich Upsell-Typ, Turn-ID und ob der Upsell akzeptiert wurde. Sie werden aus Spanner basierend auf verarbeiteten Logs abgerufen.

JSON-Darstellung
{
  "turnId": integer,
  "upsellType": string,
  "accepted": boolean
}
Felder
turnId

integer

Nur Ausgabe. ID des Schritts, in dem sich die Upselling-Möglichkeit ergeben hat.

upsellType

string

Nur Ausgabe. Der Typ des Upselling-Ereignisses.

accepted

boolean

Nur Ausgabe. Gibt an, ob das Upselling akzeptiert wurde.

TrafficType

Der Traffictyp für die Sitzung. Damit werden die Messwerte für Monitoring, Logging und Beobachtbarkeit gekennzeichnet.

Enums
TRAFFIC_TYPE_UNSPECIFIED Der Traffictyp ist nicht angegeben.
EXTERNAL Der Traffic stammt von einem externen Client.
INTEGRATION_TEST Der Traffic stammt aus einem Integrationstest.
EVAL Der Traffic stammt aus dem Evaluierungstool.
PROBER Der Traffic stammt vom Prober.
MANUAL_TEST Die Zugriffe stammen aus manuellen Tests.
INTERNAL_TOOL Der Traffic stammt von einem internen Tool.
CONSOLE Der Traffic stammt aus der Food AI-Konsole.

Methoden

delete

Löscht einen SessionRecord.

get

Ruft einen bestimmten SessionRecord ab.

list

Listet SessionRecords für eine bestimmte Marke auf.