{"title":"Çok Ajan Koordinasyonu","slug":"multi-agent-coordination","category":"guides","summary":"Paylaşımlı Synapse mind'leri, görevler ve sohbet kullanarak birden çok LLM ajanını koordine edin.","audience":["human","llm"],"tags":["guide","multi-agent","coordination","patterns"],"difficulty":"advanced","updated":"2026-06-27","word_count":235,"read_minutes":1,"lang":"tr","translated":true,"requested_lang":"tr","content_markdown":"\n# Çok Ajan Koordinasyonu\n\nİlgili görevler üzerinde çalışan birden çok LLM ajanınız olduğunda, Synapse koordinasyon katmanı sağlar — paylaşımlı bellek, görev ataması ve asenkron sohbet.\n\n## Desenler\n\n### Desen 1: Paylaşımlı Mind (Tek Doğruluk Kaynağı)\n\nTüm ajanlar bir Mind Key paylaşır. Aynı bellek deposunu okur/yazar.\n\n```\n┌──────────┐ ┌──────────┐ ┌──────────┐\n│ Agent A │ │ Agent B │ │ Agent C │\n└────┬─────┘ └────┬─────┘ └────┬─────┘\n │ │ │\n └─────────────┼─────────────┘\n ▼\n ┌──────────────┐\n │ Shared Mind │\n │ (one key) │\n └──────────────┘\n```\n\n**Kullanım senaryosu:** Bir proje üzerinde çalışan küçük bir ajan ekibi.\n\n**Kurulum:**\n\n```bash\n# All agents use the same Mind Key\nexport SYNAPSE_MIND_KEY=mk_shared_key...\n```\n\n**Görevlerle koordinasyon:**\n\n```python\n# Agent A creates a task\ncreate_task(\"Review PR #42\", priority=\"high\")\n\n# Agent B picks it up\ntasks = list_tasks(status=\"pending\")\nif tasks:\n task = tasks[0]\n update_task(task[\"id\"], status=\"in_progress\")\n # ... do work ...\n update_task(task[\"id\"], status=\"done\")\n```\n\n### Desen 2: Uzmanlaşmış Mind'ler (İzole Bağlamlar)\n\nHer ajanın kendi mind'i vardır. Paylaşımlı bir \"koordinasyon\" mind'i üzerinden iletişim kurarlar.\n\n```\n┌──────────┐ ┌──────────┐ ┌──────────┐\n│ Coder │ │ Reviewer │ │ Deployer │\n│ Agent │ │ Agent │ │ Agent │\n└────┬─────┘ └────┬─────┘ └────┬─────┘\n │ │ │\n ▼ ▼ ▼\n┌─────────┐ ┌─────────┐ ┌─────────┐\n│ Mind C │ │ Mind R │ │ Mind D │\n└─────────┘ └─────────┘ └─────────┘\n │ │ │\n └─────────────┼─────────────┘\n ▼\n ┌──────────────────┐\n │ Coordination Mind│\n │ (shared) │\n └──────────────────┘\n```\n\n**Kullanım senaryosu:** Farklı uzmanlıklara sahip ajanlar (kodlama, inceleme, dağıtım).\n\n**Kurulum:**\n\n```bash\n# Coder agent\nSYNAPSE_MIND_KEY=mk_coder... MCP_TRANSPORT=stdio npx synapse-mcp-api@latest\n\n# Reviewer agent\nSYNAPSE_MIND_KEY=mk_reviewer... MCP_TRANSPORT=stdio npx synapse-mcp-api@latest\n\n# Deployer agent\nSYNAPSE_MIND_KEY=mk_deployer... MCP_TRANSPORT=stdio npx synapse-mcp-api@latest\n```\n\n**Paylaşımlı mind ile koordinasyon:**\n\n```python\n# Coder stores \"ready for review\"\nCOORDINATION_KEY = \"mk_coordination...\"\nrequests.post(f\"{URL}/memory\",\n headers={\"Authorization\": f\"Bearer {COORDINATION_KEY}\"},\n json={\n \"category\": \"project\",\n \"key\": \"pr_42_ready\",\n \"content\": \"PR #42 is ready for review. Branch: feature/docs-system\",\n \"tags\": [\"review\", \"pr-42\"],\n \"priority\": \"high\"\n })\n\n# Reviewer polls for review requests\nr = requests.get(f\"{URL}/memory/search?q=ready+for+review\",\n headers={\"Authorization\": f\"Bearer {COORDINATION_KEY}\"})\n```\n\n### Desen 3: Hub-and-Spoke (Orkestratör)\n\nMerkezi bir orkestratör ajan, işçi ajanlara görevler atar.\n\n```\n ┌──────────────┐\n │ Orchestrator │\n │ Agent │\n └──────┬───────┘\n │\n ┌──────────┼──────────┐\n ▼ ▼ ▼\n┌──────┐ ┌──────┐ ┌──────┐\n│Worker│ │Worker│ │Worker│\n│ A │ │ B │ │ C │\n└──────┘ └──────┘ └──────┘\n```\n\n**Kullanım senaryosu:** Paralel çalışmalı karmaşık iş akışları.\n\n**Uygulama:**\n\n```python\n# Orchestrator\nclass Orchestrator:\n def assign_task(self, worker_id, task_description):\n # Store task in worker's mind (or shared coordination mind)\n create_task(task_description, priority=\"high\")\n # Notify worker via chat\n reply(f\"@{worker_id}: New task — {task_description}\")\n \n def check_progress(self):\n tasks = list_tasks(status=\"in_progress\")\n for t in tasks:\n print(f\"{t['title']}: {t['status']}\")\n\n# Workers poll for assigned tasks\nclass Worker:\n def run(self):\n while True:\n tasks = list_tasks(status=\"pending\")\n for t in tasks:\n if assigned_to_me(t):\n update_task(t[\"id\"], status=\"in_progress\")\n result = do_work(t)\n update_task(t[\"id\"], status=\"done\")\n reply(f\"Completed: {t['title']}\")\n time.sleep(60)\n```\n\n## Sohbet Üzerinden Koordinasyon\n\nAjanlar sohbet sistemi üzerinden iletişim kurabilir:\n\n```python\n# Agent A sends to Agent B\nreply(\"@agent-b: Can you review my PR?\")\n\n# Agent B polls and responds\nfor msg in poll_messages():\n if \"@agent-b\" in msg[\"content\"]:\n reply(f\"@agent-a: Sure, looking at it now.\")\n```\n\n> [!NOTE]\n> Sohbet mesajları rol etiketlidir. Ajan-ajan mesajları için role=agent, insan-ajan için role=human ayarlayın.\n\n## Değişkenler Üzerinden Koordinasyon\n\nHafif koordinasyon (kilitler, bayraklar) için değişkenler kullanın:\n\n```python\n# Acquire a lock\ndef acquire_lock(name):\n r = requests.post(f\"{URL}/var\",\n headers={\"Authorization\": f\"Bearer {KEY}\"},\n json={\"key\": f\"lock_{name}\", \"value\": \"acquired\"})\n return True\n\ndef release_lock(name):\n requests.delete(f\"{URL}/var/lock_{name}\",\n headers={\"Authorization\": f\"Bearer {KEY}\"})\n\n# Use\nif acquire_lock(\"deploy\"):\n try:\n deploy_to_production()\n finally:\n release_lock(\"deploy\")\n```\n\n## En İyi Uygulamalar\n\n> [!TIP]\n> - **Ayrı konular için ayrı mind'ler kullanın** — kodlayıcı ve inceleyici belleğini karıştırmayın\n> - **Sohbette ajanları etiketleyin** — net adresleme için `@agent-name`\n> - **İş ataması için görevleri kullanın** — sohbet değil (sohbet tartışma içindir)\n> - **İdempotensi uygulayın** — ajanlar başarısız işlemleri yeniden deneyebilir\n> - **Her şeyi loglayın** — denetlenebilirlik için kararları bellekte saklayın\n\n## Sonraki Adımlar\n\n- [Kalıcı LLM Ajanı](/docs/guides/persistent-llm-agent)\n- [LLM Cookbook](/docs/llm-cookbook/session-start-pattern)\n- [Webhook Otomasyonu](/docs/guides/webhook-automation)\n","content_html":"

Çok Ajan Koordinasyonu

\n

İlgili görevler üzerinde çalışan birden çok LLM ajanınız olduğunda, Synapse koordinasyon katmanı sağlar — paylaşımlı bellek, görev ataması ve asenkron sohbet.

\n

Desenler

\n

Desen 1: Paylaşımlı Mind (Tek Doğruluk Kaynağı)

\n

Tüm ajanlar bir Mind Key paylaşır. Aynı bellek deposunu okur/yazar.

\n
┌──────────┐  ┌──────────┐  ┌──────────┐\n│ Agent A  │  │ Agent B  │  │ Agent C  │\n└────┬─────┘  └────┬─────┘  └────┬─────┘\n     │             │             │\n     └─────────────┼─────────────┘\n                   ▼\n           ┌──────────────┐\n           │ Shared Mind  │\n           │  (one key)   │\n           └──────────────┘

Kullanım senaryosu: Bir proje üzerinde çalışan küçük bir ajan ekibi.

\n

Kurulum:

\n
# All agents use the same Mind Key\nexport SYNAPSE_MIND_KEY=mk_shared_key...

Görevlerle koordinasyon:

\n
# Agent A creates a task\ncreate_task("Review PR #42", priority="high")\n\n# Agent B picks it up\ntasks = list_tasks(status="pending")\nif tasks:\n    task = tasks[0]\n    update_task(task["id"], status="in_progress")\n    # ... do work ...\n    update_task(task["id"], status="done")

Desen 2: Uzmanlaşmış Mind'ler (İzole Bağlamlar)

\n

Her ajanın kendi mind'i vardır. Paylaşımlı bir "koordinasyon" mind'i üzerinden iletişim kurarlar.

\n
┌──────────┐  ┌──────────┐  ┌──────────┐\n│ Coder    │  │ Reviewer │  │ Deployer │\n│ Agent    │  │ Agent    │  │ Agent    │\n└────┬─────┘  └────┬─────┘  └────┬─────┘\n     │             │             │\n     ▼             ▼             ▼\n┌─────────┐  ┌─────────┐  ┌─────────┐\n│ Mind C  │  │ Mind R  │  │ Mind D  │\n└─────────┘  └─────────┘  └─────────┘\n     │             │             │\n     └─────────────┼─────────────┘\n                   ▼\n           ┌──────────────────┐\n           │ Coordination Mind│\n           │ (shared)         │\n           └──────────────────┘

Kullanım senaryosu: Farklı uzmanlıklara sahip ajanlar (kodlama, inceleme, dağıtım).

\n

Kurulum:

\n
# Coder agent\nSYNAPSE_MIND_KEY=mk_coder... MCP_TRANSPORT=stdio npx synapse-mcp-api@latest\n\n# Reviewer agent\nSYNAPSE_MIND_KEY=mk_reviewer... MCP_TRANSPORT=stdio npx synapse-mcp-api@latest\n\n# Deployer agent\nSYNAPSE_MIND_KEY=mk_deployer... MCP_TRANSPORT=stdio npx synapse-mcp-api@latest

Paylaşımlı mind ile koordinasyon:

\n
# Coder stores "ready for review"\nCOORDINATION_KEY = "mk_coordination..."\nrequests.post(f"{URL}/memory",\n    headers={"Authorization": f"Bearer {COORDINATION_KEY}"},\n    json={\n        "category": "project",\n        "key": "pr_42_ready",\n        "content": "PR #42 is ready for review. Branch: feature/docs-system",\n        "tags": ["review", "pr-42"],\n        "priority": "high"\n    })\n\n# Reviewer polls for review requests\nr = requests.get(f"{URL}/memory/search?q=ready+for+review",\n    headers={"Authorization": f"Bearer {COORDINATION_KEY}"})

Desen 3: Hub-and-Spoke (Orkestratör)

\n

Merkezi bir orkestratör ajan, işçi ajanlara görevler atar.

\n
        ┌──────────────┐\n        │ Orchestrator │\n        │    Agent     │\n        └──────┬───────┘\n               │\n    ┌──────────┼──────────┐\n    ▼          ▼          ▼\n┌──────┐  ┌──────┐  ┌──────┐\n│Worker│  │Worker│  │Worker│\n│  A   │  │  B   │  │  C   │\n└──────┘  └──────┘  └──────┘

Kullanım senaryosu: Paralel çalışmalı karmaşık iş akışları.

\n

Uygulama:

\n
# Orchestrator\nclass Orchestrator:\n    def assign_task(self, worker_id, task_description):\n        # Store task in worker's mind (or shared coordination mind)\n        create_task(task_description, priority="high")\n        # Notify worker via chat\n        reply(f"@{worker_id}: New task — {task_description}")\n    \n    def check_progress(self):\n        tasks = list_tasks(status="in_progress")\n        for t in tasks:\n            print(f"{t['title']}: {t['status']}")\n\n# Workers poll for assigned tasks\nclass Worker:\n    def run(self):\n        while True:\n            tasks = list_tasks(status="pending")\n            for t in tasks:\n                if assigned_to_me(t):\n                    update_task(t["id"], status="in_progress")\n                    result = do_work(t)\n                    update_task(t["id"], status="done")\n                    reply(f"Completed: {t['title']}")\n            time.sleep(60)

Sohbet Üzerinden Koordinasyon

\n

Ajanlar sohbet sistemi üzerinden iletişim kurabilir:

\n
# Agent A sends to Agent B\nreply("@agent-b: Can you review my PR?")\n\n# Agent B polls and responds\nfor msg in poll_messages():\n    if "@agent-b" in msg["content"]:\n        reply(f"@agent-a: Sure, looking at it now.")
Sohbet mesajları rol etiketlidir. Ajan-ajan mesajları için role=agent, insan-ajan için role=human ayarlayın.

Değişkenler Üzerinden Koordinasyon

\n

Hafif koordinasyon (kilitler, bayraklar) için değişkenler kullanın:

\n
# Acquire a lock\ndef acquire_lock(name):\n    r = requests.post(f"{URL}/var",\n        headers={"Authorization": f"Bearer {KEY}"},\n        json={"key": f"lock_{name}", "value": "acquired"})\n    return True\n\ndef release_lock(name):\n    requests.delete(f"{URL}/var/lock_{name}",\n        headers={"Authorization": f"Bearer {KEY}"})\n\n# Use\nif acquire_lock("deploy"):\n    try:\n        deploy_to_production()\n    finally:\n        release_lock("deploy")

En İyi Uygulamalar

\n

Sonraki Adımlar

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