Coordination Topologies: Orchestrator, Handoff, and Blackboard
Design and compare three coordination topologies via control/state ownership, message contracts, versioning, field ACLs, and stopping rules.
بعد از این درس میتوانی
- برای سه موقعیت، توپولوژی مناسب و مالک پاسخ/حالت را بدون خلط
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_worker | metadata و هر سه slot قابلمشاهده | فقط slots.legal | بررسی نسخهٔ سند |
finance_worker | metadata و slot حقوقی | فقط slots.finance | صحت محاسبات مستقل از مدل |
logistics_worker | metadata و 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ها صرفاً نمونهٔ داده هستند و به سرور وصل نمیشوند.
تقسیم پویا
پیوستهای یک پروندهٔ ساختگی شامل قرارداد اصلی، بیمه و جدول قیمتاند؛ پروندهٔ دیگر یکی از پیوستها را ندارد.
- در زمان اجرا فقط کارگران لازم را انتخاب کن.
- برای نبود پیوست خروجی
NOT_FOUNDتعریف کن. - نتیجهٔ تلفیقی باید به source_id هر زیرگزارش وصل باشد.
پذیرش: شرح کار و وضعیت شکست هر کارگر روشن باشد.
حالت مشترک
یک JSON مشترک با فیلدهای حقوقی، مالی و اجرایی بساز.
- به هر نقش slot نوشتن اختصاصی بده.
- دو بهروزرسانی همزمان با
expected_version=2را شبیهسازی کن. - دومی باید
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 دقیقه
مورد پروژهٔ طراحی (ساختگی): در «پارستأمین»، کارشناس حقوقی، مالی و حملونقل سه گزارش روی یک پروندهٔ مناقصه مینویسند. گاهی باید پرونده از پذیرش به متخصص منتقل شود و گاهی ضمائم پرونده قابلپیشبینی نیستند.
- برای هر فعالیت یکی از سه توپولوژی یا
Workflowساده را انتخاب و رد گزینههای دیگر را توضیح بده. - یک قرارداد Dispatch با هدف، مجوز، snapshot و
source_idsبساز. - یک
Handoffباmax_handoffs_test_valueو مسیر انسان طراحی کن. - برای Blackboard، ACL سه نقش،
expected_versionو پاسخ تعارض نسخه بنویس. - سه آزمون منفی طراحی کن: سند بدون منبع، حلقهٔ انتقال و بازنویسی فیلد دیگر.
پذیرش: هر کنترل به یک شکست مشخص وصل باشد؛ هیچ ارسال یا پرداخت واقعی وجود نداشته باشد و اجرای تست ادعا نشود.
راهحل نمونه
پاسخ نمونه: تفکیک زیرکار نامعلوم با 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ثابتHandoffBlackboardبدون مالک- یک فراخوانی تنها
پاسخ نمونه و معیار ارزیابی
- 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