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

Resource: AssistAnswer

Resource AssistAnswer, bagian utama dari AssistResponse.

Representasi JSON 
{
  "name": string,
  "state": enum (State),
  "replies": [
    {
      object (Reply)
    }
  ],
  "diagnosticInfo": {
    object
  },
  "assistSkippedReasons": [
    enum (AssistSkippedReason)
  ],
  "requiredAuthorizations": [
    {
      object (RequiredAuthorization)
    }
  ],
  "customerPolicyEnforcementResult": {
    object (CustomerPolicyEnforcementResult)
  }
}
Kolom
name

string

Tidak dapat diubah. ID. Nama resource AssistAnswer. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/assistAnswers/{assistAnswer}

Kolom ini harus berupa string berenkode UTF-8 dengan batas panjang 1.024 karakter.
state

enum (State)

Status pembuatan jawaban.
replies[]

object (Reply)

Balasan asisten.
diagnosticInfo

object (Struct format)

Opsional. Informasi diagnostik yang dikumpulkan saat memproses permintaan. Ini hanya ditujukan untuk pembaca manusia, terutama untuk membantu proses debug. Struktur data dapat berubah tanpa pemberitahuan.
assistSkippedReasons[]

enum (AssistSkippedReason)

Alasan tidak menjawab panggilan bantuan.
requiredAuthorizations[]

object (RequiredAuthorization)

Hanya output. Daftar otorisasi yang diperlukan. Hanya diisi jika pengguna tidak diberi otorisasi untuk Authorization tertentu, tetapi agen yang dipanggil memerlukannya.
customerPolicyEnforcementResult

object (CustomerPolicyEnforcementResult)

Opsional. Kolom ini berisi informasi tentang hasil berbagai pemeriksaan kebijakan seperti frasa terlarang atau pemeriksaan Perlindungan Model. Kolom ini hanya diisi jika panggilan bantuan dilewati karena pelanggaran kebijakan.

Negara bagian/Provinsi

Status pembuatan jawaban.

Enum
STATE_UNSPECIFIED Tidak diketahui.
IN_PROGRESS Operasi bantuan sedang berlangsung.
FAILED Operasi bantuan gagal.
SUCCEEDED Operasi bantuan berhasil.
SKIPPED Operasi bantuan telah dilewati.

Balas

Salah satu bagian dari respons multi-bagian panggilan bantuan.

Representasi JSON 
{
  "replyId": string,

  // Union field reply can be only one of the following:
  "groundedContent": {
    object (AssistantGroundedContent)
  }
  // End of list of possible types for union field reply.
}
Kolom
replyId

string

Hanya output. Jika disetel, secara unik mengidentifikasi balasan dalam resource AssistAnswer. Selama panggilan AssistantService.StreamAssist, beberapa pesan Reply dengan ID yang sama dapat terjadi dalam aliran respons (di beberapa pesan [AssistantService.StreamAssistResponse][]). Ini merepresentasikan bagian dari satu pesan Reply dalam resource AssistAnswer akhir.
Kolom union reply. Alternatif untuk jawaban asisten. reply hanya ada berupa salah satu diantara berikut:
groundedContent

object (AssistantGroundedContent)

Teks atau media respons yang mungkin memiliki rujukan dari asisten.

AssistantGroundedContent

Sebuah konten dan kemungkinan informasi perujukan konten tersebut.

Tidak semua konten memerlukan perujukan. Frasa seperti "Tentu, saya akan dengan senang hati mencarinya untuk Anda" tidak memerlukan perujukan.

Representasi JSON 
{
  "content": {
    object (AssistantContent)
  },
  "citationMetadata": {
    object (CitationMetadata)
  },
  "contentMetadata": {
    object (ContentMetadata)
  },

  // Union field metadata can be only one of the following:
  "textGroundingMetadata": {
    object (TextGroundingMetadata)
  }
  // End of list of possible types for union field metadata.
}
Kolom
content

object (AssistantContent)

Konten.
citationMetadata

object (CitationMetadata)

Atribusi sumber konten yang dihasilkan. Lihat juga https://cloud.google.com/vertex-ai/generative-ai/docs/learn/overview#citation_check
contentMetadata

object (ContentMetadata)

Opsional. Metadata untuk konten. Saat ini hanya digunakan untuk jawaban asisten riset.
Kolom union metadata. Metadata perujukan untuk berbagai modal. Saat ini, hanya teks yang didukung. metadata hanya ada berupa salah satu diantara berikut:
textGroundingMetadata

object (TextGroundingMetadata)

Metadata untuk perujukan berdasarkan sumber teks.

TextGroundingMetadata

Detail perujukan untuk sumber teks.

Representasi JSON 
{
  "segments": [
    {
      object (Segment)
    }
  ],
  "references": [
    {
      object (Reference)
    }
  ],
  "searchEntryPoints": [
    {
      object (SearchEntryPoint)
    }
  ]
}
Kolom
segments[]

object (Segment)

Informasi perujukan untuk bagian teks.
references[]

object (Reference)

Referensi untuk teks yang memiliki rujukan.
searchEntryPoints[]

object (SearchEntryPoint)

Opsional. Titik entri Google Penelusuran untuk penelusuran web yang digunakan untuk perujukan.

Segmen

Informasi perujukan untuk segmen teks.

Representasi JSON 
{
  "startIndex": string,
  "endIndex": string,
  "referenceIndices": [
    integer
  ],
  "groundingScore": number,
  "text": string
}
Kolom
startIndex

string (int64 format)

Indeks berbasis nol yang menunjukkan awal segmen, diukur dalam byte string UTF-8 (yaitu karakter yang dienkode pada beberapa byte memiliki panjang lebih dari satu).
endIndex

string (int64 format)

Akhir segmen, eksklusif.
referenceIndices[]

integer

Referensi untuk segmen.
groundingScore

number

Skor untuk segmen.
text

string

Segmen teks itu sendiri.

Referensi

Konten yang dirujuk dan metadata dokumen terkait.

Representasi JSON 
{
  "content": string,
  "documentMetadata": {
    object (DocumentMetadata)
  }
}
Kolom
content

string

Konten teks yang dirujuk.
documentMetadata

object (DocumentMetadata)

Metadata dokumen.

DocumentMetadata

Metadata dokumen.

Representasi JSON 
{
  "boundingBoxes": [
    {
      object (BoundingBox)
    }
  ],
  "document": string,
  "uri": string,
  "title": string,
  "pageIdentifier": string,
  "domain": string,
  "mimeType": string
}
Kolom
boundingBoxes[]

object (BoundingBox)

Opsional. Kotak pembatas untuk referensi ini. Diulang untuk mendukung referensi yang mencakup beberapa halaman.
document

string

Nama resource dokumen.
uri

string

URI untuk dokumen. Mungkin berisi URL yang mengalihkan ke situs sebenarnya.
title

string

Judul.
pageIdentifier

string

ID halaman.
domain

string

Nama domain dari URI dokumen. Perhatikan bahwa kolom uri dapat berisi URL yang mengalihkan ke situs sebenarnya, yang dalam hal ini akan berisi nama domain situs target.
mimeType

string

Jenis MIME dokumen. https://www.iana.org/assignments/media-types/media-types.xhtml.

BoundingBox

Kotak pembatas yang memunculkan satu halaman.

Representasi JSON 
{
  "pageNumber": string,
  "boundingPoly": {
    object (BoundingPoly)
  }
}
Kolom
pageNumber

string
boundingPoly

object (BoundingPoly)

Bounding poly untuk konten teks dalam dokumen.

BoundingPoly

Bounding poly untuk konten teks dalam dokumen.

Representasi JSON 
{
  "normalizedVertices": [
    {
      object (NormalizedVertex)
    }
  ]
}
Kolom
normalizedVertices[]

object (NormalizedVertex)

NormalizedVertex

verteks mewakili titik 2D pada gambar.

CATATAN: koordinat verteks yang dinormalisasi akan relatif terhadap gambar asli dan memiliki rentang dari 0 hingga 1.

Representasi JSON 
{
  "x": number,
  "y": number
}
Kolom
x

number

Koordinat x.
y

number

Koordinat Y (dimulai dari bagian atas gambar).

SearchEntryPoint

Titik entri Google Penelusuran.

Representasi JSON 
{
  "renderedContent": string
}
Kolom
renderedContent

string

Cuplikan konten web yang dapat disematkan di halaman web atau webview aplikasi.

AssistantContent

Konten multimodal.

Representasi JSON 
{
  "role": string,
  "thought": boolean,

  // Union field data can be only one of the following:
  "text": string,
  "inlineData": {
    object (Blob)
  },
  "file": {
    object (File)
  },
  "executableCode": {
    object (ExecutableCode)
  },
  "codeExecutionResult": {
    object (CodeExecutionResult)
  }
  // End of list of possible types for union field data.
}
Kolom
role

string

Produser konten. Dapat berupa "model" atau "user".
thought

boolean

Opsional. Menunjukkan apakah bagian tersebut diperkirakan dari model.
Kolom union data. Data yang ada di dalamnya. data hanya ada berupa salah satu diantara berikut:
text

string

Teks inline.
inlineData

object (Blob)

Data biner inline.
file

object (File)

File, misalnya, ringkasan audio.
executableCode

object (ExecutableCode)

kode yang dihasilkan oleh model yang dimaksudkan untuk dieksekusi.
codeExecutionResult

object (CodeExecutionResult)

Hasil menjalankan ExecutableCode.

Blob

Blob inline.

Representasi JSON 
{
  "mimeType": string,
  "data": string
}
Kolom
mimeType

string

Wajib. Jenis media (jenis MIME) data yang dihasilkan.
data

string (bytes format)

Wajib. Byte mentah.

String berenkode base64.

File

File, misalnya, ringkasan audio.

Representasi JSON 
{
  "mimeType": string,
  "fileId": string
}
Kolom
mimeType

string

Wajib. Jenis media (jenis MIME) file.
fileId

string

Wajib. ID file.

ExecutableCode

kode yang dihasilkan oleh model yang dimaksudkan untuk dieksekusi oleh model.

Representasi JSON 
{
  "code": string
}
Kolom
code

string

Wajib. Konten kode. Saat ini hanya mendukung Python.

CodeExecutionResult

Hasil eksekusi ExecutableCode.

Representasi JSON 
{
  "outcome": enum (Outcome),
  "output": string
}
Kolom
outcome

enum (Outcome)

Wajib. Hasil eksekusi kode.
output

string

Opsional. Berisi stdout saat eksekusi kode berhasil, stderr, atau deskripsi lainnya.

Hasil

Enumerasi kemungkinan hasil eksekusi kode.

Enum
OUTCOME_UNSPECIFIED Status tidak ditentukan. Nilai ini tidak boleh digunakan.
OUTCOME_OK Eksekusi kode berhasil diselesaikan.
OUTCOME_FAILED eksekusi kode selesai, tetapi gagal. stderr harus berisi alasan.
OUTCOME_DEADLINE_EXCEEDED eksekusi kode berjalan terlalu lama, dan dibatalkan. Mungkin ada atau tidak ada output parsial.

CitationMetadata

Kumpulan atribusi sumber untuk suatu konten.

Representasi JSON 
{
  "citations": [
    {
      object (Citation)
    }
  ]
}
Kolom
citations[]

object (Citation)

Hanya output. Daftar kutipan.

Pengutipan

Atribusi sumber untuk konten.

Representasi JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "title": string,
  "license": string,
  "publicationDate": {
    object (Date)
  }
}
Kolom
startIndex

integer

Hanya output. Indeks awal ke dalam konten.
endIndex

integer

Hanya output. Indeks akhir ke dalam konten.
uri

string

Hanya output. Referensi URL atribusi.
title

string

Hanya output. Judul atribusi.
license

string

Hanya output. Lisensi atribusi.
publicationDate

object (Date)

Hanya output. Tanggal publikasi atribusi.

ContentMetadata

metadata untuk konten.

Representasi JSON 
{
  "contentKind": enum (ContentKind),
  "contentId": string
}
Kolom
contentKind

enum (ContentKind)

jenis konten. Menunjukkan bagian jawaban asisten riset yang berisi konten ini.
contentId

string

ID konten. Digunakan untuk menghubungkan pertanyaan penelitian dengan jawabannya. Misalnya, bagian jawaban atas pertanyaan penelitian akan memiliki contentId yang sama dengan pertanyaan.

ContentKind

Kemungkinan jenis konten. Saat ini hanya digunakan untuk membedakan bagian dalam jawaban lengkap asisten riset.

Enum
CONTENT_KIND_UNSPECIFIED Tidak diketahui.
RESEARCH_PLAN Rencana riset.
RESEARCH_QUESTION Pertanyaan penelitian.
RESEARCH_ANSWER Jawaban penelitian.
RESEARCH_REPORT Research report.
RESEARCH_AUDIO_SUMMARY Ringkasan audio riset.

AssistSkippedReason

Kemungkinan alasan tidak menjawab panggilan bantuan.

Enum
ASSIST_SKIPPED_REASON_UNSPECIFIED Nilai default. Alasan melewati tidak ditentukan.
NON_ASSIST_SEEKING_QUERY_IGNORED Asisten mengabaikan kueri karena tampaknya tidak mencari jawaban.
CUSTOMER_POLICY_VIOLATION Asisten mengabaikan kueri atau menolak menjawab karena pelanggaran kebijakan pelanggan (misalnya, kueri atau jawaban berisi frasa yang dilarang).

RequiredAuthorization

Mewakili otorisasi yang diperlukan agar agen dapat berfungsi.

Representasi JSON 
{
  "authorization": string,
  "displayName": string,
  "authorizationUri": string
}
Kolom
authorization

string

Hanya output. Nama Authorization.
displayName

string

Hanya output. Nama tampilan otorisasi.
authorizationUri

string

Hanya output. URI yang harus dibuka pengguna untuk memberikan otorisasi.

CustomerPolicyEnforcementResult

Hasil penegakan kebijakan pelanggan. Berisi hasil berbagai pemeriksaan kebijakan, seperti frasa terlarang atau pemeriksaan Model Armor.

Representasi JSON 
{
  "verdict": enum (Verdict),
  "policyResults": [
    {
      object (PolicyEnforcementResult)
    }
  ]
}
Kolom
verdict

enum (Verdict)

Putusan akhir penegakan kebijakan pelanggan. Jika hanya satu kebijakan yang memblokir pemrosesan, maka keputusannya adalah BLOKIR.
policyResults[]

object (PolicyEnforcementResult)

Hasil penegakan kebijakan pelanggan. Diisi hanya jika panggilan bantuan dilewati karena pelanggaran kebijakan. Bagian ini berisi hasil dari filter yang memblokir pemrosesan kueri.

Putusan

Putusan penegakan kebijakan pelanggan.

Enum
UNSPECIFIED Nilai tidak diketahui.
ALLOW Tidak ada pelanggaran kebijakan.
BLOCK Pemrosesan diblokir oleh kebijakan pelanggan.

PolicyEnforcementResult

Hasil penegakan kebijakan pelanggan untuk satu jenis kebijakan.

Representasi JSON 
{

  // Union field enforcement_result can be only one of the following:
  "bannedPhraseEnforcementResult": {
    object (BannedPhraseEnforcementResult)
  },
  "modelArmorEnforcementResult": {
    object (ModelArmorEnforcementResult)
  }
  // End of list of possible types for union field enforcement_result.
}
Kolom
Kolom union enforcement_result. Hasil spesifik jenis kebijakan. Nilainya dapat berupa error atau informasi mendetail tentang hasil penegakan kebijakan. enforcement_result hanya ada berupa salah satu diantara berikut:
bannedPhraseEnforcementResult

object (BannedPhraseEnforcementResult)

Hasil penerapan kebijakan untuk kebijakan frasa terlarang.
modelArmorEnforcementResult

object (ModelArmorEnforcementResult)

Hasil penerapan kebijakan untuk kebijakan Model Armor.

BannedPhraseEnforcementResult

Hasil penegakan kebijakan pelanggan untuk kebijakan frasa terlarang.

Representasi JSON 
{
  "bannedPhrases": [
    string
  ]
}
Kolom
bannedPhrases[]

string

Frasa terlarang yang ditemukan dalam kueri atau jawaban.

ModelArmorEnforcementResult

Hasil penegakan kebijakan pelanggan untuk kebijakan Model Armor.

Representasi JSON 
{

  // Union field result can be only one of the following:
  "modelArmorViolation": string,
  "error": {
    object (Status)
  }
  // End of list of possible types for union field result.
}
Kolom
Kolom union result. Hasil kebijakan Model Armor. result hanya ada berupa salah satu diantara berikut:
modelArmorViolation

string

Pelanggaran Model Armor yang ditemukan.
error

object (Status)

Error yang ditampilkan oleh Model Armor jika penerapan kebijakan gagal karena alasan tertentu.

Metode

get

 Mendapatkan AssistAnswer.