Memandu perilaku agen dengan konteks yang dibuat

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:

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 publishedContext dengan perubahan dari stagingContext.
  • Anda dapat kembali ke agen lama sesuai kebutuhan dengan mengupdate publishedContext ke lastPublishedContext.