ניהול זיכרון סביבת העבודה

מדריך זה מראה כיצד לעבוד עם מאגר הידע של סביבת עבודה.

הדבר החשוב לדעת לפני שמתחילים: ממשק הזיכרון הוא משטח סקירה, לא משטח כתיבה. עובדות ומדיניות נכתבות בידי סוכנים — דרך propose_fact ו-propose_policy, כאשר supersede_fact ו-supersede_policy מחליפים אותן. remember כותב פריט בשכבה החמה שתחום לסשן, ש-consolidate_memory עשוי לקדם בהמשך לעובדה. החלטות מפגישות שנרשמו נאספות אל תחום decisions; אין איסוף בהרצות סוכן שהושלמו. מה שאתם עושים כאן הוא לקרוא את מה שהם כתבו, לתקן אותו, להשבית אותו או למחוק אותו.

הזיכרון נמצא בהגדרות → סביבת עבודה → זיכרון (/workspaces/<id>/settings/memory). הוא אינו יעד ברמה העליונה בסרגל הצד.

שלוש הלשוניות

בדף יש בדיוק שלוש לשוניות. עובדות וכללי מדיניות מציגים מונה חי; הגרף לא:

עובדות — כל עובדה בסביבת העבודה, עם מונה של אלה שלא הוחלפו
כללי מדיניות — כללים נורמטיביים המקובצים לפי תחום, עם מונה של הפעילים
גרף ידע — קנבס אינטראקטיבי של תחומים, נושאים, עובדות ומדיניות

תחומים אינם משהו שאתם יוצרים. תחום נוצר כאשר סוכן כותב לתוכו את העובדה או המדיניות הראשונה; אין שום בקרה ליצירת תחום בשום מקום בממשק.

סקירה ותיקון של עובדה

פתחו את הלשונית עובדות.
השתמשו בתיבת החיפוש כדי לצמצם את הרשימה. זהו סינון פשוט של תת־מחרוזת על התחום, הנושא והתוכן של כל עובדה — בלי אינדקס מילות מפתח ובלי דירוג.
השתמשו במסנן הטווח כדי להציג את כל הטווחים, עובדות ברמת סביבת העבודה בלבד, או עובדות של מאגר אחד.
השתמשו במתג המיון כדי לסדר לפי עדכניות או לפי רמת ביטחון.
לחצו על בקרת העריכה של עובדה.

תיבת הדו-שיח לעריכה מאפשרת לשנות:

תחום — העברת עובדה בין תחומים
נושא — התווית הקצרה שלה
תוכן — טקסט הידע
רמת ביטחון — מחוון בצעדים של 5%

שמרו כדי לכתוב אותה בחזרה. אין כפתור הוספת עובדה; תיבת הדו-שיח נפתחת רק על שורה קיימת.

הצגת עובדות שהוחלפו

בלשונית עובדות יש מתג הצג עובדות שהוחלפו. עובדות שהוחלפו מוסתרות כברירת מחדל ונחשפות באמצעות המתג הזה, וזה המקום שבו חי יומן הביקורת — החלפה לעולם אינה מוחקת.

מחיקת עובדה

השתמשו בבקרת המחיקה של עובדה ואשרו. זוהי מחיקה אמיתית, לא החלפה: השתמשו בה בעובדות שפשוט היה שגוי לתעד, והניחו לסוכנים להחליף עובדות שה_תוכן_ שלהן התפתח מאז.

ניהול מדיניות

הלשונית כללי מדיניות מקבצת מדיניות פעילה לפי תחום ומעבירה מדיניות לא פעילה לקטע בסוף. בכל מדיניות תוכלו:

לערוך אותה
למחוק אותה
להשבית / להפעיל אותה — האפשרות הפיכה ובדרך כלל הנכונה. רק מדיניות פעילה מגיעה להנחיות של סוכן.

כמו בעובדות, אין בקרה ליצירה.

חקירת גרף הידע

הלשונית גרף ידע פורשת תחומים, נושאים, עובדות ומדיניות כקנבס צמתים לניווט — הזזה, זום וגרירת צמתים. הקשה על צומת פותחת את גיליון הפרטים שלו, ומשם אפשר להגיע לאותן תיבות דו-שיח לעריכה. זוהי הדרך המהירה ביותר לראות אילו תחומים באמת מאוכלסים.

עריכת זיכרון העבודה של סוכן

זיכרון העבודה הוא פנקס רשימות פרטי לכל סוכן, המוזרק להנחיה שלו בזמן השליחה. הסוכנים כותבים אותו בעצמם באמצעות record_observation ו-update_my_notes, אבל אתם יכולים לקרוא ולערוך אותו ישירות:

הגדרות → סביבת עבודה → סוכנים → בחרו את הסוכן → הלשונית זיכרון.

הענקות גישה

הענקות גישה לזיכרון ממפות תפקיד של סוכן להרשאה (none, read, write) לפי תחום. כתבו אותן עם הפעולות memory_access_grant.*.

שני דברים שכדאי להבין על אופן ההכרעה שלהן:

קריאות הן כשל פתוח. כשאין שורת הענקה עבור צמד (תפקיד, תחום), ההרשאה האפקטיבית היא read. הכתיבה היחידה שזורקת שגיאה בלי write היא propose_policy. כתיבת עובדות אינה מותנית בהענקת גישה.
ההענקות ממופתחות לפי התפקיד של הסוכן. כלי ההצעה משלימים agent_role חסר כברירת מחדל ל-general. הענקה שנכתבה לתפקיד אחר אינה מחייבת את הסוכנים האלה; הענקה של general כן.

החיפוש אינו זהה בכל מקום

שלושה דברים שונים נקראים “חיפוש בזיכרון” והם אינם מסכימים:

היכן	מה זה עושה
תיבת החיפוש בלשונית עובדות	סינון תת־מחרוזת על העובדות שכבר נטענו בלקוח
פעולת ה-RPC של `memory_fact.search`	חיפוש מילות מפתח ב-FTS5 בלבד — לקוח דק אינו יכול לשלוח הטמעת שאילתה, ולכן החיפוש ההיברידי נשאר פנימי למארח
הכלי `search_memory` שבצד הסוכן	`keyword`, `semantic` או `hybrid` (ברירת המחדל). ההיברידי ממזג ארבעה קולות: לקסיקלי, סמנטי, זמני וגרף

לכן סוכן ודף הזיכרון לא ידרגו את אותה שאילתה באותה צורה. כשאתם בודקים מה סוכן באמת מצליח להיזכר בו, שאלו את הסוכן.

הטמעות

עובדות מוטמעות בזמן הכתיבה ורק כשמודל ההטמעה שעל המכשיר מותקן. בדקו את מצבו תחת הגדרות → שרת → אבחון ופרטיות → חיפוש סמנטי. התקינו את המודל לפני שסוכנים מתחילים לכתוב זיכרון אם אתם רוצים שליפה סמנטית.