Lucid.so მეხსიერების ბექენდი

Lucid ბექენდი PRX-ს Lucid.so-სთან აკავშირებს -- AI-ით გაძლიერებულ მეხსიერების სერვისთან, რომელიც უზრუნველყოფს მართულ საცავს, სემანტიკურ ძიებასა და ავტომატურ მეხსიერების ორგანიზაციას. იგი ემსახურება ლოკალური SQLite-ისა და PostgreSQL ბექენდების ალტერნატივას გუნდებისთვის, რომლებიც ჰოსტირებულ გადაწყვეტას ანიჭებენ უპირატესობას.

მიმოხილვა

Lucid.so არის ღრუბელში ჰოსტირებული მეხსიერების პლატფორმა, რომელიც AI აგენტებისთვის არის დაპროექტებული. იგი ამუშავებს:

• მუდმივ მეხსიერების საცავს ავტომატური დედუპლიკაციით
• სემანტიკურ ძიებას ჰოსტირებული ემბედინგ მოდელებით
• ავტომატურ თემატურ კლასტერიზაციასა და მეხსიერების ორგანიზაციას
• სესიათაშორის მეხსიერების გაზიარებას მრავალ აგენტის ინსტანციას შორის
• მეხსიერების სასიცოცხლო ციკლის მართვას კონფიგურირებადი შენახვის პოლიტიკებით

ლოკალური ბექენდებისგან (SQLite, PostgreSQL) განსხვავებით, Lucid არ მოითხოვს მონაცემთა ბაზის მართვას. მოგონებები Lucid-ის ინფრასტრუქტურაში ინახება და მათ REST API-ით წვდებიან.

როდის გამოვიყენოთ Lucid

სცენარი	რეკომენდებული ბექენდი
ერთ-მომხმარებლიანი ლოკალური აგენტი	SQLite
მრავალ-მომხმარებლიანი ლოკალური განთავსება	PostgreSQL
ღრუბლისთვის ორიენტირებული გუნდი, მინიმალური ოპერაციების ოვერჰედი	Lucid
მოწყობილობათაშორისი მეხსიერების გაზიარება	Lucid
იზოლირებული ან ოფლაინ გარემოები	SQLite ან PostgreSQL
მონაცემთა რეზიდენტობის სრული კონტროლი	SQLite ან PostgreSQL

წინაპირობები

• Lucid.so ანგარიში (რეგისტრაცია lucid.so-ზე)
• API გასაღები Lucid-ის დაშბორდიდან
• სამუშაო სივრცის ID (ავტომატურად იქმნება პირველ გამოყენებაზე, ან მიუთითეთ არსებული)

სწრაფი დაყენება

1. API სანდოობის მონაცემების მიღება

1. შესვლა Lucid-ის დაშბორდში
2. გადასვლა "Settings" -> "API Keys"
3. ახალი API გასაღების შექმნა "Memory Read/Write" ნებართვებით
4. API გასაღებისა და სამუშაო სივრცის ID-ის კოპირება

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

[memory]
backend = "lucid"

[memory.lucid]
api_key = "luc_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
workspace_id = "ws_abc123"

3. შემოწმება

prx doctor memory

ეს ტესტავს Lucid API-სთან კავშირს და ამოწმებს, რომ API გასაღებს საჭირო ნებართვები აქვს.

კონფიგურაციის მითითება

ველი	ტიპი	ნაგულისხმევი	აღწერა
api_key	String	სავალდებულო	Lucid.so API გასაღები მეხსიერების წაკითხვის/ჩაწერის ნებართვებით
workspace_id	String	ავტო-შექმნა	სამუშაო სივრცის ID მეხსიერების იზოლაციისთვის. გამოტოვეთ ავტო-შექმნისთვის
base_url	String	"https://api.lucid.so/v1"	Lucid API-ის საბაზისო URL. გადაფარეთ თვით-ჰოსტირებული ან რეგიონული ენდფოინთებისთვის
timeout_secs	u64	30	HTTP მოთხოვნის ტაიმაუტი წამებში
max_retries	u32	3	მაქსიმალური ხელახალი მცდელობები წარმავალი შეცდომებისთვის
retry_backoff_ms	u64	500	საწყისი შეყოვნების დაყოვნება ხელახალ მცდელობებს შორის (ექსპონენციური)
batch_size	usize	50	მოგონებების რაოდენობა ჯგუფური ჩაწერის მოთხოვნაზე
top_k	usize	10	გახსენების შეკითხვებისთვის დასაბრუნებელი შედეგების ნაგულისხმევი რაოდენობა
similarity_threshold	f64	0.5	მინიმალური მსგავსების ქულა (0.0--1.0) გახსენების შედეგებისთვის
auto_topics	bool	true	Lucid-ის ავტომატური თემატური კლასტერიზაციის ჩართვა
retention_days	u64	0	N დღეზე ძველი მოგონებების ავტო-წაშლა. 0 = სამუდამოდ შენახვა

როგორ მუშაობს

მეხსიერების შენახვა

აგენტის მიერ მოგონების შენახვისას, PRX მას Lucid API-ს უგზავნის:

1. მეხსიერების ტექსტი და მეტამონაცემები POST მოთხოვნით იგზავნება /memories-ზე
2. Lucid ტექსტს ემბედირებს თავისი ჰოსტირებული ემბედინგ მოდელით
3. მოგონება ინდექსირდება საკვანძო სიტყვებისა და სემანტიკური ძიებისთვის
4. auto_topics-ის ჩართვისას, Lucid ავტომატურად ანიჭებს თემატურ ეტიკეტებს

მეხსიერების გახსენება

აგენტისთვის კონტექსტის საჭიროებისას, PRX Lucid-ს იკითხავს:

1. მიმდინარე საუბრის კონტექსტი გახსენების შეკითხვის სახით იგზავნება
2. Lucid ჰიბრიდულ ძიებას ახორციელებს (სემანტიკური მსგავსება + საკვანძო სიტყვების შედარება)
3. შედეგები რანჟირდება შესაბამისობით და ფილტრდება similarity_threshold-ით
4. top-K შედეგები ბრუნდება მათი ტექსტით, მეტამონაცემებითა და შესაბამისობის ქულებით

მეხსიერების ორგანიზაცია

Lucid უზრუნველყოფს სერვერის მხრიდან მეხსიერების მართვას:

• დედუპლიკაცია -- თითქმის-დუბლიკატი მოგონებები ავტომატურად ერწყმის
• თემატური კლასტერიზაცია -- მოგონებები ჯგუფდება თემებად ხელით კატეგორიზაციის გარეშე
• შეკუმშვა -- ძველი ან დაბალი შესაბამისობის მოგონებები შეიძლება შეჯამდეს და გაერთიანდეს
• შენახვა -- ვადაგასული მოგონებები წაიშლება retention_days-ის მიხედვით

შედარება ლოკალურ ბექენდებთან

ფუნქცია	SQLite	PostgreSQL	Lucid
დაყენების სირთულე	არცერთი	საშუალო	მინიმალური (API გასაღები)
მონაცემთა რეზიდენტობა	ლოკალური	თვით-ჰოსტირებული	ღრუბელი (Lucid სერვერები)
სემანტიკური ძიება	ემბედინგების დანამატით	pgvector დანამატით	ჩაშენებული
ავტო-დედუპლიკაცია	არა	არა	დიახ
ავტო-თემატური კლასტერიზაცია	არა	არა	დიახ
მოწყობილობათაშორისი გაზიარება	არა	დიახ (ქსელი)	დიახ (ღრუბელი)
ოფლაინ ოპერაცია	დიახ	დიახ	არა
ღირებულება	უფასო	უფასო (თვით-ჰოსტირებული)	უფასო დონე + ფასიანი გეგმები
მასშტაბურობა	~100K მოგონება	მილიონები	მილიონები (მართული)

გარემოს ცვლადები

CI/CD ან კონტეინერიზებული განთავსებებისთვის, სანდოობის მონაცემები გარემოს ცვლადებით შეიძლება მითითდეს:

export PRX_MEMORY_LUCID_API_KEY="luc_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export PRX_MEMORY_LUCID_WORKSPACE_ID="ws_abc123"

გარემოს ცვლადები უპირატესობას იღებს კონფიგურაციის ფაილის მნიშვნელობებზე.

შეცდომების დამუშავება

Lucid ბექენდი წარმავალ შეცდომებს გრაციოზულად ამუშავებს:

• ქსელის შეცდომები -- ხელახლა ცდება max_retries-ჯერ ექსპონენციური შეყოვნებით
• სიჩქარის შეზღუდვა -- 429 პასუხები ავტომატურ შეყოვნებას იწვევს Retry-After ჰედერის გამოყენებით
• ავთენტიფიკაციის შეცდომები -- ლოგირდება შეცდომებად; აგენტი გააგრძელებს მუშაობას მეხსიერების გარეშე ავარიის ნაცვლად
• ტაიმაუტი -- timeout_secs-ის გადამეტებული მოთხოვნები უქმდება და ხელახლა ცდება

Lucid-ის მიუწვდომლობისას, PRX გრაციოზულად დეგრადირდება: აგენტი მეხსიერების გახსენების გარეშე მუშაობს კავშირის აღდგენამდე. მოგონებები არ იკარგება -- მომლოდინე ჩაწერები რიგში დგება და კავშირის აღდგენისას იგზავნება.

შეზღუდვები

• მოითხოვს ინტერნეტ კავშირს; არ არის შესაფერისი იზოლირებული გარემოებისთვის
• მეხსიერების მონაცემები Lucid-ის ინფრასტრუქტურაში ინახება; გადახედეთ მათ მონაცემთა დამუშავების შეთანხმებას შესაბამისობისთვის
• უფასო დონეს აქვს საცავისა და შეკითხვების ლიმიტები (იხილეთ Lucid-ის ფასების გვერდი მიმდინარე დეტალებისთვის)
• შეყოვნება უფრო მაღალია ვიდრე ლოკალურ ბექენდებში ქსელის მრგვალი მოგზაურობის გამო (ტიპიურად 50--200ms შეკითხვაზე)
• თვით-ჰოსტირებული Lucid-ის განთავსებები ცალკე ლიცენზიას მოითხოვს

პრობლემების მოგვარება

"Authentication failed" შეცდომა

• შეამოწმეთ API გასაღების სისწორე და რომ არ არის გაუქმებული Lucid-ის დაშბორდში
• უზრუნველყავით, რომ API გასაღებს აქვს "Memory Read/Write" ნებართვები
• შეამოწმეთ, რომ base_url სწორ Lucid ენდფოინთზე მიუთითებს

მეხსიერების გახსენება შედეგებს არ აბრუნებს

• შეამოწმეთ მოგონებების შენახვა Lucid-ის დაშბორდში
• შეამცირეთ similarity_threshold (მაგ., 0.3-მდე), რათა ნახოთ, ფილტრდება თუ არა შედეგები
• შეამოწმეთ, რომ workspace_id ემთხვევა სამუშაო სივრცეს, სადაც მოგონებები შეინახა

გახსენების შეკითხვებზე მაღალი შეყოვნება

• შეამცირეთ top_k, რათა ნაკლები შედეგი დაბრუნდეს შეკითხვაზე
• შეამოწმეთ ქსელის შეყოვნება Lucid API ენდფოინთისთვის
• განიხილეთ რეგიონული base_url-ის გამოყენება, თუ Lucid თქვენს განთავსებასთან უფრო ახლოს ენდფოინთებს გვთავაზობს

მოგონებები სესიებს შორის არ ინახება

• დაადასტურეთ, რომ backend = "lucid" დაყენებულია [memory] სექციაში
• შეამოწმეთ workspace_id-ის თანმიმდევრულობა ყველა აგენტის ინსტანციას შორის
• შეამოწმეთ PRX-ის ლოგები ჩაწერის შეცდომებისთვის, რომლებიც შეიძლება წარუმატებელ შენახვაზე მიუთითებდეს

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

• მეხსიერების სისტემის მიმოხილვა
• SQLite ბექენდი -- ლოკალური ერთ-ფაილიანი ალტერნატივა
• PostgreSQL ბექენდი -- თვით-ჰოსტირებული მრავალ-მომხმარებლიანი ალტერნატივა
• ემბედინგების ბექენდი -- ლოკალური ვექტორზე დაფუძნებული სემანტიკური მეხსიერება
• მეხსიერების ჰიგიენა -- შეკუმშვისა და გასუფთავების სტრატეგიები