Memory Bank Platform Agen

Penyimpanan Memori Platform Agen memungkinkan Anda menghasilkan memori jangka panjang secara dinamis berdasarkan percakapan antara pengguna dan agen Anda. Memori ini adalah informasi yang dipersonalisasi dan tetap ada di beberapa sesi, sehingga memungkinkan agen Anda beradaptasi dan mempersonalisasi respons untuk konteks dan kesinambungan.

Fitur

Memory Bank membantu Anda mengelola memori, sehingga Anda dapat mempersonalisasi cara agen berinteraksi dengan pengguna dan mengelola jendela konteks. Untuk setiap cakupan, Bank Memori mempertahankan kumpulan memori yang terisolasi. Setiap memori adalah informasi mandiri yang independen yang dapat digunakan untuk memperluas konteks yang tersedia bagi agen Anda. Contoh:

{
  "name": "projects/.../locations/.../reasoningEngines/.../memories/...",
  "scope": {
    "agent_name": "My agent",
    "user": "my user ID"
  },
  "fact": "I use Memory Bank to manage my memories."
}

Bank Memori mencakup fitur berikut:

  • Pembuatan memori: Buat, perbaiki, dan kelola memori menggunakan model bahasa besar (LLM).

    • Ekstraksi memori: Mengekstrak hanya informasi paling bermakna dari data sumber untuk dipertahankan sebagai memori.

    • Konsolidasi memori: Mengonsolidasi informasi yang baru diekstrak dengan memori yang ada, sehingga memori dapat berkembang seiring dengan penyerapan informasi baru. Anda juga dapat mengonsolidasi memori yang telah diekstrak sebelumnya (seperti informasi yang dianggap penting oleh agen Anda atau manusia dalam loop) dengan memori yang ada.

    • Pembuatan asinkron: Buat memori di latar belakang, sehingga agen Anda tidak perlu menunggu hingga pembuatan memori selesai.

    • Penyerapan peristiwa berkelanjutan: Streaming dan kelola peristiwa percakapan dengan penyerapan peristiwa, yang secara otomatis memicu pembuatan memori berdasarkan aturan pengelompokan yang Anda konfigurasi.

    • Ekstraksi yang dapat disesuaikan: Konfigurasi informasi yang dianggap penting oleh Memory Bank dengan memberikantopik tertentu dan contoh sedikit tembakan.

    • Pemahaman multimodal: Memproses informasi multimodal untuk membuat dan mempertahankan insight tekstual.

  • Penyimpanan dan pengambilan data terkelola: Manfaatkan penyimpanan memori yang terkelola sepenuhnya, persisten, dan dapat diakses.

    • Isolasi data di seluruh identitas: Konsolidasi dan pengambilan memori diisolasi ke identitas tertentu.

    • Penyimpanan yang persisten dan dapat diakses: Menyimpan memori yang dapat diakses dari beberapa lingkungan, termasuk Agent Runtime, lingkungan lokal Anda, atau opsi deployment lainnya.

    • Penelusuran kemiripan: Mengambil memori menggunakan penelusuran kemiripan yang dicakup ke identitas tertentu.

    • Masa berlaku otomatis: Tetapkan time to live (TTL) pada kenangan untuk memastikan informasi yang sudah tidak berlaku dihapus secara otomatis. Konfigurasi instance Memory Bank Anda sehingga TTL otomatis diterapkan ke kenangan yang dimasukkan atau dibuat.

    • Revisi kenangan: Membuat dan mempertahankan revisi kenangan secara otomatis yang memungkinkan Anda memeriksa cara kenangan berubah saat informasi baru dimasukkan.

    • Izin yang ketat: Gunakan kondisi IAM untuk membatasi akun utama yang dapat membaca atau menulis memori cakupan tertentu.

  • Integrasi agen: Hubungkan Memory Bank ke agen Anda, sehingga agen dapat mengatur panggilan untuk membuat dan mengambil kenangan.

    • Integrasi Agent Development Kit (ADK): Mengatur panggilan dari agen berbasis ADK Anda menggunakan alat ADK bawaan dan VertexAiMemoryBankService untuk membaca dan menulis ke Memory Bank.

    • Framework lainnya: Bungkus kode Memory Bank Anda dalam alat dan callback untuk mengatur pembuatan dan pengambilan memori.

Kasus penggunaan

Anda dapat menggunakan Memory Bank untuk mengubah interaksi agen stateless menjadi pengalaman stateful dan kontekstual di mana agen mengingat, mempelajari, dan beradaptasi seiring waktu. Memory Bank ideal untuk aplikasi yang memerlukan:

  • Personalisasi jangka panjang: Buat pengalaman yang disesuaikan dengan pengguna perorangan. Memory Bank mencakup memori ke identitas tertentu, sehingga agen dapat mengingat preferensi, histori, dan detail penting pengguna di beberapa sesi.

    • Contoh: Agen layanan pelanggan yang mengingat informasi penting dari tiket dukungan dan preferensi produk pengguna di masa lalu tanpa perlu bertanya lagi.

  • Ekstraksi pengetahuan yang didukung LLM: Gunakan saat Anda perlu mengidentifikasi dan mempertahankan informasi terpenting dari percakapan atau konten multimodal secara otomatis tanpa intervensi manual.

    • Contoh: Agen riset yang membaca serangkaian makalah teknis dan membangun memori gabungan tentang temuan utama, metodologi, dan kesimpulan.

  • Konteks dinamis & terus berkembang: Gunakan Memory Bank saat Anda memerlukan sumber pengetahuan yang tidak statis. Bank Memori dirancang untuk terus mengintegrasikan informasi baru dari agen Anda, menyempurnakan dan memperbarui memori yang tersimpan saat data baru tersedia. Hal ini memastikan konteks yang diandalkan agen Anda selalu terbaru dan akurat. Sementara RAG memiliki pusat informasi eksternal statis, Memory Bank dapat berkembang berdasarkan konteks yang diberikan oleh agen.

Contoh penggunaan

Ringkasan konseptual Memory Bank Agent Platform

Anda dapat menggunakan Memory Bank dengan Sesi Agent Platform untuk membuat memori dari sesi tersimpan menggunakan proses berikut:

  1. (Sesi) CreateSession: Di awal setiap percakapan, buat sesi baru. Histori percakapan yang digunakan oleh agen dibatasi untuk sesi ini. Sesi berisi urutan kronologis pesan dan tindakan (SessionEvents) untuk interaksi antara pengguna dan agen Anda. Semua sesi harus memiliki ID pengguna; memori yang diekstrak (lihat GenerateMemories) untuk sesi ini dipetakan ke pengguna ini.

  2. (Sesi) AppendEvent: Saat pengguna berinteraksi dengan agen, peristiwa (seperti pesan pengguna, respons agen, tindakan alat) diupload ke Sesi. Peristiwa ini mempertahankan histori percakapan dan membuat catatan percakapan yang dapat digunakan untuk menghasilkan memori.

  3. (Sesi) ListEvents: Saat pengguna berinteraksi dengan agen, agen mengambil histori percakapan.

  4. (Memory Bank) Membuat atau menghasilkan kenangan:

    • GenerateMemories: Pada interval tertentu (seperti di akhir setiap sesi atau di akhir setiap giliran), agen dapat memicu pembuatan memori menggunakan histori percakapan. Fakta tentang pengguna diekstrak secara otomatis dari histori percakapan sehingga tersedia untuk sesi saat ini atau mendatang.

    • CreateMemory: Agen Anda dapat menulis memori langsung ke Memory Bank. Misalnya, agen dapat memutuskan kapan memori harus ditulis dan informasi apa yang harus disimpan (memori sebagai alat). Gunakan CreateMemory jika Anda ingin agen Anda memiliki lebih banyak kontrol atas fakta yang diekstrak.

  5. (Memory Bank) RetrieveMemories: Saat pengguna berinteraksi dengan agen Anda, agen dapat mengambil memori yang disimpan tentang pengguna tersebut. Anda dapat mengambil semua kenangan (pengambilan sederhana) atau hanya kenangan yang paling relevan dengan percakapan saat ini (pengambilan penelusuran kemiripan). Kemudian, Anda dapat menyisipkan kenangan yang diambil ke dalam perintah Anda.

Panduan memulai

Mulai menggunakan Memory Bank dengan panduan memulai berikut:

Risiko keamanan injeksi perintah

Selain tanggung jawab keamanan yang diuraikan dalam tanggung jawab bersama Agent Platform, pertimbangkan risiko injeksi perintah dan peracunan memori yang dapat memengaruhi agen Anda saat menggunakan memori jangka panjang. Keracunan memori terjadi saat informasi palsu disimpan di Memory Bank. Agen kemudian dapat beroperasi pada informasi palsu atau berbahaya ini dalam sesi mendatang.

Untuk mengurangi risiko keracunan memori, Anda dapat melakukan hal berikut:

  • Model Armor: Gunakan Model Armor untuk memeriksa perintah yang dikirim ke Memory Bank atau dari agen Anda.

  • Pengujian adversarial: Menguji aplikasi LLM Anda secara proaktif untuk mengetahui kerentanan injeksi perintah dengan menyimulasikan serangan. Hal ini biasanya dikenal sebagai "red teaming".

  • Eksekusi sandbox: Jika agen memiliki kemampuan untuk mengeksekusi atau berinteraksi dengan sistem eksternal atau penting, tindakan ini harus dilakukan di lingkungan sandbox dengan kontrol akses yang ketat dan peninjauan manual.

Untuk mengetahui informasi selengkapnya, lihat Pendekatan Google untuk Agen AI yang Aman.

Langkah berikutnya

Panduan memulai

Mulai menggunakan Memory Bank API untuk mengelola memori jangka panjang.

Panduan memulai

Mulai menggunakan Agent Development Kit (ADK).

Panduan

Pelajari cara menyiapkan Memory Bank.