REST Resource: projects.locations.apps.conversations

Risorsa: Conversation

Una conversazione rappresenta un'interazione tra un utente finale e l'app CES.

Rappresentazione JSON 
{
  "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)
    }
  ]
}
Campi
name

string

Identificatore. L'identificatore univoco della conversazione. Formato: projects/{project}/locations/{location}/apps/{app}/conversations/{conversation}
startTime

string (Timestamp format)

Solo output. Timestamp di creazione della conversazione.

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

string (Timestamp format)

Solo output. Timestamp di completamento della conversazione.

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

object (Conversation.Turn)

Obbligatorio. I turni della conversazione.
turnCount

integer

Solo output. Il numero di turni nella conversazione.
channelType
(deprecated)

enum (Conversation.ChannelType)

OBSOLETO. Utilizza invece inputTypes.
source

enum (Conversation.Source)

Solo output. Indica l'origine della conversazione.
inputTypes[]

enum (Conversation.InputType)

Solo output. I tipi di input della conversazione.
entryAgent

string

Solo output. L'agente che gestisce inizialmente la conversazione. Se non specificato, la conversazione viene gestita dall'agente principale. Formato: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
deployment

string

Solo output. Il deployment dell'app utilizzata per l'elaborazione della conversazione. Formato: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
appVersion

string

Solo output. La versione dell'app utilizzata per l'elaborazione della conversazione. Formato: projects/{project}/locations/{location}/apps/{app}/versions/{version}
languageCode

string

Solo output. Il codice lingua della conversazione.
messages[]
(deprecated)

object (Message)

Deprecato. Utilizza invece i turni.

Conversation.Turn

Tutte le informazioni su un singolo turno della conversazione.

Rappresentazione JSON 
{
  "messages": [
    {
      object (Message)
    }
  ],
  "rootSpan": {
    object (Span)
  },
  "userIntendedText": string
}
Campi
messages[]

object (Message)

Facoltativo. Elenco dei messaggi nel turno di conversazione, inclusi l'input utente'utente, le risposte dell'agente e gli eventi intermedi durante l'elaborazione.
rootSpan

object (Span)

Facoltativo. Lo span radice dell'elaborazione dell'azione.
userIntendedText

string

Facoltativo. Il testo basato su dati empirici reali previsto del chiamante simulato (Polysynth). Viene compilato solo quando sono attivate le metriche del tasso di errore di parola.

Intervallo

Uno span è un'unità di lavoro o una singola operazione durante l'elaborazione della richiesta.

Rappresentazione JSON 
{
  "name": string,
  "startTime": string,
  "endTime": string,
  "duration": string,
  "attributes": {
    object
  },
  "childSpans": [
    {
      object (Span)
    }
  ]
}
Campi
name

string

Solo output. Il nome dello span.
startTime

string (Timestamp format)

Solo output. L'ora di inizio dell'intervallo.

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

string (Timestamp format)

Solo output. L'ora di fine dell'intervallo.

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".
duration

string (Duration format)

Solo output. La durata dell'intervallo.

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

object (Struct format)

Solo output. Attributi coppia chiave-valore associati allo span.
childSpans[]

object (Span)

Solo output. Gli intervalli secondari nidificati in questo intervallo.

Conversation.ChannelType

Il tipo di canale della conversazione.

Enum
CHANNEL_TYPE_UNSPECIFIED Tipo di canale non specificato.
TEXT La conversazione contiene solo messaggi di testo tra l'utente finale e l'agente.
AUDIO La conversazione contiene messaggi audio tra l'utente finale e l'agente.
MULTIMODAL I messaggi multimodali della conversazione (ad es. immagine) tra l'utente finale e l'agente.

Conversation.Source

L'origine della conversazione.

Enum
SOURCE_UNSPECIFIED Origine non specificata.
LIVE La conversazione è dell'utente finale live.
SIMULATOR La conversazione proviene dal simulatore.
EVAL La conversazione riguarda la valutazione.
AGENT_TOOL La conversazione proviene da uno strumento per agenti. Lo strumento dell'agente esegue l'agente in una sessione separata, che viene mantenuta per scopi di test e debug.

Conversation.InputType

Il tipo di messaggio di input.

Enum
INPUT_TYPE_UNSPECIFIED Tipo di input non specificato.
INPUT_TYPE_TEXT Input di testo.
INPUT_TYPE_EVENT Input evento.
INPUT_TYPE_AUDIO Input audio.
INPUT_TYPE_IMAGE Input immagine.
INPUT_TYPE_BLOB Input blob.
INPUT_TYPE_TOOL_RESPONSE Input di risposta dello strumento della funzione client.
INPUT_TYPE_VARIABLES Input delle variabili.

Metodi

batchDelete

 Elimina in batch le conversazioni specificate.

delete

 Elimina la conversazione specificata.

get

 Recupera i dettagli della conversazione specificata.

list

 Elenca le conversazioni nell'app specificata.