REST Resource: projects.locations.brands.sessionRecords

Ressource : SessionRecord

Représente un enregistrement de session unique.

Représentation 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)
}
Champs
name

string

Identifiant. Nom de ressource de SessionRecord. Format : projects/{project}/locations/{location}/brands/{brand}/sessionRecords/{sessionRecord}

sessionStartTime

string (Timestamp format)

Uniquement en sortie. Code temporel du début de la session.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

storeId

string

Immuable. ID du magasin où la commande a été passée.

laneId

string

Immuable. ID de la voie de la session de commande.

interactions[]

object (Interaction)

Uniquement en sortie. Tours de conversation.

outcomeLabel

string

Uniquement en sortie. Libellé du résultat final de la commande.

outcomeGroupLabel

string

Uniquement en sortie. Libellé du groupe pour le résultat.

audioRecordingPath

string

Uniquement en sortie. Chemin d'accès à l'enregistrement audio complet.

order

object (Order)

Uniquement en sortie. Commande associée à l'enregistrement de la session.

sessionDuration

string (Duration format)

Uniquement en sortie. Durée totale de la session.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

upsellAttemptRecords[]

object (UpsellAttemptRecord)

Uniquement en sortie. Ventes incitatives effectuées au cours de la session.

audioRecording

string (bytes format)

Uniquement en sortie. Enregistrement audio de la session. Ce champ n'est renseigné que lors de l'appel à sessionRecords.get.

Chaîne encodée en base64.

trafficType

enum (TrafficType)

Uniquement en sortie. Type de trafic pour la session.

channelType

enum (ChannelType)

Uniquement en sortie. Type de canal utilisé pour la session (par exemple, drive-in, application mobile, appel téléphonique).

Interaction

Représente une interaction unique dans un tour de conversation.

Représentation 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.
}
Champs
turnPosition

string (int64 format)

Uniquement en sortie. Tournez-vous vers la personne qui parle.

Champ d'union interaction. Type d'interaction. interaction ne peut être qu'un des éléments suivants :
userUtterance

object (UserUtterance)

Énoncé de l'utilisateur.

agentUtterance

object (AgentUtterance)

Énoncé de l'agent.

resolveOrder

object (ResolveOrder)

Appel ResolveOrder effectué par l'agent

submitOrder

object (SubmitOrder)

Appel SubmitOrder effectué par l'agent

matchIntent

object (MatchIntent)

Appel MatchIntent effectué par l'agent

clientExecution

object (ClientExecution)

Appel ClientExecution effectué par l'agent

clientOrderUpdate

object (ClientOrderUpdate)

Mise à jour de l'état de la commande initiée par le client

UserUtterance

Énoncé de l'utilisateur.

Représentation JSON
{
  "text": string,
  "createTime": string
}
Champs
text

string

Texte de l'énoncé de l'utilisateur.

createTime

string (Timestamp format)

Uniquement en sortie. Code temporel de l'énoncé de l'utilisateur.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

AgentUtterance

Énoncé de l'agent.

Représentation JSON
{
  "text": string,
  "createTime": string
}
Champs
text

string

Texte de l'énoncé de l'agent.

createTime

string (Timestamp format)

Uniquement en sortie. Code temporel de l'énoncé de l'agent.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

ResolveOrder

Interaction de résolution de la commande.

Représentation JSON
{
  "input": {
    object (ResolveOrderInput)
  },
  "output": {
    object (ResolveOrderOutput)
  }
}
Champs
input

object (ResolveOrderInput)

Entrée pour l'action de résolution de la commande.

output

object (ResolveOrderOutput)

Sortie de l'action de résolution de la commande.

ResolveOrderInput

Entrée pour l'interaction de résolution de la commande.

Représentation JSON
{
  "payload": {
    object
  }
}
Champs
payload

object (Struct format)

Charge utile de l'interaction de résolution de la commande.

ResolveOrderOutput

Résultat de l'interaction de résolution de la commande.

Représentation JSON
{
  "payload": {
    object
  }
}
Champs
payload

object (Struct format)

Charge utile de la sortie de l'interaction de résolution de la commande.

SubmitOrder

Ce type ne comporte aucun champ.

Interaction d'envoi de la commande.

MatchIntent

Interaction d'intent correspondant.

Représentation JSON
{
  "input": {
    object (MatchIntentInput)
  },
  "output": {
    object (MatchIntentOutput)
  }
}
Champs
input

object (MatchIntentInput)

Entrée pour l'interaction d'intent de correspondance.

output

object (MatchIntentOutput)

Résultat de l'interaction d'intent de correspondance.

MatchIntentInput

Entrée pour l'interaction d'intent de correspondance.

Représentation JSON
{
  "payload": {
    object
  }
}
Champs
payload

object (Struct format)

Charge utile pour l'entrée d'interaction d'intent de correspondance.

MatchIntentOutput

Résultat de l'interaction d'intent de correspondance.

Représentation JSON
{
  "payload": {
    object
  }
}
Champs
payload

object (Struct format)

Charge utile de la sortie d'interaction de l'intent de correspondance.

ClientExecution

Interaction d'exécution du client.

Représentation JSON
{
  "toolName": string,
  "input": {
    object (ClientExecutionInput)
  },
  "output": {
    object (ClientExecutionOutput)
  }
}
Champs
toolName

string

Nom de l'outil pour l'interaction d'exécution du client.

input

object (ClientExecutionInput)

Entrée pour l'interaction d'exécution côté client.

output

object (ClientExecutionOutput)

Sortie de l'interaction d'exécution du client.

ClientExecutionInput

Entrée pour l'interaction d'exécution côté client.

Représentation JSON
{
  "payload": {
    object
  }
}
Champs
payload

object (Struct format)

Charge utile pour l'entrée d'interaction d'exécution côté client.

ClientExecutionOutput

Sortie de l'interaction d'exécution du client.

Représentation JSON
{
  "payload": {
    object
  }
}
Champs
payload

object (Struct format)

Charge utile de la sortie d'interaction d'exécution côté client.

ClientOrderUpdate

Mise à jour de l'état de la commande initiée par le client.

Représentation JSON
{
  "order": {
    object (Order)
  }
}
Champs
order

object (Order)

Mise à jour de l'état d'une commande envoyée par le client.

UpsellAttemptRecord

Représente une tentative de vente incitative. Ces données sont utilisées pour afficher des informations sur les ventes incitatives dans l'historique des commandes de la console, à savoir le type de vente incitative, l'ID de tour et si la vente incitative a été acceptée. Elles sont extraites de Spanner en fonction des journaux traités.

Représentation JSON
{
  "turnId": integer,
  "upsellType": string,
  "accepted": boolean
}
Champs
turnId

integer

Uniquement en sortie. ID du tour au cours duquel l'opportunité de vente incitative s'est produite.

upsellType

string

Uniquement en sortie. Type d'événement de vente incitative.

accepted

boolean

Uniquement en sortie. Indique si la vente incitative a été acceptée.

TrafficType

Type de trafic pour la session. Il est utilisé pour étiqueter les métriques de surveillance, de journalisation et d'observabilité.

Enums
TRAFFIC_TYPE_UNSPECIFIED Le type de trafic n'est pas spécifié.
EXTERNAL Le trafic provient d'un client externe.
INTEGRATION_TEST Le trafic provient d'un test d'intégration.
EVAL Le trafic provient de l'outil d'évaluation.
PROBER Le trafic provient du vérificateur.
MANUAL_TEST Le trafic provient de tests manuels.
INTERNAL_TOOL Le trafic provient d'un outil interne.
CONSOLE Le trafic provient de la console Food AI.

Méthodes

delete

Supprime un SessionRecord.

get

Récupère un SessionRecord spécifique.

list

Liste les SessionRecords pour une marque donnée.