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 della 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 input utente, risposte dell'agente ed eventi intermedi durante l'elaborazione.
rootSpan

object (Span)

Facoltativo. L'intervallo principale dell'elaborazione dell'azione.
userIntendedText

string

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

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 La conversazione contiene messaggi multimodali (ad es. immagini) tra l'utente finale e l'agente.

Conversation.Source

L'origine della conversazione.

Enum
SOURCE_UNSPECIFIED Origine non specificata.
LIVE La conversazione proviene dall'utente finale live.
SIMULATOR La conversazione proviene dal simulatore.
EVAL La conversazione proviene dalla valutazione.
AGENT_TOOL La conversazione proviene da uno strumento dell'agente. 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 di eventi.
INPUT_TYPE_AUDIO Input audio.
INPUT_TYPE_IMAGE Input di immagini.
INPUT_TYPE_BLOB Input di blob.
INPUT_TYPE_TOOL_RESPONSE Input della 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.

generateEvaluation

 Crea una valutazione di riferimento da una conversazione.

get

 Recupera i dettagli della conversazione specificata.

list

 Elenca le conversazioni nell'app specificata.