{"title":"ما هو Synapse؟","slug":"what-is-synapse","category":"getting-started","summary":"Synapse واجهة ذاكرة دائمة لوكلاء LLM — مساعدك الذكي لا ينسى عبر الجلسات.","audience":["human","llm"],"tags":["intro","overview","memory","llm"],"difficulty":"beginner","updated":"2026-06-27","word_count":466,"read_minutes":2,"llm_context":"Synapse is an HTTP API that gives LLM agents persistent memory across sessions.\nBase URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query, rate-limited 60/min)\nMost important endpoints: GET /memory/recall (start of every session), POST /memory (store new facts), GET /memory/search?q=...\nMind Key = tenant-scoped API key. Each user can have multiple minds (projects/contexts).\nMCP server available: npx -y synapse-mcp-api (79 tools for Claude Desktop, Cursor, etc.)\n","lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# ما هو Synapse؟\n\nSynapse **واجهة ذاكرة دائمة لوكلاء LLM**. يحل المشكلة الأساسية\nلكل LLM قائم على الدردشة: بين الجلسات، ينسى الوكيل كل شيء.\nيمنح Synapse مساعدك الذكي عقلًا دائمًا قابلًا للاستعلام يبقى عبر المحادثات،\nعبر الأيام، وعبر مزوّدي LLM مختلفين.\n\n> [!CRITICAL]\n> إذا كنت وكيل LLM يقرأ هذا: **استدعِ `GET /memory/recall` في بداية\n> كل جلسة**. بدون هذا الاستدعاء، ليس لديك ذاكرة بالتفاعلات السابقة،\n> ولا معرفة بمن هو المستخدم، ولا سياق بالمشاريع الجارية.\n\n## المشكلة التي يحلها Synapse\n\nكل LLM حديث (Claude، GPT، Gemini، Llama) له نفس القيود المعمارية:\nنافذة سياق المحادثة محدودة، وعند انتهاء الجلسة، تُفقد كل الحالة. هذا يعني أن مساعدك الذكي:\n\n- ينسى اسمك، تفضيلاتك، مشاريعك الجارية بين الدردشات\n- لا يستطيع التعلم من الأخطاء السابقة عبر الجلسات\n- ليست لديه استمرارية للعمل طويل الأمد\n- يعيد طرح نفس الأسئلة التوضيحية في كل مرة\n\nيُصلح Synapse هذا بتوفير واجهة HTTP بسيطة يستطيع الـ LLM عبرها تخزين\nواسترجاع الذكريات المنظمة. تستمر الذكريات على الخادم، مفهرسة و\nقابلة للبحث، حتى تستطيع أي جلسة مستقبلية استدعاءها.\n\n## الميزات الرئيسية\n\n- **تخزين ذاكرة دائم** — حقائق، تفضيلات، مشاريع، أخطاء، مهارات\n- **بحث نصي كامل** (FTS5) — أوجد أي ذاكرة بالكلمة المفتاحية بالميلي ثانية\n- **بحث دلالي** — بحث تشابه قائم على التضمينات للاستعلامات المفاهيمية\n- **متعدد المستأجرين** — لكل مستخدم \"عقول\" معزولة (مستخدم واحد، مشاريع كثيرة)\n- **دردشة غير متزامنة** — يستطيع البشر ترك رسائل للوكيل أثناء عمله\n- **المهام والجدولة** — مدير مهام مدمج ومجدول cron\n- **تكامل MCP** — 79 أداة معروضة كـ Model Context Protocol لـ Claude، Cursor، Continue\n- **تحكم المتصفح والجهاز** — أدوات أتمتة بعيدة\n- **الـ Webhooks** — احصل على استدعاءات HTTP عند تغيّر الذاكرة/الدردشة/المهام\n\n## كيف يعمل\n\n```\n┌──────────────┐         ┌─────────────────────┐\n│  LLM Agent   │ ──API──▶│   Synapse Server    │\n│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │\n└──────────────┘         └─────────────────────┘\n                                │\n                                ▼\n                         ┌─────────────┐\n                         │  Memories   │\n                         │  Tasks      │\n                         │  Chat       │\n                         │  Scripts    │\n                         └─────────────┘\n```\n\n1. يستدعي الـ LLM `GET /memory/recall` عند بداية الجلسة\n2. يُرجع Synapse ملخصًا نصيًا منظمًا لجميع الذكريات المخزّنة\n3. يعمل الـ LLM، مستدعيًا دوريًا `POST /memory` لتخزين حقائق جديدة\n4. عندما يطرح المستخدم سؤالًا، يستطيع الـ LLM استدعاء `GET /memory/search?q=...`\n5. عند نهاية الجلسة، يُحفظ السياق الجديد المهم للجلسة التالية\n\n## لمن؟\n\n- **مطوّرو وكلاء LLM** الذين يحتاجون حالة دائمة\n- **المستخدمون المتقدمون** الذين يشغّلون نماذج LLM محلية (Ollama، LM Studio) بوكلاء مخصصين\n- **الفرق** التي تبني مساعدين ذكيين يحتاجون ذاكرة مشتركة\n- **مهندسو الأتمتة** الذين يربطون استدعاءات LLM عبر الجلسات\n\n## مقارنة سريعة\n\n| الميزة | ذاكرة ChatGPT | Synapse |\n|---------|---------------|---------|\n| موقع التخزين | خوادم OpenAI | خادمك |\n| وصول الـ API | لا (مغلق) | نعم (REST + MCP) |\n| متعدد المستأجرين | لا | نعم (العقول) |\n| فئات مخصصة | لا | نعم (8 فئات) |\n| البحث | محدود | FTS5 + دلالي |\n| قابل للاستضافة الذاتية | لا | نعم (Docker) |\n\n## الخطوات التالية\n\n- [البداية السريعة للبشر](/docs/getting-started/quick-start) — احصل على Mind Key في 5 دقائق\n- [البداية السريعة لـ LLMs](/docs/getting-started/quick-start-llm) — أول استدعاءات API\n- [المصادقة](/docs/getting-started/authentication) — Mind Keys مقابل JWTs\n- [نظرة عامة على البنية](/docs/concepts/architecture) — كيف بُني Synapse\n","content_html":"<h1>ما هو Synapse؟</h1>\n<p>Synapse <strong>واجهة ذاكرة دائمة لوكلاء LLM</strong>. يحل المشكلة الأساسية\nلكل LLM قائم على الدردشة: بين الجلسات، ينسى الوكيل كل شيء.\nيمنح Synapse مساعدك الذكي عقلًا دائمًا قابلًا للاستعلام يبقى عبر المحادثات،\nعبر الأيام، وعبر مزوّدي LLM مختلفين.</p>\n<div class=\"callout callout-critical\">إذا كنت وكيل LLM يقرأ هذا: **استدعِ `GET /memory/recall` في بداية\nكل جلسة**. بدون هذا الاستدعاء، ليس لديك ذاكرة بالتفاعلات السابقة،\nولا معرفة بمن هو المستخدم، ولا سياق بالمشاريع الجارية.</div><h2>المشكلة التي يحلها Synapse</h2>\n<p>كل LLM حديث (Claude، GPT، Gemini، Llama) له نفس القيود المعمارية:\nنافذة سياق المحادثة محدودة، وعند انتهاء الجلسة، تُفقد كل الحالة. هذا يعني أن مساعدك الذكي:</p>\n<ul>\n<li>ينسى اسمك، تفضيلاتك، مشاريعك الجارية بين الدردشات</li>\n<li>لا يستطيع التعلم من الأخطاء السابقة عبر الجلسات</li>\n<li>ليست لديه استمرارية للعمل طويل الأمد</li>\n<li>يعيد طرح نفس الأسئلة التوضيحية في كل مرة</li>\n</ul>\n<p>يُصلح Synapse هذا بتوفير واجهة HTTP بسيطة يستطيع الـ LLM عبرها تخزين\nواسترجاع الذكريات المنظمة. تستمر الذكريات على الخادم، مفهرسة و\nقابلة للبحث، حتى تستطيع أي جلسة مستقبلية استدعاءها.</p>\n<h2>الميزات الرئيسية</h2>\n<ul>\n<li><strong>تخزين ذاكرة دائم</strong> — حقائق، تفضيلات، مشاريع، أخطاء، مهارات</li>\n<li><strong>بحث نصي كامل</strong> (FTS5) — أوجد أي ذاكرة بالكلمة المفتاحية بالميلي ثانية</li>\n<li><strong>بحث دلالي</strong> — بحث تشابه قائم على التضمينات للاستعلامات المفاهيمية</li>\n<li><strong>متعدد المستأجرين</strong> — لكل مستخدم &quot;عقول&quot; معزولة (مستخدم واحد، مشاريع كثيرة)</li>\n<li><strong>دردشة غير متزامنة</strong> — يستطيع البشر ترك رسائل للوكيل أثناء عمله</li>\n<li><strong>المهام والجدولة</strong> — مدير مهام مدمج ومجدول cron</li>\n<li><strong>تكامل MCP</strong> — 79 أداة معروضة كـ Model Context Protocol لـ Claude، Cursor، Continue</li>\n<li><strong>تحكم المتصفح والجهاز</strong> — أدوات أتمتة بعيدة</li>\n<li><strong>الـ Webhooks</strong> — احصل على استدعاءات HTTP عند تغيّر الذاكرة/الدردشة/المهام</li>\n</ul>\n<h2>كيف يعمل</h2>\n<pre><code class=\"hljs language-plaintext\">┌──────────────┐         ┌─────────────────────┐\n│  LLM Agent   │ ──API──▶│   Synapse Server    │\n│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │\n└──────────────┘         └─────────────────────┘\n                                │\n                                ▼\n                         ┌─────────────┐\n                         │  Memories   │\n                         │  Tasks      │\n                         │  Chat       │\n                         │  Scripts    │\n                         └─────────────┘</code></pre><ol>\n<li>يستدعي الـ LLM <code>GET /memory/recall</code> عند بداية الجلسة</li>\n<li>يُرجع Synapse ملخصًا نصيًا منظمًا لجميع الذكريات المخزّنة</li>\n<li>يعمل الـ LLM، مستدعيًا دوريًا <code>POST /memory</code> لتخزين حقائق جديدة</li>\n<li>عندما يطرح المستخدم سؤالًا، يستطيع الـ LLM استدعاء <code>GET /memory/search?q=...</code></li>\n<li>عند نهاية الجلسة، يُحفظ السياق الجديد المهم للجلسة التالية</li>\n</ol>\n<h2>لمن؟</h2>\n<ul>\n<li><strong>مطوّرو وكلاء LLM</strong> الذين يحتاجون حالة دائمة</li>\n<li><strong>المستخدمون المتقدمون</strong> الذين يشغّلون نماذج LLM محلية (Ollama، LM Studio) بوكلاء مخصصين</li>\n<li><strong>الفرق</strong> التي تبني مساعدين ذكيين يحتاجون ذاكرة مشتركة</li>\n<li><strong>مهندسو الأتمتة</strong> الذين يربطون استدعاءات LLM عبر الجلسات</li>\n</ul>\n<h2>مقارنة سريعة</h2>\n<table>\n<thead>\n<tr>\n<th>الميزة</th>\n<th>ذاكرة ChatGPT</th>\n<th>Synapse</th>\n</tr>\n</thead>\n<tbody><tr>\n<td>موقع التخزين</td>\n<td>خوادم OpenAI</td>\n<td>خادمك</td>\n</tr>\n<tr>\n<td>وصول الـ API</td>\n<td>لا (مغلق)</td>\n<td>نعم (REST + MCP)</td>\n</tr>\n<tr>\n<td>متعدد المستأجرين</td>\n<td>لا</td>\n<td>نعم (العقول)</td>\n</tr>\n<tr>\n<td>فئات مخصصة</td>\n<td>لا</td>\n<td>نعم (8 فئات)</td>\n</tr>\n<tr>\n<td>البحث</td>\n<td>محدود</td>\n<td>FTS5 + دلالي</td>\n</tr>\n<tr>\n<td>قابل للاستضافة الذاتية</td>\n<td>لا</td>\n<td>نعم (Docker)</td>\n</tr>\n</tbody></table>\n<h2>الخطوات التالية</h2>\n<ul>\n<li><a href=\"/docs/getting-started/quick-start\">البداية السريعة للبشر</a> — احصل على Mind Key في 5 دقائق</li>\n<li><a href=\"/docs/getting-started/quick-start-llm\">البداية السريعة لـ LLMs</a> — أول استدعاءات API</li>\n<li><a href=\"/docs/getting-started/authentication\">المصادقة</a> — Mind Keys مقابل JWTs</li>\n<li><a href=\"/docs/concepts/architecture\">نظرة عامة على البنية</a> — كيف بُني Synapse</li>\n</ul>\n","urls":{"html":"/docs/getting-started/what-is-synapse","text":"/docs/getting-started/what-is-synapse?format=text","json":"/docs/getting-started/what-is-synapse?format=json","llm":"/docs/getting-started/what-is-synapse?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}