მეხსიერების ინსტრუმენტები

PRX ხუთ მეხსიერების ინსტრუმენტს გთავაზობთ, რომლებიც აგენტებს ცოდნის საუბრებს შორის შენარჩუნების, შესაბამისი კონტექსტის გამოძახებისა და გრძელვადიანი მეხსიერების საცავის მართვის საშუალებას აძლევს.

მეხსიერების სისტემა სამ ჩაშენებულ კატეგორიას უჭერს მხარს -- core (მუდმივი ფაქტები), daily (სესიაზე მიბმული შენიშვნები) და conversation (ჩატის კონტექსტი) -- პლუს მორგებული კატეგორიები.

კონფიგურაცია

[memory]
backend = "sqlite"              # "markdown" | "sqlite" | "postgres" | "embeddings" | "memory"
auto_save = true                # საუბრის შეტანის ავტომატური შენახვა მეხსიერებაში
acl_enabled = false             # წვდომის კონტროლის სიების ჩართვა
max_recall_items = 20           # გამოძახების/ძიებით დაბრუნებული მაქსიმალური ელემენტები

ინსტრუმენტების მითითება

memory_store

ფაქტის, უპირატესობის ან შენიშვნის შენახვა გრძელვადიან მეხსიერებაში.

{
  "name": "memory_store",
  "arguments": {
    "key": "user_timezone",
    "value": "The user is located in UTC+8 (Asia/Shanghai)",
    "category": "core"
  }
}

პარამეტრი	ტიპი	სავალდებულო	ნაგულისხმევი	აღწერა
key	string	დიახ	--	მეხსიერების ჩანაწერის უნიკალური იდენტიფიკატორი
value	string	დიახ	--	შესანახი კონტენტი
category	string	არა	"core"	კატეგორია: "core", "daily", "conversation" ან მორგებული

კატეგორიები:

კატეგორია	შენარჩუნება	დანიშნულება
core	მუდმივი (ექსპლიციტური წაშლამდე)	ფუნდამენტური ფაქტები, მომხმარებლის უპირატესობები
daily	სესიის ფარგლებში, არქივდება archive_after_days-ის შემდეგ	დღის დავალებები, სესიის შენიშვნები
conversation	მოკლევადიანი, იჭრება conversation_retention_days-ის შემდეგ	მიმდინარე ჩატის კონტექსტი

memory_forget

კონკრეტული ჩანაწერის ამოშლა გრძელვადიანი მეხსიერებიდან გასაღებით.

memory_get

კონკრეტული მეხსიერების ჩანაწერის მიღება ზუსტი გასაღებით. ACL-ის გათვალისწინებით.

memory_recall

მეხსიერებების გამოძახება საკვანძო სიტყვით ან სემანტიკური მსგავსებით. ეს ინსტრუმენტი მთლიანად გამორთულია როცა memory.acl_enabled = true -- რეესტრიდან ამოშლილია.

memory_search

სრულტექსტიანი და ვექტორული ძიება ყველა მეხსიერების ჩანაწერზე. memory_recall-ისგან განსხვავებით, ეს ინსტრუმენტი ACL-ის ჩართვისას ხელმისაწვდომი რჩება, მაგრამ შედეგებზე წვდომის შეზღუდვებს აღასრულებს.

უსაფრთხოება

ACL აღსრულება

როცა memory.acl_enabled = true, მეხსიერების სისტემა წვდომის კონტროლს აღასრულებს:

ინსტრუმენტი	ACL ქცევა
memory_store	ჩანაწერებს მიმდინარე პრინციპალის საკუთრებით ინახავს
memory_forget	მხოლოდ მიმდინარე პრინციპალის საკუთრებაში არსებული ჩანაწერების წაშლას იძლევა
memory_get	მხოლოდ იმ ჩანაწერებს აბრუნებს, რომლებზეც მიმდინარე პრინციპალს წვდომა აქვს
memory_recall	მთლიანად გამორთული (რეესტრიდან ამოშლილი)
memory_search	მხოლოდ იმ ჩანაწერებს აბრუნებს, რომლებზეც მიმდინარე პრინციპალს წვდომა აქვს

დაკავშირებული გვერდები

• მეხსიერების სისტემა -- არქიტექტურა და შენახვის ბექენდები
• ფაილის ოპერაციები -- ACL ინტერაქცია file_read-თან
• ინსტრუმენტების მიმოხილვა -- ყველა ინსტრუმენტი და რეესტრის სისტემა