Agent Platform Memory Bank otomatis mempertahankan histori versi memori Anda melalui resource revisi memori. Setiap kali memori dibuat atau diubah, revisi baru yang tidak dapat diubah akan disimpan, sehingga memberikan transparansi tentang cara informasi berkembang dan apa yang diekstrak di setiap langkah.
Dokumen ini menjelaskan siklus proses memori dan revisinya, serta menjelaskan operasi seperti mencantumkan, mendapatkan, dan me-roll back revisi.
Untuk mengetahui informasi selengkapnya tentang cara membuat kenangan, lihat Membuat kenangan.
Siklus proses memori dan revisinya

Memori dapat dibuat, diperbarui, atau dihapus secara langsung (masing-masing menggunakan
CreateMemory, UpdateMemory, atau DeleteMemory) atau secara dinamis
(menggunakan GenerateMemories). Resource revisi memori menyediakan histori versi lengkap
dari resource memori di semua operasi mutasi. Revisi baru yang tidak dapat diubah akan otomatis disimpan setiap kali memori dibuat atau diubah. Hal ini memberi Anda transparansi tentang bagaimana memori telah berkembang dan (untuk
pembuatan memori) informasi spesifik apa yang diekstrak dan digabungkan pada
setiap langkah.
Setiap resource memori memiliki satu atau beberapa resource revisi memori turunan terkait:
Resource
Memoryselalu mencerminkan status informasi saat ini yang digabungkan. Satu memori dapat mencerminkan data turunan dari beberapa permintaan dan sumber data.Memory( create_time=datetime.datetime(...), fact='This is my current memory content after consolidation', name='projects/.../locations/.../reasoningEngines/../memories/...', scope={ 'my_scope_key': 'my_scope_value' }, topics=[ MemoryTopicId( managed_memory_topic=<ManagedTopicEnum.USER_PERSONAL_INFO: 'USER_PERSONAL_INFO'> ), ], update_time=datetime.datetime(...) )Resource
MemoryRevisionsmewakili status historis memori induk. Setiap revisi adalah snapshot memori pada peristiwa mutasi. Jika memori diubah menggunakanGenerateMemories, revisi juga menyertakan informasi yang diekstrak dari sumber data (extracted_memories) sebelum digabungkan dengan konten memori yang ada.MemoryRevision( create_time=datetime.datetime(...), expire_time=datetime.datetime(...), extracted_memories=[ IntermediateExtractedMemory( fact='This information was extracted from my data source' ), ], fact='This is my current memory content after consolidation', name='projects/.../locations/.../reasoningEngines/.../memories/.../revisions/...' )Revisi memori diaktifkan secara default. Untuk menonaktifkan revisi memori, lihat Menonaktifkan revisi memori.
Pembuatan memori
Memori dapat dibuat secara langsung menggunakan CreateMemory atau secara dinamis
menggunakan GenerateMemories. Dengan pembuatan memori, memori akan dibuat jika tidak ada memori yang mencakup informasi serupa untuk cakupan yang sama:
# Direct creation using CreateMemory
client.memory_banks.memories.create(name=memory_bank_name, ...)
# Dynamic creation using GenerateMemory
client.memory_banks.memories.generate(name=memory_bank_name, ...)
Saat memori dibuat, satu resource Memory dan MemoryRevision turunan akan dibuat:
client.memory_banks.memories.get(name=memory_name)
"""
Memory(
name="projects/123/locations/us-central1/reasoningEngines/456/memories/789",
fact="This is my original fact.",
...
)
"""
list(client.memory_banks.memories.revisions.list(name=memory_name))
"""
[
MemoryRevision(
name="projects/123/locations/us-central1/reasoningEngines/456/memories/789/revision/123",
fact="This is my original fact",
...
)
]
"""
Pembaruan memori
Memori dapat diperbarui secara langsung menggunakan UpdateMemory atau secara dinamis
menggunakan GenerateMemories. Dengan pembuatan memori, memori diperbarui secara dinamis saat proses konsolidasi memutuskan bahwa informasi baru bersifat duplikatif, melengkapi, atau bertentangan dengan semua memori yang ada untuk cakupan yang sama.
# Direct update using UpdateMemory
client.memory_banks.memories.update(name=memory_name, ...)
# Dynamic update using GenerateMemories
client.memory_banks.memories.generate(name=memory_bank_name, ...)
Saat memori diperbarui, resource Memory yang ada akan diperbarui, dan MemoryRevision turunan baru akan dibuat.
client.memory_banks.memories.get(name=memory_name)
"""
Memory(
name="projects/123/locations/us-central1/reasoningEngines/456/memories/789",
fact="This is my updated fact.",
...
)
"""
list(client.memory_banks.memories.revisions.list(name=memory_name))
"""
[
MemoryRevision(
name="projects/123/locations/us-central1/reasoningEngines/456/memories/789/revision/456",
fact="This is my updated fact",
...
),
MemoryRevision(
name="projects/123/locations/us-central1/reasoningEngines/456/memories/789/revision/123",
fact="This is my original fact",
...
)
]
"""
Penghapusan memori
Memori dapat digunakan secara langsung menggunakan DeleteMemory atau secara dinamis menggunakan GenerateMemories. Dengan pembuatan memori, memori akan dihapus secara dinamis
saat proses konsolidasi memutuskan bahwa informasi baru
membatalkan informasi yang ada untuk cakupan yang sama.
# Direct deletion using UpdateMemory
client.memory_banks.memories.delete(name=memory_name, ...)
# Dynamic delete using GenerateMemories
client.memory_banks.memories.generate(name=memory_bank_name, ...)
Saat memori dihapus, resource Memory yang ada akan dihapus, dan MemoryRevision turunan baru akan dibuat. fact dalam revisi memori terbaru kosong karena mencerminkan mutasi penghapusan.
client.memory_banks.memories.get(name=memory_name)
"""
404 Not Found.
"""
list(client.memory_banks.memories.revisions.list(name=memory_name))
"""
[
MemoryRevision(
name="projects/123/locations/us-central1/reasoningEngines/456/memories/789/revision/789",
fact="",
...
),
MemoryRevision(
name="projects/123/locations/us-central1/reasoningEngines/456/memories/789/revision/456",
fact="This is my updated fact",
...
),
MemoryRevision(
name="projects/123/locations/us-central1/reasoningEngines/456/memories/789/revision/123",
fact="This is my original fact",
...
)
]
"""
Revisi memori turunan hanya dapat diakses hingga 48 jam setelah penghapusan memori induk. Selama periode pemulihan ini, Anda dapat terus memeriksa revisi memori, dan Anda dapat memulihkan memori dengan me-roll back ke revisi sebelumnya.
Operasi revisi memori
Bagian ini menjelaskan cara memeriksa revisi memori dan me-roll back memori ke revisi sebelumnya.
Mencantumkan revisi
Anda dapat memeriksa revisi memori di konsol Google Cloud atau dengan Agent Platform SDK.
Konsol
Untuk melihat revisi memori di konsol Google Cloud , Anda memerlukan
izin aiplatform.memoryRevisions.list (disertakan dalam
roles/aiplatform.memoryViewer dan roles/aiplatform.memoryUser) dan tidak
tersedia dalam mode ekspres.
Buka instance Anda di konsol Google Cloud :
Instance Memory Bank mandiri: Buka halaman Memory Bank Agent Platform dan klik instance Anda.
Agen yang di-deploy di Agent Runtime: Buka halaman Deployments Agent Platform, lalu klik agen Anda.
Buka tab Kenangan:
- Memori tidak terstruktur: Di baris memori, klik menu tindakan lainnya () > Lihat revisi.
- Profil terstruktur (instance mandiri): Pilih Terstruktur, pilih cakupan lengkap, klik Lihat pada baris profil untuk membuka Detail memori, lalu klik Lihat revisi untuk fakta memori.
Panel revisi mencantumkan kolom Created, Expires, Fact, dan Context untuk setiap revisi.
Agent Platform SDK
Gunakan ListMemoryRevisions untuk menampilkan semua revisi memori yang termasuk dalam
memori.
list(client.memory_banks.memories.revisions.list(name=MEMORY_NAME))
Ganti kode berikut:
MEMORY_NAME: Nama resource memori dalam format:projects/.../locations/.../reasoningEngines/.../memories/...
Saat membuat memori, Anda dapat memberikan label revisi yang diterapkan ke revisi yang berafiliasi. Label adalah pasangan nilai kunci arbitrer. Misalnya, Anda dapat memberi label pada revisi dengan ID sumber data yang digunakan untuk membuat memori, lalu memfilter revisi berdasarkan label ini:
response = client.memory_banks.memories.generate(
...,
config={
"revision_labels": {
"data_source": "321"
}
}
)
list(client.memory_banks.memories.revisions.list(
name=MEMORY_NAME,
config={
"filter": "labels.data_source=\"321\""
}
))
"""
[
MemoryRevision(
name="projects/123/locations/us-central1/reasoningEngines/456/memories/789/revision/123",
labels={
"data_source": "123"
}
...
)
]
"""
Mendapatkan revisi
Gunakan GetMemoryRevision untuk mengambil revisi memori satu per satu.
client.memory_banks.memories.revisions.get(name=MEMORY_REVISION_NAME)
Ganti kode berikut:
MEMORY_REVISION_NAME: Nama resource revisi memori yang akan diambil dalam format:projects/.../locations/.../reasoningEngines/.../memories/.../revisions/...
Me-roll back memori
Gunakan RollbackMemory untuk melakukan roll back memori ke revisi sebelumnya.
client.memory_banks.memories.rollback(
name="MEMORY_NAME",
target_revision_id="REVISION_ID"
)
Ganti kode berikut:
MEMORY_NAME: Nama resource memori yang akan diperbarui dalam format:projects/.../locations/.../reasoningEngines/.../memories/...REVISION_ID: ID revisi yang harus di-roll back. Ini adalah segmen terakhir dari nama resource revisi memori, seperti789diprojects/MyProject/locations/us-central1/reasoningEngines/123/memories/456/revisions/789.
Jika Anda ingin mengurungkan perubahan pada memori yang dibuat oleh GenerateMemories, kembalikan
memori ke revisinya sebelum perubahan. Respons pembuatan memori
menyertakan referensi ke revisi sebelumnya (previous_revision) untuk setiap
memori yang diperbarui atau dihapus:
operation = client.memory_banks.memories.generate(
...
)
# Rollback the first generated memory to the previous revision.
client.memory_banks.memories.rollback(
name=operation.response.generated_memories[0].memory.name,
target_revision_id=operation.response.generated_memories[0].previous_revision
)
Menonaktifkan revisi memori
Revisi memori diaktifkan secara default. Anda dapat menonaktifkan revisi memori untuk semua permintaan ke instance Memory Bank Anda atau untuk setiap permintaan individual. Jika revisi memori dinonaktifkan, revisi memori tidak akan dibuat saat memori diubah.
Anda dapat menonaktifkan revisi memori untuk semua permintaan ke instance Memory Bank di konsol Google Cloud (di bagian Configuration > Retention, atau Service configuration > Memory bank untuk agen yang di-deploy) atau dengan Agent Platform SDK:
memory_bank = client.memory_banks.create(
managed_semantic_memory_config={
"disable_memory_revisions": True
}
)
Anda dapat menonaktifkan revisi memori di tingkat permintaan saat mengirim permintaan:
Buat
client.memory_banks.memories.generate(
...,
"config": {
"disable_memory_revisions": True
}
)
Buat
client.memory_banks.memories.create(
...,
"config": {
"disable_memory_revisions": True
}
)
Perbarui
client.memory_banks.memories.update(
...,
"config": {
"disable_memory_revisions": True
}
)
Masa berlaku revisi
Revisi memori tidak disimpan selamanya. Anda harus menetapkan masa berlaku revisi atau menggunakan masa berlaku default. Time to live (TTL) default adalah 365 hari. Anda dapat mengonfigurasi masa berlaku untuk semua permintaan ke instance Memory Bank atau untuk setiap permintaan. Setelah masa berlaku revisi memori berakhir, revisi tersebut tidak tersedia untuk pemeriksaan atau rollback.
Anda dapat mengonfigurasi TTL histori revisi untuk semua permintaan ke instance Memory Bank di konsol Google Cloud (di bagian Configuration > Retention, atau Service configuration > Memory bank untuk agen yang di-deploy) atau dengan Agent Platform SDK:
client.memory_banks.create(
managed_semantic_memory_config={
"ttl_config": {
# Persist memory revisions for 30 days after they're created.
"revision_ttl": f"{30 * 60 * 60 * 24}s"
}
}
)
Untuk mengonfigurasi TTL untuk setiap revisi memori di tingkat permintaan, sertakan
revision_expire_time atau revision_ttl dalam permintaan Anda:
TTL
config = {
# Persist memory revisions for 30 days after they're created.
"revision_ttl": f"{30 * 60 * 60 * 24}s"
}
client.memory_banks.memories.create(
...,
config=config
)
client.memory_banks.memories.update(
...,
config=config
)
client.memory_banks.memories.generate(
...,
config=config
)
Akhir masa berlaku
import datetime
config = {
"revision_expire_time": datetime.datetime.now(tz=datetime.timezone.utc) + datetime.timedelta(weeks=3)
}
client.memory_banks.memories.create(
...,
config=config
)
client.memory_banks.memories.update(
...,
config=config
)
client.memory_banks.memories.generate(
...,
config=config
)