REST Resource: projects.locations.apps.conversations

Resource: Percakapan

Percakapan mewakili interaksi antara pengguna akhir dan aplikasi CES.

Representasi 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)
    }
  ]
}
Kolom
name

string

ID. ID unik percakapan. Format: projects/{project}/locations/{location}/apps/{app}/conversations/{conversation}
startTime

string (Timestamp format)

Hanya output. Stempel waktu saat percakapan dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Hanya output. Stempel waktu saat percakapan selesai.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
turns[]

object (Conversation.Turn)

Wajib. Giliran dalam percakapan.
turnCount

integer

Hanya output. Jumlah giliran dalam percakapan.
channelType
(deprecated)

enum (Conversation.ChannelType)

TIDAK DIGUNAKAN LAGI. Sebagai gantinya, gunakan inputTypes.
source

enum (Conversation.Source)

Hanya output. Menunjukkan sumber percakapan.
inputTypes[]

enum (Conversation.InputType)

Hanya output. Jenis input percakapan.
entryAgent

string

Hanya output. Agen yang awalnya menangani percakapan. Jika tidak ditentukan, percakapan akan ditangani oleh agen root. Format: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
deployment

string

Hanya output. Deployment aplikasi yang digunakan untuk memproses percakapan. Format: projects/{project}/locations/{location}/apps/{app}/deployments/{deployment}
appVersion

string

Hanya output. Versi aplikasi yang digunakan untuk memproses percakapan. Format: projects/{project}/locations/{location}/apps/{app}/versions/{version}
languageCode

string

Hanya output. Kode bahasa percakapan.
messages[]
(deprecated)

object (Message)

Tidak digunakan lagi. Gunakan giliran sebagai gantinya.

Conversation.Turn

Semua informasi tentang satu giliran dalam percakapan.

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

object (Message)

Opsional. Daftar pesan dalam giliran percakapan, termasuk input pengguna, respons agen, dan peristiwa perantara selama pemrosesan.
rootSpan

object (Span)

Opsional. Rentang root pemrosesan tindakan.
userIntendedText

string

Opsional. Teks kebenaran nyata yang dimaksudkan dari Penelepon Simulasi (Polysynth). Hanya diisi jika metrik rasio kesalahan kata diaktifkan.

Span

Rentang adalah unit tugas atau satu operasi selama pemrosesan permintaan.

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

string

Hanya output. Nama rentang.
startTime

string (Timestamp format)

Hanya output. Waktu mulai rentang.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Hanya output. Waktu akhir rentang.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
duration

string (Duration format)

Hanya output. Durasi rentang.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
attributes

object (Struct format)

Hanya output. Atribut nilai kunci yang terkait dengan rentang.
childSpans[]

object (Span)

Hanya output. Span turunan yang bertingkat di bawah span ini.

Conversation.ChannelType

Jenis channel percakapan.

Enum
CHANNEL_TYPE_UNSPECIFIED Jenis saluran tidak ditentukan.
TEXT Percakapan hanya berisi pesan teks antara pengguna akhir dan agen.
AUDIO Percakapan berisi pesan audio antara pengguna akhir dan agen.
MULTIMODAL Pesan multi-modal percakapan (misalnya, gambar) antara pengguna akhir dan agen.

Conversation.Source

Sumber percakapan.

Enum
SOURCE_UNSPECIFIED Sumber tidak ditentukan.
LIVE Percakapan berasal dari pengguna akhir aktif.
SIMULATOR Percakapan berasal dari simulator.
EVAL Percakapan berasal dari evaluasi.
AGENT_TOOL Percakapan berasal dari alat agen. Alat agen menjalankan agen dalam sesi terpisah, yang dipertahankan untuk tujuan pengujian dan proses debug.

Conversation.InputType

Jenis pesan input.

Enum
INPUT_TYPE_UNSPECIFIED Jenis input tidak ditentukan.
INPUT_TYPE_TEXT Input teks.
INPUT_TYPE_EVENT Input acara.
INPUT_TYPE_AUDIO Input audio.
INPUT_TYPE_IMAGE Input gambar.
INPUT_TYPE_BLOB Input blob.
INPUT_TYPE_TOOL_RESPONSE Input respons alat fungsi klien.
INPUT_TYPE_VARIABLES Input variabel.

Metode

batchDelete

 Menghapus percakapan tertentu secara batch.

delete

 Menghapus percakapan yang ditentukan.

get

 Mendapatkan detail percakapan yang ditentukan.

list

 Mencantumkan percakapan di aplikasi tertentu.