توپولوژی‌های هماهنگی: Orchestrator، Handoff و Blackboard

سه توپولوژی هماهنگی را از منظر مالکیت کنترل و حالت، قرارداد پیام، نسخه‌بندی، مجوز فیلدی و توقف انتخاب و روی دادهٔ ساختگی طراحی کن.

بعد از این درس می‌توانی

  • برای سه موقعیت، توپولوژی مناسب و مالک پاسخ/حالت را بدون خلط Handoff و فراخوانی متخصص تعیین کند.
  • یک قرارداد Dispatch با هدف، دامنه، خروجی، شناسه شاهد و snapshot طراحی کند.
  • یک Blackboard سه‌نقشی با ACL، کنترل نسخه و حالت VERSION_CONFLICT بنویسد.
  • برای یک دور تحویل، شمارنده و مسیر بررسی انسانی تعریف کند.
  • یافته‌های preprintهای تخته‌سیاه را با قید بنچمارک نقل کند.

چرا این درس مهم است

سناریوی ساختگی ایرانی: تعاونی «پارس‌تأمین» برای بررسی بسته‌های اسناد مناقصه سه متخصص مجازی تعریف کرده است. گاهی یک نفر باید زیرکارها را تقسیم کند، گاهی کار از فروش به امور قرارداد منتقل می‌شود و گاهی کارشناسان فقط باید یافته‌های مستقل را در یک مخزن مشترک ثبت کنند. این‌ها سه معماری متفاوت‌اند، نه سه اسم برای یک چت گروهی.

در agent-design-patterns پنج الگوی اولیه را دیده‌ای؛ اینجا مالکیت کنترل، قرارداد پیام، مالکیت حالت، رفع تعارض و توقف را مهندسی می‌کنی. ابزار واقعی و کدنویسی اجباری نداریم.

مفاهیم کلیدی

نگاشت به شاخص‌های موجود: C05-I01 تجزیهٔ کار، C05-I02 ورودی/خروجی، C05-I03 وابستگی‌ها، C05-I05 نقاط کنترل انسانی و C06-I03 آگاهی از حریم خصوصی.

[اصل پایدار] توپولوژی یعنی چه کسی کار را تعیین، به دیگری منتقل، نتیجه را جمع یا وضعیت مشترک را به‌روزرسانی می‌کند. بین سه محور تمایز بگذار: Control Owner، State Owner و Output Contract.

  • Orchestrator-Workers: هماهنگ‌کنندهٔ مرکزی در زمان اجرا زیرکارهای پویا می‌سازد، نتیجهٔ کارگران را می‌گیرد و تلفیق می‌کند.
  • Handoff: مالک پیگیری گفتگو/وظیفه از عامل فعلی به عامل مقصد می‌رود؛ مقصد باید زمینه و مسئولیت انتقال‌یافته را بشناسد.
  • Blackboard: عامل‌ها به یک ساختار دادهٔ مشترکِ نسخه‌دار می‌خوانند و در ناحیهٔ مجازشان می‌نویسند؛ امکان زمان‌بند قطعی وجود دارد.
  • Dispatch Contract: هدف، محدوده، شناسه ورودی، schema خروجی، مهلت، مجوز و حالت شکست.
  • Race Condition: دو نویسنده بر اساس نسخهٔ یکسان، دادهٔ دیگری را ناآگاهانه بازنویسی کنند.
  • Hop Limit: سقف تحویل برای جلوگیری از دور باطل.

مدل ذهنی

سازمان اداری: Orchestrator شبیه مدیر پروژه‌ای است که کار را بین کارشناسان پخش و گزارش یکپارچه می‌کند؛ Handoff مثل انتقال کامل پرونده از میز پذیرش به کارشناس قرارداد است؛ Blackboard مثل سامانهٔ ثبت پروندهٔ مشترک است که هر بخش فقط ستون‌های مجازش را ویرایش می‌کند.

این تشبیه نباید با تضمین رفتار مدل اشتباه گرفته شود. مرز واقعی در برنامه با شناسهٔ پرونده، فیلدهای مجاز، قفل/نسخه و آزمون تعریف می‌شود؛ صرف دستور پرامپت کافی نیست.

گام‌به‌گام

گام ۱: قبل از توپولوژی، کار را روی یک گراف رسم کن

سؤالپاسخ «بله»پیامد طراحی
آیا زیرکارها در زمان اجرا نامشخص‌اند؟بلهOrchestrator-Workers نامزد می‌شود
آیا باید مالک پاسخ یا گفتگو عوض شود؟بلهHandoff با دریافت‌کنندهٔ روشن
آیا چند متخصص به یک وضعیت پایدار می‌نویسند؟بلهBlackboard با نسخه و ACL
آیا همهٔ گام‌ها ثابت‌اند؟بلهقبل از MAS از Workflow ساده استفاده کن

گام ۲: `Orchestrator-Workers` را با قرارداد Dispatch بساز

{
  "task_id": "CASE-07",
  "worker_role": "contract_checker",
  "subtask_goal": "find missing clauses",
  "scope_boundaries": ["read only", "synthetic text"],
  "input_snapshot_id": "docs-v2",
  "allowed_document_ids": ["D01", "D02"],
  "expected_output_schema": {"findings": "array", "source_ids": "array", "status": "enum"},
  "deadline": "LOCAL_STEP_04",
  "status": "PENDING"
}

نکته: هماهنگ‌کننده نباید نتیجهٔ خالی کارگر را به ادعای قطعی تبدیل کند. خروجی کارگر باید وضعیت FOUND، NOT_FOUND یا REQUIRES_REVIEW و شناسهٔ شاهد داشته باشد.

گام ۳: `Handoff` را از «مشورت با متخصص» جدا کن

تبادلچه کسی مالک پاسخ نهایی است؟معیار قبولی
فراخوانی متخصص به‌عنوان ابزارعامل آغازگرمتخصص نتیجه برمی‌گرداند؛ مالک گفتگو عوض نمی‌شود
Handoff واقعیعامل مقصد پس از انتقالعامل مقصد مسئول پیگیری و نوبت بعدی است
ارجاع به انساناپراتور انسانیثبت دلیل توقف و جلوگیری از ادامهٔ خودکار
{
  "case_id": "CASE-07",
  "from_agent": "intake",
  "to_agent": "contract_review",
  "handoff_reason": "outside_intake_scope",
  "context_summary": "Only synthetic contract metadata",
  "source_snapshot_id": "docs-v2",
  "handoff_count": 1,
  "max_handoffs_test_value": 2,
  "fallback": "HUMAN_REVIEW"
}

حد max_handoffs_test_value صرفاً مقدار آموزشی است، نه مقدار بهینهٔ اثبات‌شده. اگر عامل‌ها همدیگر را ارجاع دهند، مسیر به HUMAN_REVIEW ختم می‌شود؛ نه به حلقهٔ بی‌نهایت.

گام ۴: `Blackboard` را با مالکیت فیلد طراحی کن

{
  "case_id": "CASE-07",
  "version": 3,
  "input_snapshot_id": "docs-v2",
  "slots": {
    "legal": {"owner": "legal_worker", "findings": [], "source_ids": []},
    "finance": {"owner": "finance_worker", "findings": [], "source_ids": []},
    "logistics": {"owner": "logistics_worker", "findings": [], "source_ids": []}
  },
  "review": {"owner": "human_supervisor", "status": "PENDING"}
}
عاملخواندننوشتنکنترل مستقل
legal_workermetadata و هر سه slot قابل‌مشاهدهفقط slots.legalبررسی نسخهٔ سند
finance_workermetadata و slot حقوقیفقط slots.financeصحت محاسبات مستقل از مدل
logistics_workermetadata و slot مالیفقط slots.logisticsکنترل منشأ داده
human_supervisorهمهٔ وضعیت‌های مجازفقط review.statusتأیید نسخهٔ نهایی

[اصل پایدار] برای هر به‌روزرسانی از expected_version استفاده کن؛ اگر نسخه در زمان ثبت تغییر کرد، به‌جای overwrite بی‌صدا، VERSION_CONFLICT برگردان. روی کاغذ شبیه‌سازی کن؛ پایگاه داده اجباری نیست.

گام ۵: مقایسه و حد توقف

توپولوژیتوان بالقوهشکست مهمکنترل
Orchestrator-Workersزیرکار پویا و تلفیق مرکزیتقسیم مبهم یا نتیجه تکراریشرح مأموریت دقیق، شناسه کار، ادغام
Handoffمسیر‌یابی بین تخصص‌هارفت‌وبرگشت بی‌پایانسقف تحویل، مالک پاسخ، انسان
Blackboardحالت مشترک با نوشتن مستقلمسابقه و حذف شواهدنسخه، ACL، قفل/تعارض

گام ۶: پژوهش را با نوع شاهدش بخوان

[پژوهش؛ preprint] مطالعهٔ Salemi دربارهٔ کشف اطلاعات در داده‌های ناهمگن، نتایج تجربی مثبتی برای معماری تخته‌سیاه در مجموعه‌بنچمارک‌های خودش گزارش کرده است. مطالعهٔ Han & Zhang نیز یک پیاده‌سازی و آزمون محدود ارائه می‌دهد. هیچ‌کدام به معنای کاهش تضمین‌شدهٔ توکن یا برتری در هر پروژه نیست.

گام ۷: Trace کافی برای اشکال‌زدایی ثبت کن

{
  "trace_id": "T-001",
  "case_id": "CASE-07",
  "event": "worker_result_received",
  "agent_role": "legal_worker",
  "input_snapshot_id": "docs-v2",
  "blackboard_version_before": 3,
  "blackboard_version_after": 4,
  "output_status": "REQUIRES_REVIEW",
  "evidence_ids": ["D01:S3"],
  "secret_or_chain_of_thought": "NOT_STORED"
}

مثال‌ها

پیاده‌سازی عملی

کارگاه رایگان آفلاین: سه پروندهٔ ساختگی بساز و برای هرکدام یک معماری، قرارداد پیام و Trace مختصر تحویل بده. همهٔ JSONها صرفاً نمونهٔ داده هستند و به سرور وصل نمی‌شوند.

تقسیم پویا

پیوست‌های یک پروندهٔ ساختگی شامل قرارداد اصلی، بیمه و جدول قیمت‌اند؛ پروندهٔ دیگر یکی از پیوست‌ها را ندارد.

  1. در زمان اجرا فقط کارگران لازم را انتخاب کن.
  2. برای نبود پیوست خروجی NOT_FOUND تعریف کن.
  3. نتیجهٔ تلفیقی باید به source_id هر زیرگزارش وصل باشد.

پذیرش: شرح کار و وضعیت شکست هر کارگر روشن باشد.

حالت مشترک

یک JSON مشترک با فیلدهای حقوقی، مالی و اجرایی بساز.

  1. به هر نقش slot نوشتن اختصاصی بده.
  2. دو به‌روزرسانی همزمان با expected_version=2 را شبیه‌سازی کن.
  3. دومی باید VERSION_CONFLICT بگیرد و نسخهٔ قبل حذف نشود.

پذیرش: هر تعارض قابل بازیابی و ردگیری باشد.

تحویل: یک جدول انتخاب معماری، یک پیام Dispatch، یک رکورد Handoff و یک Blackboard با ACL. بدون Docker یا API نیز قابل بررسی است.

اشتباه‌های رایج

اشتباهاثراصلاح
Handoff را فقط دریافت نظر متخصص نامیدنمالک پاسخ مبهم می‌شودمالک نوبت بعدی را صریح ثبت کن
اشتراک تاریخچهٔ کاملمصرف و افشای غیرضروریارسال خلاصه و شناسه سند مجاز
Blackboard بدون نسخهحذف یا تعارض خاموشexpected_version و VERSION_CONFLICT
استفاده از Orchestrator برای ۳ کار ثابتپیچیدگی بی‌دلیلWorkflow با سه گام ثابت
ادعای مقیاس‌پذیری بدون آزمونتعمیم نتایج preprintآزمون با مورد و سقف مشخص

عیب‌یابی

دو ایجنت مدام پرونده را به هم می‌سپارند

مرز مسئولیت و سقف تحویل روشن نیست

دنباله from/to/handoff_count را مرور کن

سقف آزمایشی و خروج به انسان بگذار.

یکی از یافته‌های حقوقی ناپدید شد

نوشتن مشترک بدون کنترل نسخه رخ داده

نسخهٔ قبل و پس از هر write را مقایسه کن

ACL فیلدی و optimistic locking در طراحی بیاور.

خروجی تلفیقی منبع ندارد

کارگر قرارداد شاهد را تحویل نداده

source_ids و input_snapshot_id را بررسی کن

خروجی بی‌سند را REQUIRES_REVIEW نگه‌دار.

هزینه و زمان زیاد شد

تقسیم زیرکارهای بسیار وابسته

گراف وابستگی را در برابر تعداد پیام‌ها بگذار

بازطراحی به Workflow یا کم‌کردن کارگرها.

ایمنی و حریم خصوصی

تمرین کوتاه

تمرین · 10 دقیقه

سه وضعیت ساختگی: (الف) یک پژوهش با زیرموضوع‌های پویا و جمع‌بندی مرکزی؛ (ب) چت خدماتی با انتقال مسئولیت؛ (پ) چند ارزیاب که بخش‌های جداگانهٔ یک پرونده را به‌روز می‌کنند.

کار: توپولوژی مناسب هر مورد را انتخاب کن، مالک کنترل و مالک حالت را بنویس و یک حالت شکست مشخص کن.

پذیرش: هر سه انتخاب با دلیل؛ برای Handoff سقف و برای Blackboard مجوز نوشتن مشخص باشد.

راه‌حل نمونه
  • الف: Orchestrator-Workers اگر تقسیم پویا واقعاً لازم باشد؛ کنترل نزد هماهنگ‌کننده.
  • ب: Handoff؛ مسئولیت نوبت بعدی به متخصص مقصد منتقل می‌شود.
  • پ: Blackboard؛ نوشتن هر عامل فقط در slot اختصاصی با کنترل نسخه.
  • شکست‌ها: کارگر بی‌سند، حلقهٔ تحویل، تعارض نسخه.

چالش

تمرین · 35 دقیقه

مورد پروژهٔ طراحی (ساختگی): در «پارس‌تأمین»، کارشناس حقوقی، مالی و حمل‌ونقل سه گزارش روی یک پروندهٔ مناقصه می‌نویسند. گاهی باید پرونده از پذیرش به متخصص منتقل شود و گاهی ضمائم پرونده قابل‌پیش‌بینی نیستند.

  1. برای هر فعالیت یکی از سه توپولوژی یا Workflow ساده را انتخاب و رد گزینه‌های دیگر را توضیح بده.
  2. یک قرارداد Dispatch با هدف، مجوز، snapshot و source_ids بساز.
  3. یک Handoff با max_handoffs_test_value و مسیر انسان طراحی کن.
  4. برای Blackboard، ACL سه نقش، expected_version و پاسخ تعارض نسخه بنویس.
  5. سه آزمون منفی طراحی کن: سند بدون منبع، حلقهٔ انتقال و بازنویسی فیلد دیگر.

پذیرش: هر کنترل به یک شکست مشخص وصل باشد؛ هیچ ارسال یا پرداخت واقعی وجود نداشته باشد و اجرای تست ادعا نشود.

راه‌حل نمونه

پاسخ نمونه: تفکیک زیرکار نامعلوم با Orchestrator، انتقال مالک گفتگو با Handoff و تجمیع یافتهٔ مستقل با Blackboardِ نسخه‌دار؛ برای مراحل ثابت از Workflow استفاده می‌شود.

  • source_ids خالی → REQUIRES_REVIEW.
  • تحویل فراتر از سقف → HUMAN_REVIEW.
  • نوشتن در slot غیرمجاز یا نسخه قدیمی → DENIED یا VERSION_CONFLICT.

پرسش‌های سنجش

جمع‌بندی

  • Orchestrator-Workers: تقسیم و تلفیق پویا تحت مالک مرکزی.
  • Handoff: انتقال مالکیت پیگیری؛ جلوگیری از حلقهٔ ارجاع.
  • Blackboard: اشتراک داده با ACL، نسخه و حل تعارض؛ نه چت گروهی.
  • پژوهش‌های تخته‌سیاه شواهد محدود و نسخه‌دارند، نه تضمین عمومی.

قدم بعدی

در agent-protocols-mcp-a2a تفاوت ارتباط با ابزار (MCP) و ارتباط میان سامانه‌های عامل (A2A) را به قراردادها وصل می‌کنی.

منابع پشتیبان این درس: Building effective agentssrc-an، Agents SDK: Orchestration and Handoffssrc-openai، LLM-based Multi-Agent Blackboard System for Information Discovery in Data Sciencesrc-black1، Exploring Advanced LLM Multi-Agent Systems Based on Blackboard Architecturesrc-black2، Towards a Science of Scaling Agent Systems, arXiv v3src-scale.

پرسش‌های سنجش

وقتی ایجنت پذیرش پرونده را به متخصص می‌سپارد و متخصص پاسخ‌گویی را ادامه می‌دهد، الگوی غالب چیست؟

  • Parallelization ثابت
  • Handoff
  • Blackboard بدون مالک
  • یک فراخوانی تنها
پاسخ نمونه و معیار ارزیابی
  • a ← این صرفاً موازی‌سازی نیست.
  • c ← حالت مشترک لزوماً انتقال مالکیت نیست.
  • d ← گفتگو منتقل شده است.

قرارداد Dispatch برای یک Worker پویا حداقل چه فیلدهایی لازم دارد؟

پاسخ نمونه و معیار ارزیابی

task_id، هدف زیرکار، محدودیت دامنه/مجوز، input_snapshot_id، فهرست منبع مجاز، schema خروجی، وضعیت شکست و مهلت یا سقف آزمایشی.

  • اصل فنی و انتخاب درست را توضیح می‌دهد (1 امتیاز)
  • قید، محدودیت یا حالت شکست را بیان می‌کند (1 امتیاز)
  • یک کنترل یا پاسخ قابل‌مشاهده و سنجش‌پذیر می‌آورد (1 امتیاز)
  • * ← نام کارگر بدون دامنه و قرارداد خروجی کافی نیست.

دو نویسنده همزمان نسخهٔ ۳ تخته‌سیاه را خوانده‌اند. نویسندهٔ اول نسخه ۴ ساخته؛ دومی چه کند؟

پاسخ نمونه و معیار ارزیابی

نوشتن مبتنی بر expected_version=3 را با VERSION_CONFLICT رد کند، دوباره نسخهٔ فعلی را بخواند و طبق سیاست حل تعارض اقدام کند.

  • اصل فنی و انتخاب درست را توضیح می‌دهد (1 امتیاز)
  • قید، محدودیت یا حالت شکست را بیان می‌کند (1 امتیاز)
  • یک کنترل یا پاسخ قابل‌مشاهده و سنجش‌پذیر می‌آورد (1 امتیاز)
  • * ← Overwrite بی‌صدا باعث حذف شواهد می‌شود.

برای سه بررسی کاملاً ثابت و مستقل، آیا الزاماً Orchestrator پویا لازم است؟

پاسخ نمونه و معیار ارزیابی

خیر؛ می‌توان Workflow با شاخه‌های موازی ثابت ساخت. Orchestrator هنگامی ارزش دارد که زیرکارها و تقسیم کار به ورودی وابسته باشند.

  • اصل فنی و انتخاب درست را توضیح می‌دهد (1 امتیاز)
  • قید، محدودیت یا حالت شکست را بیان می‌کند (1 امتیاز)
  • یک کنترل یا پاسخ قابل‌مشاهده و سنجش‌پذیر می‌آورد (1 امتیاز)
  • * ← چند گام به‌تنهایی دلیل MAS نیست.

برای جلوگیری از حلقهٔ Handoff چه سه کنترل بنویسی؟

پاسخ نمونه و معیار ارزیابی

مرز نقش‌ها/مالکیت پاسخ، handoff_count و سقف آزمایشی روشن، مسیر HUMAN_REVIEW همراه با دلیل توقف.

  • اصل فنی و انتخاب درست را توضیح می‌دهد (1 امتیاز)
  • قید، محدودیت یا حالت شکست را بیان می‌کند (1 امتیاز)
  • یک کنترل یا پاسخ قابل‌مشاهده و سنجش‌پذیر می‌آورد (1 امتیاز)
  • * ← فقط نوشتن «حلقه نزن» در پرامپت کافی نیست.

ابزارها و جایگزین‌ها

  • ویرایشگر متن آفلاین — ثبت تصمیم، قرارداد و شواهد بدون کلید API یا اشتراک پولی — Notepad — ویرایشگر Markdown — قلم و کاغذ
  • صفحه‌گسترده یا جدول محلی — ثبت سناریوها، محاسبات و نتیجهٔ آزمون — LibreOffice Calc — Excel — جدول کاغذی

منابع

Building effective agents Anthropic Engineering 2024-12-19؛ یادداشت رسمی مهندسی، داوری دانشگاهی ندارد؛ بازبینی 2026-11-07

Agents SDK: Orchestration and Handoffs OpenAI مستند رسمی نسخه‌پذیر؛ بررسی در 2026-11-07؛ راهنمای محصول، نه مقاله داوری‌شده

LLM-based Multi-Agent Blackboard System for Information Discovery in Data Science Salemi et al. 2025-09-30؛ preprint؛ پژوهش تجربی در بنچمارک‌های کشف داده، نه تضمین عمومی؛ بازبینی 2026-11-07

Exploring Advanced LLM Multi-Agent Systems Based on Blackboard Architecture Han & Zhang 2025-07-02؛ preprint؛ ارزیابی محدود به مجموعه‌داده‌های مقاله؛ بازبینی 2026-11-07

Towards a Science of Scaling Agent Systems, arXiv v3 Kim et al.; Google Research / Google DeepMind / MIT 2025-12-09؛ نسخهٔ سوم 2026-04-08؛ preprint، داوری‌شده‌بودن تأیید نشد؛ ۲۶۰ پیکربندی، ۶ بنچمارک؛ بازبینی 2026-11-07

دوره

سیستم‌های چندایجنتی: کی بله، کی نه