Container V2 menawarkan peningkatan signifikan dari container awal. Untuk memastikan saran dan alat utama yang paling efektif 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 melakukan inisialisasi konektor modul UI secara terpisah di V2. Dengan memisahkan konektor dari penampung, fleksibilitas integrasi menjadi lebih besar. Untuk penyiapan, lihat Konektor modul UI. Banyak properti di penampung V1 hanya berlaku untuk konektor modul UI.
Pelokalan
Kontainer V2 mendukung bahasa yang dilokalkan. Untuk memuat penampung dalam bahasa tertentu, tambahkan kode lokalitas 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 Raya) (
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 |
|---|---|---|
| fitur | 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 | Apakah akan memuat fitur saran yang dikonfigurasi secara dinamis di profil percakapan, bukan melakukan hard-coding di features. Nilai defaultnya adalah "false". |
| fitur-dinonaktifkan | 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-berbasis percakapan, seperti dengan Knowledge assist generatif. |
| show-header | BooleanString | Menentukan apakah akan menampilkan header branding Agent Assist. Nilai defaultnya adalah "false". |
| show-dark-mode-toggle | BooleanString | 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 | Apakah akan memicu ringkasan percakapan secara otomatis 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/menempelkan 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;
}