Container V2

Penampung V2 menawarkan peningkatan signifikan dari penampung awal dan akan terus memiliki fitur dan perubahan terbaru. Untuk memastikan saran yang paling berdampak dan alat utama selalu dapat diakses oleh agen, versi 2 menggunakan tampilan reaktif dengan panel dinamis dan feed saran terpadu.

Penggunaan

Impor modul di halaman HTML Anda dengan kode berikut:

<script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

Sematkan modul dengan tag berikut:

<agent-assist-ui-modules-v2>

Konektor modul UI

Tidak seperti V1, Anda harus menginisialisasi konektor modul UI secara terpisah di V2. Dengan memisahkan konektor dari penampung, fleksibilitas integrasi akan lebih besar. Untuk penyiapan, lihat konektor modul UI. Banyak properti di penampung V1 hanya berlaku untuk konektor modul UI.

Pelokalan

Penampung V2 mendukung bahasa yang dilokalkan. Untuk memuat penampung dalam bahasa tertentu, tambahkan kode lokal ke jalur skrip:

Contoh untuk bahasa Jepang:

<script src="https://www.gstatic.com/agent-assist-ui-modules/ja/v2/container.js"></script>

Jika tidak ada lokalitas yang ditentukan, penampung akan menggunakan bahasa Inggris (en) secara default, yang dimuat dari jalur root: html <script src="https://www.gstatic.com/agent-assist-ui-modules/v2/container.js"></script>

Lokalitas yang didukung:

• Arab (ar)
• China (Aksara Sederhana) (zh_cn)
• Kroasia (hr)
• Inggris (Australia) (en_au)
• Inggris (Kanada) (en_ca)
• Inggris (Inggris) (en_gb)
• Filipina (fil)
• Prancis (fr)
• Prancis (Kanada) (fr_ca)
• Jerman (de)
• Hindi (hi)
• Hungaria (hu)
• Italia (it)
• Jepang (ja)
• Korea (ko)
• Melayu (ms)
• Norwegia (no)
• Polandia (pl)
• Portugis (Brasil) (pt_br)
• Rumania (ro)
• Rusia (ru)
• Spanyol (es)
• Swedia (sv)
• Thai (th)
• Turki (tr)
• Vietnam (vi)

Atribut

Atribut adalah properti komponen berbasis string yang dapat ditetapkan di HTML atau menggunakan setAttribute() di JavaScript.

Nama properti	Jenis	Komentar
lanjutan	string	Daftar kunci fitur saran Agent Assist yang dipisahkan koma untuk dirender. Daftar yang didukung: AGENT_COACHING, CONVERSATION_SUMMARIZATION, SMART_REPLY, KNOWLEDGE_SEARCH, PROACTIVE_GENERATIVE_KNOWLEDGE_ASSIST. Diabaikan jika use-configured-features ditetapkan ke true.
use-configured-features	BooleanString	Menentukan apakah akan memuat fitur saran yang dikonfigurasi secara dinamis di profil percakapan, bukan di-hardcode di features. Nilai defaultnya adalah "false".
disabled-features	string	Daftar fitur saran yang dipisahkan koma untuk dikecualikan saat use-configured-features adalah "true". Contoh: "SMART_REPLY,CONVERSATION_SUMMARIZATION".
session-id	string	ID sesi opsional untuk penggunaan non-percakapan, seperti dengan Generative Knowledge Assist.
show-header	BooleanString	Menentukan apakah akan menampilkan header branding Agent Assist. Nilai defaultnya adalah "false".
show-dark-mode-toggle	BooleanString	Menentukan apakah akan menampilkan tombol untuk mode gelap versus mode terang. Nilai defaultnya adalah "true".
namespace	string	Batas namespace opsional. Hanya diperlukan jika menerapkan beberapa instance modul UI di satu halaman.
handoff-summarization-enabled	BooleanString	Menentukan apakah akan otomatis memicu ringkasan percakapan saat percakapan yang ada diinisialisasi. Nilai defaultnya adalah "false".

Input

Input adalah objek JavaScript atau jenis properti kompleks lainnya yang harus ditetapkan langsung pada instance elemen:

const el = document.querySelector('agent-assist-ui-modules-v2');
el.propertyName = value;

Nama properti	Jenis	Komentar
knowledgeAssistCardConfig	KnowledgeAssistV2Config	Konfigurasi opsional untuk kartu Generative Knowledge Assist, termasuk menyalin/menempel jawaban dan menyesuaikan target link artikel.

Jenis

Lihat bagian berikut untuk mengetahui jenis kustom yang digunakan oleh komponen.

BooleanString

"true" | "false"

KnowledgeAssistV2Config

interface KnowledgeAssistV2Config {
  /** Configuration for how suggested article links are opened. */
  articleLinkConfig?: {
    /** Whether to open the article in a new tab or in a popup window. Defaults to 'blank' (new tab). */
    target?: "blank" | "popup";
    /** Options to configure the popup's size and location. */
    popupWindowOptions?: string;
    /** The field name on the document metadata if a separate article link source is provided. */
    linkMetadataKey?: string;
  };
  /** Whether to show the Copy Answer button on suggestions. */
  showCopyAnswer: boolean;
  /** Whether to show the Paste Answer button on suggestions. */
  showPasteAnswer: boolean;
}