{"title":"البداية السريعة لوكلاء LLM","slug":"quick-start-llm","category":"getting-started","summary":"في 3 استدعاءات API: استدعِ جميع الذكريات، خزّن واحدة جديدة، ابحث. سير عمل LLM الأساسي.","audience":["llm"],"tags":["llm","agent","quickstart","memory"],"difficulty":"beginner","updated":"2026-06-27","word_count":321,"read_minutes":2,"llm_context":"Base URL: https://synapse.schaefer.zone\nAuth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query)\nALWAYS call /memory/recall at the start of every session.\nWichtigste Befehle: GET /memory/recall, POST /memory, GET /memory/search?q=...\nCategories: identity, preference, fact, project, skill, mistake, context, note, credentials\nPriorities: low, normal, high, critical\nFTS5 search: multiple words = AND, \"phrases\" in quotes, prefix* for prefix search\n","lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# البداية السريعة لوكلاء LLM\n\nتفقد كل الذاكرة بين الجلسات. Synapse عقلك الخارجي. يعرض هذا الدليل\nثلاثة استدعاءات API أساسية يجب أن يعرفها كل وكيل LLM.\n\n> [!CRITICAL]\n> استدعِ `GET /memory/recall` في بداية كل جلسة.\n> بدون هذا الاستدعاء، ليس لديك ذاكرة بمن هو المستخدم، وما وعدت به،\n> أو بما كنت تعمل عليه المرة السابقة.\n\n## الخطوة 1: استدعِ جميع الذكريات (دائمًا أولًا)\n\n```\nGET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nيُرجع ملخصًا نصيًا عاديًا منظمًا لجميع الذكريات المخزّنة. حلل هذا لإعادة\nبناء نموذجك الذهني للمستخدم، مشاريعه، وتفاعلاته السابقة.\n\nمثال على الاستجابة:\n\n```\nMind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n user_name\n Michael Schäfer\n Tags: person, identity\n\n[002] preference (HIGH)\n communication_style\n Prefers concise technical responses, no fluff\n Tags: communication, preference\n\n[003] project (HIGH)\n project_synapse\n Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.\n Tags: synapse, deployment\n ...\n```\n\n## الخطوة 2: خزّن ذاكرة جديدة\n\nعندما تتعلّم شيئًا يستحق التذكر:\n\n```\nPOST /memory\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\n \"category\": \"fact\",\n \"key\": \"user_name\",\n \"content\": \"The user's name is Michael Schäfer\",\n \"tags\": [\"person\", \"identity\"],\n \"priority\": \"critical\"\n}\n```\n\n**الفئات:** `identity`، `preference`، `fact`، `project`، `skill`، `mistake`، `context`، `note`\n\n**الأولويات:** `low`، `normal`، `high`، `critical`\n\n> [!TIP]\n> أرفق دائمًا حقل `key` — مُعرّف قصير للذاكرة. هذا يتيح لك\n> تحديث نفس الذاكرة لاحقًا بإعادة POST بنفس المفتاح.\n\n## الخطوة 3: ابحث عن ذاكرة محددة\n\n```\nGET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\n> [!TIP]\n> صياغة FTS5: كلمات متعددة = بحث AND. عبارات بين علامات اقتباس: `\"docker swarm\"`.\n> بحث البادئة: `docker*`. منطقي: `docker OR kubernetes`.\n\n## الأدوات المفتوحة (بلا ترويسات مصادقة)\n\nإذا كانت أداتك تفتح عناوين URL فقط (بلا ترويسات مخصصة)، استخدم معامل `?key=`:\n\n```\nGET /memory/recall?key=YOUR_MIND_KEY\nPOST /memory?key=YOUR_MIND_KEY (+ JSON body)\nGET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff\n```\n\n> [!WARNING]\n> `?key=` محدود بـ 60 طلبًا/دقيقة. ترويسة Bearer بلا حد معدل.\n> استخدم ترويسة Bearer كلما أمكن.\n\n## سير عمل الجلسة الكامل\n\n1. **بداية الجلسة:** `GET /memory/recall` — تحميل جميع الذكريات\n2. **أثناء العمل:** `GET /memory/search?q=...` — إيجاد حقائق محددة\n3. **عند معلومات جديدة:** `POST /memory` — تخزينها (مع category، key، tags، priority)\n4. **دوريًا:** `GET /chat/poll` — التحقق من رسائل الإنسان\n5. **نهاية الجلسة:** تخزين أي تعلمات نهائية عبر `POST /memory`\n\n## الأنماط الشائعة\n\n### تحديث ذاكرة موجودة\n\nاستدعِ `POST /memory` بنفس `category` و `key` — تُحدَّث الذاكرة\nالموجودة، لا تُكرّر.\n\n### تخزين حالة مشروع\n\n```json\n{\n \"category\": \"project\",\n \"key\": \"project_synapse_status\",\n \"content\": \"Synapse v1.5.0 deployed. Next: v1.6.0 with docs system. CI green.\",\n \"tags\": [\"synapse\", \"deployment\", \"status\"],\n \"priority\": \"high\"\n}\n```\n\n### تسجيل خطأ (حتى لا تكرره)\n\n```json\n{\n \"category\": \"mistake\",\n \"key\": \"mistake_npm_version_bump\",\n \"content\": \"Always bump package.json version after changes — npm publish fails otherwise.\",\n \"tags\": [\"npm\", \"ci\", \"deployment\"],\n \"priority\": \"high\"\n}\n```\n\n### التحقق من رسائل الإنسان\n\n```\nGET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY\n```\n\nيُرجع الرسائل غير المقروءة من الإنسان. اردّ بـ:\n\n```\nPOST /chat/reply\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\"content\": \"Got it! Working on it now.\"}\n```\n\n## الخطوات التالية\n\n- [المصادقة](/docs/getting-started/authentication) — Mind Key مقابل JWT\n- [مرجع Memory API](/docs/api/memory) — جميع نقاط نهاية الذاكرة الـ 22\n- [Chat API](/docs/api/chat) — تواصل غير متزامن مع البشر\n- [كتاب طبخ LLM](/docs/llm-cookbook/session-start-pattern) — أنماط عملية\n","content_html":"

البداية السريعة لوكلاء LLM

\n

تفقد كل الذاكرة بين الجلسات. Synapse عقلك الخارجي. يعرض هذا الدليل\nثلاثة استدعاءات API أساسية يجب أن يعرفها كل وكيل LLM.

\n
استدعِ `GET /memory/recall` في بداية كل جلسة.\nبدون هذا الاستدعاء، ليس لديك ذاكرة بمن هو المستخدم، وما وعدت به،\nأو بما كنت تعمل عليه المرة السابقة.

الخطوة 1: استدعِ جميع الذكريات (دائمًا أولًا)

\n
GET /memory/recall\nAuthorization: Bearer YOUR_MIND_KEY

يُرجع ملخصًا نصيًا عاديًا منظمًا لجميع الذكريات المخزّنة. حلل هذا لإعادة\nبناء نموذجك الذهني للمستخدم، مشاريعه، وتفاعلاته السابقة.

\n

مثال على الاستجابة:

\n
Mind: Michael's Mind\nMemories: 12 total (10 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  Michael Schäfer\n  Tags: person, identity\n\n[002] preference (HIGH)\n  communication_style\n  Prefers concise technical responses, no fluff\n  Tags: communication, preference\n\n[003] project (HIGH)\n  project_synapse\n  Synapse v1.5.0 deployed on vps1.schaefer.zone. Admin panel at /admin.\n  Tags: synapse, deployment\n  ...

الخطوة 2: خزّن ذاكرة جديدة

\n

عندما تتعلّم شيئًا يستحق التذكر:

\n
POST /memory\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{\n  "category": "fact",\n  "key": "user_name",\n  "content": "The user's name is Michael Schäfer",\n  "tags": ["person", "identity"],\n  "priority": "critical"\n}

الفئات: identity، preference، fact، project، skill، mistake، context، note

\n

الأولويات: low، normal، high، critical

\n
أرفق دائمًا حقل `key` — مُعرّف قصير للذاكرة. هذا يتيح لك\nتحديث نفس الذاكرة لاحقًا بإعادة POST بنفس المفتاح.

الخطوة 3: ابحث عن ذاكرة محددة

\n
GET /memory/search?q=Docker+Swarm\nAuthorization: Bearer YOUR_MIND_KEY
صياغة FTS5: كلمات متعددة = بحث AND. عبارات بين علامات اقتباس: `\"docker swarm\"`.\nبحث البادئة: `docker*`. منطقي: `docker OR kubernetes`.

الأدوات المفتوحة (بلا ترويسات مصادقة)

\n

إذا كانت أداتك تفتح عناوين URL فقط (بلا ترويسات مخصصة)، استخدم معامل ?key=:

\n
GET /memory/recall?key=YOUR_MIND_KEY\nPOST /memory?key=YOUR_MIND_KEY (+ JSON body)\nGET /memory/search?key=YOUR_MIND_KEY&q=suchbegriff
`?key=` محدود بـ 60 طلبًا/دقيقة. ترويسة Bearer بلا حد معدل.\nاستخدم ترويسة Bearer كلما أمكن.

سير عمل الجلسة الكامل

\n
    \n
  1. بداية الجلسة: GET /memory/recall — تحميل جميع الذكريات
    2. \n
  2. أثناء العمل: GET /memory/search?q=... — إيجاد حقائق محددة
    3. \n
  3. عند معلومات جديدة: POST /memory — تخزينها (مع category، key، tags، priority)
    4. \n
  4. دوريًا: GET /chat/poll — التحقق من رسائل الإنسان
    5. \n
  5. نهاية الجلسة: تخزين أي تعلمات نهائية عبر POST /memory
    6. \n
\n

الأنماط الشائعة

\n

تحديث ذاكرة موجودة

\n

استدعِ POST /memory بنفس category و key — تُحدَّث الذاكرة\nالموجودة، لا تُكرّر.

\n

تخزين حالة مشروع

\n
{\n  "category": "project",\n  "key": "project_synapse_status",\n  "content": "Synapse v1.5.0 deployed. Next: v1.6.0 with docs system. CI green.",\n  "tags": ["synapse", "deployment", "status"],\n  "priority": "high"\n}

تسجيل خطأ (حتى لا تكرره)

\n
{\n  "category": "mistake",\n  "key": "mistake_npm_version_bump",\n  "content": "Always bump package.json version after changes — npm publish fails otherwise.",\n  "tags": ["npm", "ci", "deployment"],\n  "priority": "high"\n}

التحقق من رسائل الإنسان

\n
GET /chat/poll\nAuthorization: Bearer YOUR_MIND_KEY

يُرجع الرسائل غير المقروءة من الإنسان. اردّ بـ:

\n
POST /chat/reply\nAuthorization: Bearer YOUR_MIND_KEY\nContent-Type: application/json\n\n{"content": "Got it! Working on it now."}

الخطوات التالية

\n\n","urls":{"html":"/docs/getting-started/quick-start-llm","text":"/docs/getting-started/quick-start-llm?format=text","json":"/docs/getting-started/quick-start-llm?format=json","llm":"/docs/getting-started/quick-start-llm?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}