Memory Bank Platform Agen

Memory Bank Platform Agen memungkinkan Anda membuat 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 kontinuitas.

Fitur

Memory Bank membantu Anda mengelola memori, sehingga Anda dapat mempersonalisasi cara agen berinteraksi dengan pengguna dan mengelola jendela konteks. Untuk setiap cakupan, Memory Bank mempertahankan kumpulan memori yang terisolasi. Setiap memori adalah informasi yang independen dan mandiri 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."
}

Memory Bank mencakup fitur berikut:

  • Pembuatan memori: Membuat, menyempurnakan, dan mengelola memori menggunakan model bahasa besar (LLM).

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

    • Konsolidasi memori: Mengonsolidasikan informasi yang baru diekstrak dengan memori yang ada, sehingga memori dapat berkembang saat informasi baru dimasukkan. Anda juga dapat mengonsolidasikan memori yang telah diekstrak sebelumnya (seperti informasi yang dianggap bermakna oleh agen Anda atau manusia dalam loop) dengan memori yang ada.

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

    • Pemasukan peristiwa berkelanjutan: Streaming dan mengelola peristiwa percakapan dengan pemasukan peristiwa, yang secara otomatis memicu pembuatan memori berdasarkan aturan batch yang Anda konfigurasi.

    • Ekstraksi yang dapat disesuaikan: Mengonfigurasi informasi yang dianggap bermakna oleh Memory Bank dengan memberikan topik tertentu dan contoh beberapa kali.

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

  • Penyimpanan dan pengambilan 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 Runtime Agen, lingkungan lokal Anda, atau opsi deployment lainnya.

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

    • Masa berlaku otomatis: Menetapkan waktu aktif (TTL) pada memori untuk memastikan informasi yang sudah tidak berlaku akan otomatis dihapus. Konfigurasikan instance Memory Bank Anda sehingga TTL otomatis diterapkan ke memori yang dimasukkan atau dibuat.

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

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

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

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

    • Framework lainnya: Menggabungkan 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 tanpa status menjadi pengalaman kontekstual dengan status, tempat agen mengingat, mempelajari, dan beradaptasi dari waktu ke waktu. Memory Bank ideal untuk aplikasi yang memerlukan:

  • Personalisasi jangka panjang: Membuat pengalaman yang disesuaikan dengan setiap pengguna. Memory Bank mencakup memori ke identitas tertentu, sehingga memungkinkan agen mengingat preferensi, histori, dan detail utama pengguna di beberapa sesi.

    • Contoh: Agen layanan pelanggan yang mengingat informasi penting dari tiket dukungan dan preferensi produk pengguna sebelumnya tanpa perlu bertanya lagi.
  • Ekstraksi pengetahuan berbasis 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 membuat memori gabungan dari temuan, metodologi, dan kesimpulan utama.
  • Konteks dinamis & berkembang: Gunakan Memory Bank saat Anda memerlukan sumber pengetahuan yang tidak statis. Memory Bank dirancang untuk terus mengintegrasikan informasi baru dari agen Anda, menyempurnakan, dan memperbarui memori yang disimpan saat data baru tersedia. Hal ini memastikan konteks yang diandalkan agen Anda selalu terbaru dan akurat. Meskipun RAG memiliki pusat informasi eksternal yang 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 yang disimpan menggunakan proses berikut:

  1. (Sesi) CreateSession: Di awal setiap percakapan, buat sesi baru. Histori percakapan yang digunakan oleh agen dicakup ke 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) akan diupload ke Sesi. Peristiwa ini mempertahankan histori percakapan dan membuat catatan percakapan yang dapat digunakan untuk membuat memori.

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

  4. (Memory Bank) Membuat atau membuat memori:

    • GenerateMemories: Pada interval yang ditentukan (seperti akhir setiap sesi atau akhir setiap giliran), agen dapat memicu pembuatan memori menggunakan histori percakapan. Fakta tentang pengguna akan otomatis diekstrak 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 memiliki kontrol lebih besar 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 memori (pengambilan sederhana) atau hanya memori yang paling relevan dengan percakapan saat ini (pengambilan penelusuran kemiripan). Kemudian, Anda dapat menyisipkan memori 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 Platform Agen tanggung jawab bersama, pertimbangkan risiko injeksi perintah dan peracunan memori yang dapat memengaruhi agen Anda saat menggunakan memori jangka panjang. Peracunan memori terjadi saat informasi palsu disimpan di Memory Bank. Agen kemudian dapat beroperasi pada informasi palsu atau berbahaya ini di sesi mendatang.

Untuk mengurangi risiko peracunan 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: Uji aplikasi LLM Anda secara proaktif untuk menemukan kerentanan injeksi perintah dengan menyimulasikan serangan. Hal ini biasanya dikenal sebagai "red teaming".

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

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.