Memory Bank של Agent Platform שומר באופן אוטומטי את היסטוריית הגרסאות של הזיכרונות באמצעות משאבים של גרסאות זיכרון. בכל פעם שנוצר או משתנה זיכרון, נשמרת גרסה חדשה שלא ניתנת לשינוי. כך אפשר לראות איך המידע מתפתח ומה חולץ בכל שלב.
במסמך הזה מוסבר מחזור החיים של הזיכרונות והגרסאות שלהם, ומתוארות פעולות כמו הצגת רשימה של גרסאות, קבלת גרסאות והחזרת גרסאות למצב קודם.
מחזור החיים של זיכרון והגרסאות שלו

אפשר ליצור, לעדכן או למחוק זיכרונות באופן ישיר (באמצעות CreateMemory, UpdateMemory או DeleteMemory, בהתאמה) או באופן דינמי (באמצעות GenerateMemories). משאבי גרסאות הזיכרון מספקים היסטוריית גרסאות מלאה של משאב זיכרון בכל פעולות המוטציה. גרסה חדשה ובלתי ניתנת לשינוי נשמרת באופן אוטומטי בכל פעם שיוצרים או משנים את הזיכרון. כך אתם יכולים לראות איך הזיכרון התפתח ואיזה מידע ספציפי חולץ ואוחד בכל שלב (בתהליך יצירת הזיכרון).
לכל משאב זיכרון יש משאב צאצא אחד או יותר של גרסת זיכרון:
משאבי
Memoryתמיד משקפים את המצב הנוכחי והמאוחד של המידע. פריט זיכרון אחד יכול לשקף נתונים שנאספו מכמה בקשות ומקורות נתונים.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(...) )משאבי
MemoryRevisionsמייצגים את המצבים ההיסטוריים של הזיכרון של ההורה. כל גרסה היא תמונת מצב של הזיכרון באירוע Mutation. אם זיכרון השתנה באמצעותGenerateMemories, הגרסה כוללת גם את המידע שנשלף ממקור הנתונים (extracted_memories) לפני שהוא אוחד עם התוכן הקיים של הזיכרון.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/...' )גרסאות הזיכרון מופעלות כברירת מחדל. כדי להשבית את גרסאות הזיכרון, קראו את המאמר השבתת גרסאות הזיכרון.
יצירת זיכרון
אפשר ליצור זיכרונות ישירות באמצעות CreateMemory או באופן דינמי באמצעות GenerateMemories. בתהליך יצירת הזיכרון, נוצר זיכרון אם אין זיכרונות קיימים שכוללים מידע דומה באותו היקף:
# 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, ...)
כשיוצרים זיכרון, נוצרים משאב Memory אחד ומשאב צאצא אחד מסוג MemoryRevision:
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",
...
)
]
"""
עדכון הזיכרון
אפשר לעדכן את הזיכרונות ישירות באמצעות UpdateMemory או באופן דינמי באמצעות GenerateMemories. בתהליך יצירת הזיכרון, הזיכרונות מתעדכנים באופן דינמי כשתהליך האיחוד קובע שהמידע החדש הוא כפול, משלים או סותר את כל הזיכרונות הקיימים באותו היקף.
# 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, ...)
כשמעדכנים זיכרון, המשאב הקיים Memory מתעדכן ונוצר משאב צאצא חדש MemoryRevision.
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",
...
)
]
"""
מחיקת הזיכרון
אפשר להגדיר זיכרונות באופן ישיר באמצעות DeleteMemory או באופן דינמי באמצעות GenerateMemories. כשמופעלת יצירת זיכרון, הזיכרונות נמחקים באופן דינמי אם בתהליך האיחוד נקבע שהמידע החדש מבטל את המידע הקיים באותו היקף.
# 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, ...)
כשמוחקים זיכרון, המשאב הקיים Memory נמחק ונוצר צאצא חדש MemoryRevision. השדה fact בגרסת הזיכרון האחרונה ריק כי הוא משקף מוטציית מחיקה.
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",
...
)
]
"""
אפשר לגשת לגרסאות הזיכרון של הצאצא רק עד 48 שעות אחרי מחיקת הזיכרון הראשי. במהלך חלון הזמן הזה, אתם יכולים להמשיך לבדוק את גרסאות הזיכרון ולשחזר את הזיכרון על ידי חזרה לגרסה קודמת.
פעולות בגרסאות הזיכרון
בקטע הזה מוסבר איך לבדוק גרסאות של זיכרון ואיך לחזור לגרסה קודמת.
רשימת גרסאות
אתם יכולים לבדוק את גרסאות הזיכרון במסוף Google Cloud או באמצעות Agent Platform SDK.
המסוף
כדי לראות את גרסאות הזיכרון במסוף Google Cloud , צריך את ההרשאה aiplatform.memoryRevisions.list (שכלולה בתפקידים roles/aiplatform.memoryViewer ו-roles/aiplatform.memoryUser). אי אפשר לראות את גרסאות הזיכרון במצב אקספרס.
פותחים את המכונה במסוף Google Cloud :
מכונה נפרדת של Memory Bank: נכנסים לדף Memory Bank ב-Agent Platform ולוחצים על המכונה.
סוכן שנפרס ב-Agent Runtime: נכנסים לדף Deployments ב-Agent Platform ולוחצים על הסוכן.
פותחים את הכרטיסייה זיכרונות:
- זיכרונות לא מובנים: בשורת הזיכרון, לוחצים על תפריט הפעולות הנוספות () > הצגת הגרסאות.
- פרופילים מובְנים (מופעים נפרדים): בוחרים באפשרות מובְנה, בוחרים היקף מלא, לוחצים על הצגה בשורה של פרופיל כדי לפתוח את פרטי הזיכרון, ולוחצים על הצגת הגרסאות של עובדה בזיכרון.
בחלונית הגרסאות מפורטים השדות Created, Expires, Fact ו-Context של כל גרסה.
Agent Platform SDK
כדי להחזיר את כל גרסאות הזיכרון ששייכות לזיכרון מסוים, משתמשים ב-ListMemoryRevisions.
list(client.memory_banks.memories.revisions.list(name=MEMORY_NAME))
מחליפים את מה שכתוב בשדות הבאים:
-
MEMORY_NAME: שם המשאב של הזיכרון בפורמט:projects/.../locations/.../reasoningEngines/.../memories/...
כשיוצרים זיכרונות, אפשר לספק תוויות לגרסאות שיוחלו על הגרסאות המשויכות. תוויות הן צמדי מפתח/ערך שרירותיים. לדוגמה, אפשר לתייג גרסאות עם מזהה של מקור הנתונים ששימש ליצירת הזיכרון, ואז לסנן את הגרסאות לפי התווית הזו:
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"
}
...
)
]
"""
קבלת גרסה חדשה
משתמשים ב-GetMemoryRevision כדי לאחזר גרסת זיכרון ספציפית.
client.memory_banks.memories.revisions.get(name=MEMORY_REVISION_NAME)
מחליפים את מה שכתוב בשדות הבאים:
-
MEMORY_REVISION_NAME: שם המשאב של גרסת הזיכרון שרוצים לאחזר, בפורמט:projects/.../locations/.../reasoningEngines/.../memories/.../revisions/...
איך מחזירים זיכרון למצב הקודם
אפשר להשתמש ב-RollbackMemory כדי להחזיר זיכרון לגרסה קודמת.
client.memory_banks.memories.rollback(
name="MEMORY_NAME",
target_revision_id="REVISION_ID"
)
מחליפים את מה שכתוב בשדות הבאים:
MEMORY_NAME: שם המשאב של הזיכרון שרוצים לעדכן, בפורמט:projects/.../locations/.../reasoningEngines/.../memories/...
REVISION_ID: המזהה של הגרסה שרוצים לחזור אליה. זה החלק האחרון בשם המשאב של גרסת הזיכרון, כמו789ב-projects/MyProject/locations/us-central1/reasoningEngines/123/memories/456/revisions/789.
אם אתם רוצים לבטל שינוי ש-GenerateMemories ביצע בזיכרון, אתם יכולים להחזיר את הזיכרון לגרסה שלפני השינוי. התשובה של תהליך יצירת הזיכרון כוללת הפניה לגרסה הקודמת (previous_revision) לכל זיכרון שעודכן או נמחק:
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
)
השבתת גרסאות הזיכרון
גרסאות הזיכרון מופעלות כברירת מחדל. אתם יכולים להשבית את גרסאות הזיכרון לכל הבקשות למכונה של Memory Bank או לכל בקשה בנפרד. אם גרסאות הזיכרון מושבתות, לא נוצרת גרסת זיכרון כשהזיכרון משתנה.
אתם יכולים להשבית את גרסאות הזיכרון לכל הבקשות למכונה של Memory Bank במסוף Google Cloud (בקטע Configuration > Retention, או בקטע Service configuration > Memory bank לסוכנים שנפרסו) או באמצעות Agent Platform SDK:
memory_bank = client.memory_banks.create(
managed_semantic_memory_config={
"disable_memory_revisions": True
}
)
אתם יכולים להשבית את גרסאות הזיכרון ברמת הבקשה כשאתם שולחים את הבקשה:
יצירה
client.memory_banks.memories.generate(
...,
"config": {
"disable_memory_revisions": True
}
)
יצירה
client.memory_banks.memories.create(
...,
"config": {
"disable_memory_revisions": True
}
)
עדכון
client.memory_banks.memories.update(
...,
"config": {
"disable_memory_revisions": True
}
)
תאריך התפוגה של הגרסה
גרסאות הזיכרון לא נשמרות לתמיד. צריך להגדיר את תאריך התפוגה של הגרסאות או להשתמש בתאריך התפוגה שמוגדר כברירת מחדל. אורך החיים (TTL) שמוגדר כברירת מחדל הוא 365 ימים. אתם יכולים להגדיר את התפוגה לכל הבקשות למכונה של Memory Bank או לכל בקשה בנפרד. אחרי שתוקף גרסת הזיכרון פג, אי אפשר לבדוק אותה או לחזור אליה.
אפשר להגדיר את משך החיים של היסטוריית הגרסאות לכל הבקשות למכונה של Memory Bank במסוף Google Cloud (בקטע Configuration > Retention, או בקטע Service configuration > Memory bank לסוכנים שנפרסו) או באמצעות 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"
}
}
)
כדי להגדיר TTL לכל גרסת זיכרון ברמת הבקשה, צריך לכלול את revision_expire_time או את revision_ttl בבקשה:
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
)
תפוגה
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
)