Ringkasan layanan masukan

Layanan Masukan Platform Agen memungkinkan Anda mengumpulkan dan menganalisis masukan pengguna dari interaksi dengan agen Anda. Layanan ini menyediakan infrastruktur yang diperlukan, sehingga Anda tidak perlu memelihara database masukan Anda sendiri. Layanan menyimpan reaksi pengguna dan menautkannya ke linimasa peristiwa percakapan yang sesuai.

Anda dapat mulai mengumpulkan masukan untuk agen dari pengguna akhir dengan melakukan integrasi langsung dengan API layanan Masukan atau menggunakan SDK. API dan SDK memungkinkan Anda mengelola entri masukan menggunakan operasi CRUDL (buat, ambil, perbarui, hapus, dan cantumkan) standar serta melampirkan detail percakapan tambahan ke entri masukan melalui resource FeedbackContext.

Untuk mengetahui informasi selengkapnya, lihat Mengelola masukan dengan Python SDK atau REST API atau Melihat masukan di konsol.

Konsep inti

  • Entri masukan: Melacak data kualitatif diskrit yang diberikan oleh pengguna akhir. Setiap entri merekam sentimen biner, label masukan spesifik, dan teks bentuk bebas opsional.
  • Jenis masukan: Sentimen biner dari pengguna akhir, yang diwakili oleh thumbs_up dan thumbs_down.
  • ID Sesi (session_id) dan ID Peristiwa (event_id): Kolom wajib diisi yang menghubungkan masukan ke peristiwa atau giliran percakapan tertentu.
  • Konteks masukan: Resource opsional yang dilampirkan ke entri masukan yang menyimpan transkrip atau log percakapan, sehingga mempertahankan konteks meskipun sesi asli dihapus. Resource ini dapat menyimpan seluruh percakapan atau pesan yang dipilih oleh pengguna, bergantung pada apa yang Anda pilih untuk disertakan.
  • Label masukan: Klasifikasi yang menentukan sifat masalah operasional atau hasil yang berhasil.
    • Label masukan positif (biasanya digunakan dengan thumbs_up) meliputi:
      • accurate
      • complete
      • helpful
      • on_topic
      • fast
      • safe
      • factual
      • tool_success
    • Label masukan negatif (biasanya digunakan dengan thumbs_down) mencakup:
      • inaccurate
      • incomplete
      • unhelpful
      • off_topic
      • too_slow
      • unsafe
      • hallucination
      • tool_error

Sebelum memulai

Untuk menggunakan layanan Masukan, pastikan Anda memiliki hal berikut:

  • Instance Agent Runtime yang ada. Untuk mengetahui informasi selengkapnya, lihat Mengembangkan agen Agent Development Kit.
  • Opsional: Untuk melihat entri masukan di samping peristiwa rekaman aktivitas di konsol, pastikan instance Agent Runtime Anda telah mengaktifkan rekaman aktivitas.

Mendapatkan peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menggunakan layanan Masukan, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Jika Anda membuat permintaan ke layanan Masukan dari Google Cloud, pastikan akun layanan Anda memiliki izin yang diperlukan. Akun layanan yang dikelola pengguna harus memiliki izin Pengguna Agent Platform (aiplatform.user) untuk berinteraksi dengan layanan Feedback.

Reasoning Engine Service Agent sudah memiliki izin yang diperlukan untuk mengelola masukan, sehingga permintaan keluar dari Agent Runtime sudah memiliki izin untuk mengakses layanan Masukan.

Langkah berikutnya