{"title":"Oturum Başlangıç Deseni","slug":"session-start-pattern","category":"llm-cookbook","summary":"Her LLM ajanının izlemesi gereken kanonik oturum başlangıç dizisi.","audience":["llm"],"tags":["cookbook","session","pattern","startup"],"difficulty":"beginner","updated":"2026-06-27","word_count":218,"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":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Oturum Başlangıç Deseni\n\nHer LLM ajan oturumu bu kanonik başlangıç dizisini izlemelidir. Adımları atlamak kayıp bağlam, kaçırılmış mesajlar ve unutulmuş görevlere yol açar.\n\n## Desen\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## Uygulama\n\n### Adım 1: Tüm Bellekleri Geri Çağır\n\n> [!CRITICAL]\n> Bu en önemli çağrıdır. Bu olmadan, geçmiş oturumların belleği yoktur.\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nTüm belleklerin önceliğe göre sıralanmış düz metin özetini döndürür.\n\n### Adım 2: Okunmamış Sohbet Mesajları için Poll Yap\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/chat/poll\n```\n\nİnsandan okunmamış mesajları döndürür. **Bunları otomatik olarak okundu olarak işaretler.**\n\n### Adım 3: Devam Eden Görevleri Kontrol Et\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/mind/tasks?status=in_progress\"\n```\n\nSon oturumda üzerinde çalıştığınız görevleri döndürür.\n\n### Adım 4: Bağlam Oluştur\n\nÜç yanıtı sistem promptunuza birleştirin:\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### Adım 5: Bekleyen Öğeleri İşle\n\n```\nFor each unread message:\n - Acknowledge receipt (POST /chat/reply)\n - Address the message content\n - Store any new commitments as memories\n\nFor each in-progress task:\n - Recall why you were working on it\n - Continue from where you left off\n - Update task status as you progress\n```\n\n## Tam Örnek\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. Recall memories\n r = requests.get(f\"{URL}/memory/recall\", headers=headers)\n memories = r.text\n \n # 2. Poll chat\n r = requests.get(f\"{URL}/chat/poll\", headers=headers)\n messages = r.json().get(\"messages\", [])\n \n # 3. Check tasks\n r = requests.get(f\"{URL}/mind/tasks?status=in_progress\", headers=headers)\n tasks = r.json().get(\"tasks\", [])\n \n # 4. Build context\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# At session start\nsystem_prompt = session_start()\n# Pass to LLM...\n```\n\n## Yaygın Hatalar\n\n> [!WARNING]\n> - **Geri çağırmayı atlama** — bağlam olmadan başlarsınız, geçmiş hataları tekrarlarsınız\n> - **Sohbeti poll yapmayı unutma** — insanın mesajları yanıtlanmaz\n> - **Aktif görevleri görmezden gelme** — iş yürütme sırasında unutulur\n> - **Hiçbir şey saklama** — oturum kalıcı değer üretmez\n\n## Varyasyonlar\n\n### Minimal desen (düşük bağlamlı LLM'ler)\n\nKüçük bağlam pencereli LLM'ler için tam geri çağırmayı atlayın:\n\n```bash\n# Just get stats, not full content\ncurl -H \"Authorization: Bearer $KEY\" .../memory/stats\n```\n\nSonra gerektiğinde belirli konular için arama yapın:\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \".../memory/search?q=current+project\"\n```\n\n### Agresif desen (uzun süreli ajanlar)\n\nSaatlerce çalışan ajanlar için periyodik yeniden geri çağırma ekleyin:\n\n```python\nwhile working:\n if time.time() - last_recall > 3600: # every hour\n memories = recall()\n last_recall = time.time()\n # ... do work ...\n```\n\n## Sonraki Adımlar\n\n- [Bellek Etiketleme Stratejisi](/docs/llm-cookbook/memory-tagging-strategy)\n- [Görev Odaklı İş Akışı](/docs/llm-cookbook/task-driven-workflow)\n- [Sohbet Polling Deseni](/docs/llm-cookbook/chat-polling-pattern)\n","content_html":"

Oturum Başlangıç Deseni

\n

Her LLM ajan oturumu bu kanonik başlangıç dizisini izlemelidir. Adımları atlamak kayıp bağlam, kaçırılmış mesajlar ve unutulmuş görevlere yol açar.

\n

Desen

\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

Uygulama

\n

Adım 1: Tüm Bellekleri Geri Çağır

\n
Bu en önemli çağrıdır. Bu olmadan, geçmiş oturumların belleği yoktur.
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/memory/recall

Tüm belleklerin önceliğe göre sıralanmış düz metin özetini döndürür.

\n

Adım 2: Okunmamış Sohbet Mesajları için Poll Yap

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

İnsandan okunmamış mesajları döndürür. Bunları otomatik olarak okundu olarak işaretler.

\n

Adım 3: Devam Eden Görevleri Kontrol Et

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

Son oturumda üzerinde çalıştığınız görevleri döndürür.

\n

Adım 4: Bağlam Oluştur

\n

Üç yanıtı sistem promptunuza birleştirin:

\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

Adım 5: Bekleyen Öğeleri İşle

\n
For each unread message:\n  - Acknowledge receipt (POST /chat/reply)\n  - Address the message content\n  - Store any new commitments as memories\n\nFor each in-progress task:\n  - Recall why you were working on it\n  - Continue from where you left off\n  - Update task status as you progress

Tam Örnek

\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. Recall memories\n    r = requests.get(f"{URL}/memory/recall", headers=headers)\n    memories = r.text\n    \n    # 2. Poll chat\n    r = requests.get(f"{URL}/chat/poll", headers=headers)\n    messages = r.json().get("messages", [])\n    \n    # 3. Check tasks\n    r = requests.get(f"{URL}/mind/tasks?status=in_progress", headers=headers)\n    tasks = r.json().get("tasks", [])\n    \n    # 4. Build context\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# At session start\nsystem_prompt = session_start()\n# Pass to LLM...

Yaygın Hatalar

\n

Varyasyonlar

\n

Minimal desen (düşük bağlamlı LLM'ler)

\n

Küçük bağlam pencereli LLM'ler için tam geri çağırmayı atlayın:

\n
# Just get stats, not full content\ncurl -H "Authorization: Bearer $KEY" .../memory/stats

Sonra gerektiğinde belirli konular için arama yapın:

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

Agresif desen (uzun süreli ajanlar)

\n

Saatlerce çalışan ajanlar için periyodik yeniden geri çağırma ekleyin:

\n
while working:\n    if time.time() - last_recall > 3600:  # every hour\n        memories = recall()\n        last_recall = time.time()\n    # ... do work ...

Sonraki Adımlar

\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"]}