REST Resource: projects.locations.collections.engines.sessions

Resource: Session

Definisi proto sesi eksternal.

Representasi JSON
{
  "name": string,
  "displayName": string,
  "state": enum (State),
  "userPseudoId": string,
  "turns": [
    {
      object (Turn)
    }
  ],
  "labels": [
    string
  ],
  "startTime": string,
  "endTime": string,
  "isPinned": boolean,
  "pendingAsyncAssistOperationId": string
}
Kolom
name

string

Tidak dapat diubah. Nama yang sepenuhnya memenuhi syarat projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*

displayName

string

Opsional. Nama tampilan sesi.

Kolom ini digunakan untuk mengidentifikasi sesi di UI. Secara default, nama tampilan adalah teks kueri giliran pertama dalam sesi.

state

enum (State)

Status sesi.

userPseudoId

string

ID unik untuk melacak pengguna.

turns[]

object (Turn)

Giliran.

labels[]

string

Opsional. Label untuk sesi. Dapat ditetapkan sebagai filter di ListSessionsRequest.

startTime

string (Timestamp format)

Hanya output. Waktu sesi dimulai.

Menggunakan RFC 3339 yang outputnya akan selalu dikonversi ke format 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 sesi selesai.

Menggunakan RFC 3339 yang outputnya akan selalu dikonversi ke format 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".

isPinned

boolean

Opsional. Apakah sesi disematkan atau tidak. Sesi yang disematkan akan ditampilkan di bagian atas daftar sesi.

pendingAsyncAssistOperationId

string

Hanya output. Nama resource lengkap dari operasi AsyncAssist yang sedang berlangsung untuk sesi ini, misalnya projects/*/locations/*/collections/*/engines/*/sessions/*/operations/*. Ditetapkan saat operasi dimulai dan dihapus saat operasi selesai.

Metode

addContextFile

Mengupload file konteks untuk digunakan sebagai sumber panggilan bantuan dalam sesi.

create

Membuat Sesi.

delete

Menghapus Sesi.

get

Mendapatkan Sesi.

list

Mencantumkan semua Sesi berdasarkan DataStore induknya.

listSessionFileMetadata

Mencantumkan metadata untuk semua file dalam sesi saat ini.

patch

Memperbarui Sesi.

recommendQuestions

Mendapatkan pertanyaan yang direkomendasikan untuk sesi yang diberikan.

removeContextFile

Menghapus file konteks dari sesi.

selectContextFiles

Memilih file konteks yang akan digunakan dalam sesi.

validateUserAuthorization

Memvalidasi alur izin A2A 3-legged-OAuth (3LO) downstream-auth setelah pengguna kembali dari layar izin pihak ketiga, dan menyelesaikan kredensial downstream dengan Pengelola Autentikasi.