REST Resource: projects.locations.apps.conversations

Ressource: Unterhaltung

Eine Unterhaltung stellt eine Interaktion zwischen einem Endnutzer und der CES-App dar.

JSON-Darstellung 
{
  "name": string,
  "startTime": string,
  "endTime": string,
  "turns": [
    {
      object (Conversation.Turn)
    }
  ],
  "turnCount": integer,
  "channelType": enum (Conversation.ChannelType),
  "source": enum (Conversation.Source),
  "inputTypes": [
    enum (Conversation.InputType)
  ],
  "entryAgent": string,
  "deployment": string,
  "appVersion": string,
  "languageCode": string,
  "messages": [
    {
      object (Message)
    }
  ]
}
Felder
name

string

ID. Die eindeutige ID der Unterhaltung. Format: projects/{project}/locations/{location}/apps/{app}/conversations/{conversation}
startTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel für die Erstellung der Unterhaltung.

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"
endTime

string (Timestamp format)

Nur Ausgabe. Zeitstempel für den Abschluss der Unterhaltung.

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"
turns[]

object (Conversation.Turn)

Erforderlich. Die Runden in der Unterhaltung.
turnCount

integer

Nur Ausgabe. Die Anzahl der Runden in der Unterhaltung.
channelType
(deprecated)

enum (Conversation.ChannelType)

VERWORFEN. Verwenden Sie stattdessen inputTypes.
source

enum (Conversation.Source)

Nur Ausgabe. Gibt die Quelle der Unterhaltung an.
inputTypes[]

enum (Conversation.InputType)

Nur Ausgabe. Die Eingabetypen der Unterhaltung.
entryAgent

string

Nur Ausgabe. Der Agent, der die Unterhaltung anfänglich bearbeitet. Wenn nicht angegeben, wird die Unterhaltung vom Root-Agent bearbeitet. Format: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
deployment

string

Nur Ausgabe. Die Bereitstellung der App, die zum Verarbeiten der Unterhaltung verwendet wird. Format: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
appVersion

string

Nur Ausgabe. Die Version der App, die zum Verarbeiten der Unterhaltung verwendet wird. Format: projects/{project}/locations/{location}/apps/{app}/versions/{version}
languageCode

string

Nur Ausgabe. Der Sprachcode der Unterhaltung.
messages[]
(deprecated)

object (Message)

Verworfen Verwenden Sie stattdessen Runden.

Conversation.Turn

Alle Informationen zu einer einzelnen Runde in der Unterhaltung.

JSON-Darstellung 
{
  "messages": [
    {
      object (Message)
    }
  ],
  "rootSpan": {
    object (Span)
  },
  "userIntendedText": string
}
Felder
messages[]

object (Message)

Optional. Liste der Nachrichten in der Unterhaltungsrunde, einschließlich Nutzereingaben, Agentantworten und Zwischenereignissen während der Verarbeitung.
rootSpan

object (Span)

Optional. Der Root-Span der Aktionsverarbeitung.
userIntendedText

string

Optional. Der beabsichtigte Ground-Truth-Text des simulierten Anrufers (Polysynth). Wird nur ausgefüllt, wenn Messwerte für die Wortfehlerrate aktiviert sind.

Conversation.ChannelType

Der Kanaltyp der Unterhaltung.

Enums
CHANNEL_TYPE_UNSPECIFIED Nicht angegebener Kanaltyp.
TEXT Die Unterhaltung enthält nur Textnachrichten zwischen dem Endnutzer und dem Agent.
AUDIO Die Unterhaltung enthält Audionachrichten zwischen dem Endnutzer und dem Agent.
MULTIMODAL Die Unterhaltung enthält multimodale Nachrichten (z.B. Bilder) zwischen dem Endnutzer und dem Agent.

Conversation.Source

Die Quelle der Unterhaltung.

Enums
SOURCE_UNSPECIFIED Nicht angegebene Quelle.
LIVE Die Unterhaltung stammt vom Live-Endnutzer.
SIMULATOR Die Unterhaltung stammt vom Simulator.
EVAL Die Unterhaltung stammt aus der Evaluierung.
AGENT_TOOL Die Unterhaltung stammt von einem Agent-Tool. Das Agent-Tool führt den Agent in einer separaten Sitzung aus, die zu Test- und Debuggingzwecken beibehalten wird.

Conversation.InputType

Typ der Eingabenachricht.

Enums
INPUT_TYPE_UNSPECIFIED Nicht angegebener Eingabetyp.
INPUT_TYPE_TEXT Texteingabe.
INPUT_TYPE_EVENT Ereigniseingabe.
INPUT_TYPE_AUDIO Audioeingabe.
INPUT_TYPE_IMAGE Bildeingabe.
INPUT_TYPE_BLOB Blob-Eingabe.
INPUT_TYPE_TOOL_RESPONSE Antworteingabe des Client-Funktionstools.
INPUT_TYPE_VARIABLES Variableneingabe.

Methoden

batchDelete

 Löscht die angegebenen Unterhaltungen im Batch-Modus.

delete

 Löscht die angegebene Unterhaltung.

generateEvaluation

 Erstellt eine Golden-Evaluierung aus einer Unterhaltung.

get

 Ruft Details zur angegebenen Unterhaltung ab.

list

 Listet Unterhaltungen in der angegebenen App auf.