التوثيق

الذاكرة

الذاكرة محلية مئة بالمئة: ضمّين BGE-M3 في حاوية مخصصة، والنص في pgvector داخل PostgreSQL خاصتنا. لا شيء يُرسَل لنموذج خارجي. المقيس: ‏hit@1 = 19/25‏ إجمالًا و8/10 في العامية المصرية (تقييم P2.5).

POST /v1/memory/write api-key · memory:write #

يخزّن نصًا في ذاكرتك الخاصة. تُزال التكرارات ببصمة النص المطبَّع — إعادة كتابة النص نفسه تحدّثه.

الطلب

الحقلالنوعالوصف
itemsarrayمطلوبمصفوفة عناصر للتخزين (64 كحد أقصى في الطلب).
items[].textstringمطلوبالنص المُراد تذكّره.
items[].sourceUrlstringاختياريعنوان المصدر اختياريًا للإسناد.
items[].tagsstring[]اختياريوسوم اختيارية لاسترجاع مُرشّح.

مثال

curl -X POST https://agw.orcanox.xyz/v1/memory/write \
  -H "Authorization: Bearer agw_…" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"text":"The renewal price is $90/year","sourceUrl":"https://example.com/pricing","tags":["pricing"]}]}'

الاستجابة

json
{
  "written": 2,
  "updated": 0,
  "ids": [
    "<id-1>",
    "<id-2>"
  ]
}

الأخطاء

الحالةcodeمثال
400bad_request{"code":"bad_request","message":"text normalizes to empty — nothing to store"}
DELETE /v1/memory/:id api-key · memory:write #

يحذف عنصر ذاكرة واحدًا بالمعرّف. محصور بالمستأجر: معرّف الغير لا يُميَّز عن المعدوم.

الطلب

الحقلالنوعالوصف
id (path)stringمطلوبمعرّف عنصر الذاكرة.

مثال

curl -X DELETE https://agw.orcanox.xyz/v1/memory/<id> \
  -H "Authorization: Bearer agw_…" \
  -H "Content-Type: application/json" \
  -d '{}'

الاستجابة

json
{
  "deleted": true,
  "id": "<id>"
}

الأخطاء

الحالةcodeمثال
404not_found{"code":"not_found","message":"memory item not found"}