Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Langkah 3: Sematkan URL pengalaman Tanya Jawab Generatif
Di bagian berikut, Anda dapat menemukan cara menyematkan URL pengalaman Tanya Jawab Generatif di situs web atau halaman aplikasi Anda. Anda melakukan ini dengan Amazon QuickSight embedding SDK
-
Tempatkan pengalaman Tanya Jawab Generatif pada halaman HTML.
-
Sesuaikan tata letak dan tampilan pengalaman yang disematkan agar sesuai dengan kebutuhan aplikasi Anda.
-
Menangani status kesalahan dengan pesan yang disesuaikan dengan aplikasi Anda.
Untuk membuat URL yang dapat disematkan di aplikasi, panggil operasi GenerateEmbedUrlForRegisteredUser
API. URL ini berlaku selama 5 menit, dan sesi yang dihasilkan berlaku hingga 10 jam. Operasi API menyediakan URL dengan auth_code
nilai yang memungkinkan sesi masuk tunggal.
Berikut ini menunjukkan contoh respons darigenerate-embed-url-for-registered-user
.
//The URL returned is over 900 characters. For this example, we've shortened the string for //readability and added ellipsis to indicate that it's incomplete. { "Status": "200", "EmbedUrl": "https://quicksightdomain/embedding/12345/q/search...", "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713" }
Sematkan pengalaman Tanya Jawab Generatif di halaman web Anda dengan menggunakan SDK QuickSight penyematan
Pastikan domain untuk meng-host pengalaman Tanya Jawab Generatif yang disematkan ada di daftar izinkan, daftar domain yang disetujui untuk langganan Anda. QuickSight Persyaratan ini melindungi data Anda dengan menjaga domain yang tidak disetujui dari hosting dasbor tertanam. Untuk informasi selengkapnya tentang menambahkan domain untuk pengalaman Tanya Jawab Generatif yang disematkan, lihat. Mengelola domain dan menyematkan
Anda dapat menggunakan QuickSight Embedding SDK untuk menyesuaikan tata letak dan tampilan pengalaman Tanya Jawab Generatif yang disematkan agar sesuai dengan aplikasi Anda. Gunakan panelType
properti untuk mengonfigurasi status pendaratan pengalaman Tanya Jawab Generatif saat dirender dalam aplikasi Anda. Atur panelType
properti 'FULL'
untuk membuat panel pengalaman Tanya Jawab Generatif lengkap. Panel ini menyerupai pengalaman yang dimiliki QuickSight pengguna di konsol. Tinggi bingkai panel tidak berubah berdasarkan interaksi pengguna dan menghormati nilai yang Anda tetapkan di frameOptions.height
properti. Gambar di bawah ini menunjukkan panel pengalaman Tanya Jawab Generatif yang dirender saat Anda menyetel nilainya. panelType
'FULL'
![Panel pengalaman Tanya Jawab Generatif yang dirender saat Anda menyetel nilainya. panelType 'FULL'](images/genbi-panel.png)
Atur panelType
properti 'SEARCH_BAR'
untuk membuat pengalaman Tanya Jawab Generatif sebagai bilah pencarian. Bilah pencarian ini menyerupai cara Q Search Bar ditampilkan ketika disematkan ke dalam aplikasi. Bilah pencarian Tanya Jawab Generatif meluas ke panel yang lebih besar yang menampilkan opsi pemilihan topik, daftar saran pertanyaan, panel jawaban, atau papan pin.
Tinggi minimum default dari bilah penelusuran Tanya Jawab Generatif dirender saat aset yang disematkan dimuat. Disarankan agar Anda menetapkan frameOptions.height
nilai "38px"
untuk mengoptimalkan pengalaman bilah pencarian. Gunakan focusedHeight
properti untuk mengatur ukuran optimal dropdown pemilihan topik dan daftar saran pertanyaan. Gunakan expandedHeight
properti untuk mengatur ukuran optimal panel jawaban dan pinboard. Jika Anda memilih 'SEARCH_BAR'
opsi, disarankan agar Anda menata wadah induk dengan posisi; mutlak untuk menghindari pergeseran konten yang tidak diinginkan dalam aplikasi Anda. Gambar di bawah ini menunjukkan bilah pencarian pengalaman Tanya Jawab Generatif yang dirender saat Anda menyetel nilainya. panelType
'SEARCH_BAR'
![Panel pengalaman Tanya Jawab Generatif yang dirender saat Anda menyetel nilainya. panelType 'SEARCH_BAR'](images/genbi-search-bar.png)
Setelah mengonfigurasi panelType
properti, gunakan SDK QuickSight penyematan untuk menyesuaikan properti berikut dari pengalaman Tanya Jawab Generatif.
-
Judul panel Tanya Jawab Generatif (Berlaku hanya untuk opsi).
panelType: FULL
-
Teks placeholder bilah pencarian.
-
Apakah pemilihan topik diperbolehkan.
-
Apakah nama topik ditampilkan atau disembunyikan.
-
Apakah ikon Amazon Q ditampilkan atau disembunyikan (Berlaku hanya untuk
panelType: FULL
opsi). -
Apakah pinboard ditampilkan tersembunyi.
-
Apakah pengguna dapat memaksimalkan panel T&J Genertaive ke layar penuh.
-
Tema panel Tanya Jawab Generatif. Tema khusus ARN dapat diteruskan di SDK untuk mengubah tampilan konten frame.
Saat Anda menggunakan QuickSight Embedding SDK, pengalaman Tanya Jawab Generatif di halaman Anda diubah ukurannya secara dinamis berdasarkan status. Dengan menggunakan QuickSight Embedding SDK, Anda juga dapat mengontrol parameter dalam pengalaman Tanya Jawab Generatif dan menerima panggilan balik dalam hal penyelesaian pemuatan halaman, perubahan status, dan kesalahan.
Contoh berikut menunjukkan cara menggunakan URL yang dihasilkan. Kode ini dibuat di server aplikasi Anda.
Agar contoh ini berfungsi, pastikan untuk menggunakan Amazon QuickSight Embedding SDK untuk memuat pengalaman Tanya Jawab Generatif yang disematkan di situs web Anda. JavaScript Untuk mendapatkan salinan Anda, lakukan salah satu hal berikut:
-
Unduh SDK QuickSight penyematan Amazon
dari. GitHub Repositori ini dikelola oleh sekelompok pengembang. QuickSight -
Jika Anda menggunakan
npm
untuk JavaScript dependensi, unduh dan instal dengan menjalankan perintah berikut.npm install amazon-quicksight-embedding-sdk