Halaman ini menjelaskan cara terbaik untuk memberikan konteks yang ditulis ke agen data Analisis Percakapan API dengan menulis perintah yang efektif melalui petunjuk sistem dan, untuk beberapa sumber data, dengan memberikan konteks terstruktur tambahan. Meskipun memberikan konteks yang ditulis bersifat opsional, konteks yang ditulis dengan struktur yang baik dapat meningkatkan akurasi dan relevansi respons yang diberikan API.
Apa yang dimaksud dengan konteks yang ditulis?
Konteks yang ditulis adalah panduan yang dapat diberikan developer untuk membentuk perilaku agen data dan menyempurnakan respons API. Panduan ini mencakup petunjuk sistem bentuk bebas dan, untuk beberapa sumber data, kolom konteks terstruktur dengan informasi seperti deskripsi tabel dan contoh kueri. Untuk menjawab pertanyaan, agen menggabungkan konteks yang ditulis ini dengan informasi dari sumber data—seperti tabel BigQuery, Eksplorasi Looker, Data Studio, dan sumber data database—serta dengan histori percakapan (untuk percakapan multi-turn).
Dengan memberikan panduan yang jelas melalui kolom kontekstual terstruktur dan petunjuk sistem bentuk bebas, Anda dapat meningkatkan kemampuan agen untuk menafsirkan pertanyaan pengguna dan menghasilkan respons yang berguna dan akurat. Konteks yang didefinisikan dengan baik sangat berguna jika Anda terhubung ke data seperti tabel BigQuery. Misalnya, Anda dapat menggunakan konteks yang ditulis untuk memberikan jenis panduan berikut kepada agen:
- Logika khusus bisnis: Tentukan pelanggan "loyal" sebagai pelanggan yang telah melakukan lebih dari lima pembelian dalam jangka waktu tertentu.
- Pemformatan respons: Ringkas semua respons dari agen data Anda dalam 20 kata atau kurang untuk menghemat waktu pengguna.
- Presentasi data: Format semua angka agar sesuai dengan panduan gaya perusahaan.
Memberikan konteks yang ditulis
Informasi spesifik yang dapat Anda berikan bergantung pada sumber data Anda. Untuk data BigQuery, data Looker, dan data database, Anda dapat menentukan konteks terstruktur dan petunjuk sistem. Untuk hasil terbaik, berikan konteks terlebih dahulu kepada agen melalui kolom terstruktur yang tersedia. Anda kemudian dapat memberikan panduan tambahan dengan menentukan petunjuk sistem.
Anda memberikan konteks terstruktur di kolom API untuk detail seperti deskripsi tabel dan contoh kueri. Anda memberikan petunjuk sistem sebagai string berformat YAML menggunakan parameter system_instruction.
Setelah menentukan konteks yang ditulis, Anda dapat memberikannya ke API dalam salah satu panggilan berikut:
- Membuat agen data persisten: Sertakan konteks yang ditulis dalam objek
published_contextdi isi permintaan untuk mengonfigurasi perilaku agen yang tetap ada di beberapa percakapan. Untuk mengetahui informasi selengkapnya, lihat Membuat agen data (HTTP) atau Menyiapkan konteks untuk chat stateful atau stateless (Python SDK). - Mengirim permintaan stateless: Berikan konteks yang ditulis dalam objek
inline_contextdalam permintaan chat untuk menentukan perilaku agen untuk panggilan API tertentu tersebut. Untuk mengetahui informasi selengkapnya, lihat Membuat percakapan multi-turn stateless (HTTP) atau Menggunakan API untuk mengajukan pertanyaan (Python SDK). - Mengirim permintaan data kueri: Untuk sumber data database, berikan ID set konteks dari konteks yang dibuat dalam objek
agent_context_referencedalam permintaan data kueri. Untuk mengetahui informasi selengkapnya, lihat Menentukan konteks agen data untuk sumber data database.
Praktik terbaik untuk membuat agen: Gunakan kontrol versi untuk konteks yang ditulis
Gunakan kolom stagingContext, publishedContext, dan lastPublishedContext untuk mengontrol versi konteks saat membangun agen dengan API Analisis Percakapan. Kasus penggunaan berikut menggambarkan cara menggunakan kolom ini untuk membuat versi staging dan produksi konteks agen.
Misalnya, Anda menggunakan agen yang ada dengan kolom publishedContext, tetapi Anda perlu melakukan update pada agen (misalnya, membuat semua diagram berwarna hijau, bukan biru).
Untuk membuat perubahan dan mengujinya sebelum memublikasikan, ikuti langkah-langkah berikut:
- Lakukan perubahan pada agen di kolom
stagingContext, dan uji agen dengan perubahan tersebut. - Jika perubahan sudah siap, perbarui kolom
publishedContextdengan perubahan daristagingContext. - Anda dapat kembali ke agen lama sesuai kebutuhan dengan mengupdate
publishedContextkelastPublishedContext.