{"title":"نمط بدء الجلسة","slug":"session-start-pattern","category":"llm-cookbook","summary":"تسلسل بدء الجلسة القانوني الذي يجب أن يتبعه كل وكيل LLM.","audience":["llm"],"tags":["cookbook","session","pattern","startup"],"difficulty":"beginner","updated":"2026-06-27","word_count":220,"read_minutes":1,"llm_context":"ALWAYS at session start: 1) GET /memory/recall, 2) GET /chat/poll, 3) GET /mind/tasks?status=in_progress\nBuild system prompt from recall output.\nProcess unread chat messages before doing new work.\nResume any in_progress tasks before starting new ones.\nStore new learnings as they happen — don't wait until session end.\n","lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# نمط بدء الجلسة\n\nكل جلسة وكيل LLM يجب أن تتبع تسلسل بدء التشغيل القانوني هذا. تخطي\nالخطوات يؤدي إلى فقدان السياق، تفويت الرسائل، ونسيان المهام.\n\n## النمط\n\n```\n1. Recall all memories\n2. Poll for unread chat messages\n3. Check in-progress tasks\n4. Build context from results\n5. Process pending items before new work\n```\n\n## التنفيذ\n\n### الخطوة 1: استدعِ جميع الذكريات\n\n> [!CRITICAL]\n> هذا أهم استدعاء. بدونه، ليس لديك ذاكرة بالجلسات\n> السابقة.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nيُرجع ملخصًا نصيًا عاديًا لجميع الذكريات، مرتّبًا حسب الأولوية.\n\n### الخطوة 2: استطلع للرسائل غير المقروءة\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/chat/poll\n```\n\nيُرجع الرسائل غير المقروءة من الإنسان. **يُعلّمها كمقروءة تلقائيًا.**\n\n### الخطوة 3: تحقق من المهام قيد التقدم\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/mind/tasks?status=in_progress\"\n```\n\nيُرجع المهام التي كنت تعمل عليها في الجلسة الأخيرة.\n\n### الخطوة 4: ابنِ السياق\n\nاجمع الاستجابات الثلاث في system prompt الخاص بك:\n\n```python\ndef build_context(memories, messages, tasks):\n context = f\"\"\"# SESSION CONTEXT\n\n## Memories (from previous sessions)\n{memories}\n\n## Unread Messages from Human\n{format_messages(messages)}\n\n## Active Tasks\n{format_tasks(tasks)}\n\n## Instructions\n- Address unread messages first\n- Resume active tasks before starting new work\n- Store new learnings as they happen (POST /memory)\n- Poll for new messages every 30-60 seconds\n\"\"\"\n return context\n```\n\n### الخطوة 5: عالج العناصر المعلّقة\n\n```\nلكل رسالة غير مقروءة:\n - أقرّ بالاستلام (POST /chat/reply)\n - عالج محتوى الرسالة\n - خزّن أي التزامات جديدة كذكريات\n\nلكل مهمة قيد التقدم:\n - استدعِ لماذا كنت تعمل عليها\n - واصل من حيث توقفت\n - حدّث حالة المهمة أثناء تقدمك\n```\n\n## مثال كامل\n\n```python\nimport os\nimport requests\n\nURL = \"https://synapse.schaefer.zone\"\nKEY = os.environ[\"SYNAPSE_MIND_KEY\"]\n\ndef session_start():\n \"\"\"Canonical session start sequence.\"\"\"\n headers = {\"Authorization\": f\"Bearer {KEY}\"}\n \n # 1. استدعِ الذكريات\n r = requests.get(f\"{URL}/memory/recall\", headers=headers)\n memories = r.text\n \n # 2. استطلع الدردشة\n r = requests.get(f\"{URL}/chat/poll\", headers=headers)\n messages = r.json().get(\"messages\", [])\n \n # 3. تحقق من المهام\n r = requests.get(f\"{URL}/mind/tasks?status=in_progress\", headers=headers)\n tasks = r.json().get(\"tasks\", [])\n \n # 4. ابنِ السياق\n context = f\"\"\"You are a Synapse-enabled AI assistant.\n\nMEMORIES FROM PREVIOUS SESSIONS:\n{memories}\n\nUNREAD MESSAGES FROM HUMAN:\n{chr(10).join(f'- {m[\"content\"]}' for m in messages) or 'None'}\n\nACTIVE TASKS:\n{chr(10).join(f'- [{t[\"id\"]}] {t[\"title\"]}: {t.get(\"description\", \"\")}' for t in tasks) or 'None'}\n\nINSTRUCTIONS:\n1. Acknowledge each unread message\n2. Resume active tasks\n3. Store new learnings via POST /memory\n4. Poll /chat/poll every 30-60 seconds\n\"\"\"\n return context\n\n# عند بدء الجلسة\nsystem_prompt = session_start()\n# مرّر إلى LLM...\n```\n\n## أخطاء شائعة\n\n> [!WARNING]\n> - **تخطي الاستدعاء** — تبدأ بلا سياق، تكرر الأخطاء السابقة\n> - **نسيان استطلاع الدردشة** — رسائل الإنسان تذهب بلا رد\n> - **تجاهل المهام النشطة** — العمل يُنسى في منتصف التنفيذ\n> - **عدم تخزين شيء** — الجلسة لا تنتج قيمة دائمة\n\n## تنويعات\n\n### النمط الأدنى (LLMs بسياق صغير)\n\nلـ LLMs بنوافذ سياق صغيرة، تخطَّ الاستدعاء الكامل:\n\n```bash\n# احصل على الإحصائيات فقط، لا المحتوى الكامل\ncurl -H \"Authorization: Bearer $KEY\" .../memory/stats\n```\n\nثم ابحث عن مواضيع محددة حسب الحاجة:\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \".../memory/search?q=current+project\"\n```\n\n### النمط العدواني (وكلاء طويلو الأمد)\n\nلوكلاء يعملون لساعات، أضف إعادة استدعاء دورية:\n\n```python\nwhile working:\n if time.time() - last_recall > 3600: # كل ساعة\n memories = recall()\n last_recall = time.time()\n # ... نفذ العمل ...\n```\n\n## الخطوات التالية\n\n- [استراتيجية وسوم الذاكرة](/docs/llm-cookbook/memory-tagging-strategy)\n- [سير العمل المدفوع بالمهام](/docs/llm-cookbook/task-driven-workflow)\n- [نمط استطلاع الدردشة](/docs/llm-cookbook/chat-polling-pattern)\n","content_html":"

نمط بدء الجلسة

\n

كل جلسة وكيل LLM يجب أن تتبع تسلسل بدء التشغيل القانوني هذا. تخطي\nالخطوات يؤدي إلى فقدان السياق، تفويت الرسائل، ونسيان المهام.

\n

النمط

\n
1. Recall all memories\n2. Poll for unread chat messages\n3. Check in-progress tasks\n4. Build context from results\n5. Process pending items before new work

التنفيذ

\n

الخطوة 1: استدعِ جميع الذكريات

\n
هذا أهم استدعاء. بدونه، ليس لديك ذاكرة بالجلسات\nالسابقة.
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/recall

يُرجع ملخصًا نصيًا عاديًا لجميع الذكريات، مرتّبًا حسب الأولوية.

\n

الخطوة 2: استطلع للرسائل غير المقروءة

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/chat/poll

يُرجع الرسائل غير المقروءة من الإنسان. يُعلّمها كمقروءة تلقائيًا.

\n

الخطوة 3: تحقق من المهام قيد التقدم

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/mind/tasks?status=in_progress"

يُرجع المهام التي كنت تعمل عليها في الجلسة الأخيرة.

\n

الخطوة 4: ابنِ السياق

\n

اجمع الاستجابات الثلاث في system prompt الخاص بك:

\n
def build_context(memories, messages, tasks):\n    context = f"""# SESSION CONTEXT\n\n## Memories (from previous sessions)\n{memories}\n\n## Unread Messages from Human\n{format_messages(messages)}\n\n## Active Tasks\n{format_tasks(tasks)}\n\n## Instructions\n- Address unread messages first\n- Resume active tasks before starting new work\n- Store new learnings as they happen (POST /memory)\n- Poll for new messages every 30-60 seconds\n"""\n    return context

الخطوة 5: عالج العناصر المعلّقة

\n
لكل رسالة غير مقروءة:\n  - أقرّ بالاستلام (POST /chat/reply)\n  - عالج محتوى الرسالة\n  - خزّن أي التزامات جديدة كذكريات\n\nلكل مهمة قيد التقدم:\n  - استدعِ لماذا كنت تعمل عليها\n  - واصل من حيث توقفت\n  - حدّث حالة المهمة أثناء تقدمك

مثال كامل

\n
import os\nimport requests\n\nURL = "https://synapse.schaefer.zone"\nKEY = os.environ["SYNAPSE_MIND_KEY"]\n\ndef session_start():\n    """Canonical session start sequence."""\n    headers = {"Authorization": f"Bearer {KEY}"}\n    \n    # 1. استدعِ الذكريات\n    r = requests.get(f"{URL}/memory/recall", headers=headers)\n    memories = r.text\n    \n    # 2. استطلع الدردشة\n    r = requests.get(f"{URL}/chat/poll", headers=headers)\n    messages = r.json().get("messages", [])\n    \n    # 3. تحقق من المهام\n    r = requests.get(f"{URL}/mind/tasks?status=in_progress", headers=headers)\n    tasks = r.json().get("tasks", [])\n    \n    # 4. ابنِ السياق\n    context = f"""You are a Synapse-enabled AI assistant.\n\nMEMORIES FROM PREVIOUS SESSIONS:\n{memories}\n\nUNREAD MESSAGES FROM HUMAN:\n{chr(10).join(f'- {m["content"]}' for m in messages) or 'None'}\n\nACTIVE TASKS:\n{chr(10).join(f'- [{t["id"]}] {t["title"]}: {t.get("description", "")}' for t in tasks) or 'None'}\n\nINSTRUCTIONS:\n1. Acknowledge each unread message\n2. Resume active tasks\n3. Store new learnings via POST /memory\n4. Poll /chat/poll every 30-60 seconds\n"""\n    return context\n\n# عند بدء الجلسة\nsystem_prompt = session_start()\n# مرّر إلى LLM...

أخطاء شائعة

\n

تنويعات

\n

النمط الأدنى (LLMs بسياق صغير)

\n

لـ LLMs بنوافذ سياق صغيرة، تخطَّ الاستدعاء الكامل:

\n
# احصل على الإحصائيات فقط، لا المحتوى الكامل\ncurl -H "Authorization: Bearer $KEY" .../memory/stats

ثم ابحث عن مواضيع محددة حسب الحاجة:

\n
curl -H "Authorization: Bearer $KEY" ".../memory/search?q=current+project"

النمط العدواني (وكلاء طويلو الأمد)

\n

لوكلاء يعملون لساعات، أضف إعادة استدعاء دورية:

\n
while working:\n    if time.time() - last_recall > 3600:  # كل ساعة\n        memories = recall()\n        last_recall = time.time()\n    # ... نفذ العمل ...

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

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