Human Approval and Action Boundaries
Decide which actions need approval, bind approval to the exact draft, approver role and deadline, and handle approve, reject and timeout.
بعد از این درس میتوانی
- با معیار اثر، برگشتپذیری و نوآوری ورودی تعیین کند کدام اقدام تأیید انسانی لازم دارد و کدام نه.
- تأیید را به نسخه دقیق پیشنویس، نقش تأییدکننده، مهلت و یکبار مصرف گره بزند.
- در n8n تأیید پیام یا تأیید فراخوانی ابزار را با سه شاخه تأیید، رد و پایان مهلت بسازد.
- برای تأیید، دفتر ثبت بدون داده حساس طراحی کند که بعداً بشود گفت چه کسی، چه چیزی را، کی تأیید کرد.
چرا این درس مهم است
ورکفلوی پاسخ برگ سبز «تأیید انسانی» داشت: پیشنویس در گروه کارمندان میآمد و هر کس «تأیید» میزد، ارسال میشد. یک روز کارمندی پیشنویس را پس از درخواست تأیید ویرایش کرد و «۷۲ ساعت» را «۲۴ ساعت» نوشت؛ مسئول، نسخه قبلی را دیده و تأیید کرده بود، ولی نسخه ویرایششده رفت. روز دیگر درخواست تأییدی شب جمعه آمد و تا شنبه کسی ندید؛ مشتری سه روز بیجواب ماند. و یک کارآموز، تأیید بازپرداخت را زد چون دکمه برایش هم فعال بود.
تأیید انسانی فقط «یک دکمه قبل از ارسال» نیست. باید روشن باشد چه چیزی تأیید میشود (دقیقاً کدام نسخه)، چه کسی حق تأیید دارد، تا کی، و اگر کسی جواب نداد چه میشود. این درس اینها را میسازد و پایه پروژه ۴ است.
مفاهیم کلیدی
یادآوری: انسان در حلقه، برگشتپذیری و شعاع اثر را در دوره FND-103، و «تأیید پیش از اثرگذاشتن» را در طرح خودکارسازی دوره پایه دیدی.
- Approval Gate (دروازه تأیید): نقطهای که ورکفلو تا تصمیم یک انسان مشخص متوقف میماند.
- Action Boundary (مرز اقدام): خطی که مشخص میکند ورکفلو یا مدل کدام کارها را خودش انجام میدهد و کدام را فقط پیشنهاد میکند.
- Version-bound Approval (تأیید وابسته به نسخه): تأییدی که فقط برای همان نسخه دقیقی معتبر است که به تأییدکننده نشان داده شد.
- Approval Timeout (پایان مهلت تأیید): وقتی تأییدکننده در مهلت مشخص تصمیم نگرفته و ورکفلو باید رفتار از پیش تعیینشدهای داشته باشد.
- Audit Log (دفتر ثبت رویداد): سابقه تغییرناپذیر اینکه چه کسی، چه چیزی را، کی تأیید یا رد کرد.
مدل ذهنی
تأیید را مثل امضای چک ببین. امضا پای یک چک مشخص با مبلغ مشخص است؛ اگر کسی بعد از امضا مبلغ را عوض کند، امضا بیاعتبار است. فقط کسی که حق امضا دارد میتواند امضا کند. چک تاریخ دارد. و یک چک فقط یک بار نقد میشود.
چرخه یک درخواست تأیید
این تشبیه کجا غلط است؟ امضاکننده چک معمولاً وقت دارد چک را بخواند. در عمل، تأییدکنندهای که روزی صد درخواست میگیرد، بدون خواندن «تأیید» میزند؛ تأیید انسانی که به عادت تبدیل شده، کنترل نیست. برای همین درخواست تأیید باید کم (فقط جایی که لازم است) و خوانا (همان چیزی که اثر میگذارد) باشد.
گامبهگام
گام ۱: کجا تأیید لازم است
راهنمای نظارت انسانی وبلاگ n8n اینها را نیازمند تأیید میداند: خروجیهای پرریسکی که به مشتری، شریک یا عموم میرسند؛ اقدامهای برگشتناپذیر مثل نوشتن در پایگاه داده، تراکنش مالی و تغییر حساب؛ و ورودیهای تازه یا مبهم. و پیشنهاد میکند برای اقدامهای بهآسانی برگشتپذیر، خروجی داخلی کمریسک و کارهایی که مدل روی آنها بارها آزموده شده، تأیید نگذاریsrc-n8n-blog-human-oversight.
| اقدام برگ سبز | تأیید؟ | چرا |
|---|---|---|
| مسیریابی داخلی تیکت | نه | داخلی و برگشتپذیر |
| پاسخ عمومی «پیامت ثبت شد» با قالب ثابت | نه | قالب یک بار تأیید شده |
| پیشنویس پاسخ با محتوای مدل به مشتری | بله | رو به مشتری |
| لغو سفارش یا بازپرداخت | بله، نقش مشخص | مالی و سخت برگشتپذیر |
| پیام به همه مشتریان | بله، دو نفر | اثر گسترده |
گام ۲: تأیید را گره بزن
assets/approval_gate.py چهار قاعده را پیاده میکند:
- نسخه: درخواست هش پیشنویس را نگه میدارد؛ اگر پیشنویس پس از درخواست عوض شد، تأیید رد میشود و درخواست تازه لازم است. ارسال هم دوباره هش را بررسی میکند.
- نقش: فقط نقش تعیینشده (مثلاً «سرپرست پشتیبانی») تأیید میکند.
- مهلت: درخواست تاریخ انقضا دارد.
- یکبار مصرف: تأییدشده فقط یک بار ارسال میشود.
در خروجی نمونه، هر هفت حالت (نقش اشتباه، پیشنویس ویرایششده، ارسال متن ویرایششده، ارسال دوباره، پایان مهلت و…) دیده میشود.
گام ۳: سه نتیجه، نه دو
هر دروازه تأیید سه خروجی دارد: تأیید، رد، پایان مهلت. وبلاگ n8n پیشنهاد میکند روی گرههای تأیید «Limit Wait Time» بگذاری چون «ورکفلویی که تا ابد منتظر میماند، ورکفلویی است که بیصدا شکست میخورد»، و پس از هر گره تأیید با Switch سه شاخه تأیید، رد و پایان مهلت بسازی؛ مهلت پیشنهادی آن برای تأییدهای عملیاتی چند ساعت استsrc-n8n-blog-human-oversight. رفتار پایان مهلت را از پیش تعیین کن:
- رو به مشتری: ارجاع به نفر بعد یا مدیر.
- داخلی: معمولاً پیشفرض امنتر ارسال نکردن استsrc-n8n-blog-human-oversight.
و رد هم مسیر دارد: به نویسنده پیشنویس با دلیل، یا به صف دستی.
گام ۴: دو شکل تأیید در n8n
- تأیید پیام پیش از ارسال: گرههای پیام (مثل گره Chat، Slack، Gmail یا Teams) عملیات «فرستادن پیام و انتظار برای پاسخ» با دکمههای تأیید و رد دارندsrc-n8n-blog-human-oversight. پیشنویس را در پیام تأیید کامل نشان بده، نه خلاصهاش.
- تأیید فراخوانی ابزار ایجنت: در پنل ابزارهای گره AI Agent یک «Human review» اضافه میکنی و ابزارهای پرخطر را به آن وصل میکنی؛ ورکفلو پیش از اجرای آن ابزار میایستد، تأییدکننده نام ابزار و پارامترها را میبیند؛ با تأیید، ابزار با همان ورودی اجرا میشود و با رد، لغو میشود و به مدل اطلاع داده میشودsrc-n8n-hitl-tools. مستندات توصیه میکند در پیام سیستمی بگویی کدام ابزارها بازبینی میشوند و مدل پس از رد چه کندsrc-n8n-hitl-tools. این قابلیت تازه است؛ رفتارش را در نسخه n8n خودت با یک رد عمدی بیازما.
تأیید ابزار در n8n به همان پارامترهایی گره خورده که تأییدکننده دیده است؛ ولی برای پیام پیش از ارسال، اگر پیشنویس در گامهای بعد تغییر میکند، بررسی نسخه (گام ۲) را خودت بساز.
گام ۵: دفتر ثبت
برای هر درخواست: شناسه، هش نسخه، نقش، تصمیم، زمان، و اگر رد شد دلیل. بدون متن پیشنویس یا داده مشتری در دفتر (متن جای جدا با دسترسی محدود). این دفتر جواب پرسش «چه کسی این پیام را تأیید کرد؟» است.
مثالها
پیادهسازی عملی
دروازه تأیید و سیاست تأیید. حدود ۲۲ دقیقه.
- assets/approval-policy-template.md را برای ورکفلوی «پاسخ سفارش» برگ سبز پر کن: کدام اقدامها، چه نقشی، مهلت، رفتار پایان مهلت و رد.
- یکی از مسیرهای پایین را برو.
- بنویس اگر در ورکفلوی تو پیشنویس پس از درخواست تأیید میتواند تغییر کند، بررسی نسخه را کجا میگذاری.
بدون اجرا / شبیهساز
بدون مدل و بدون پیامرسان: python approval_gate.py demo را اجرا کن (فایل assets/approval_gate.py) یا خروجی assets/sample-run.txt را بخوان. برای هر هفت حالت بنویس کدام قاعده (نسخه، نقش، مهلت، یکبار مصرف) آن را گرفت. سپس یک حالت هشتم اضافه کن: «ردشده، سپس تلاش برای تأیید».
اجرای محلی
در n8n محلی: ورکفلو با Manual Trigger ← Edit Fields (پیشنویس ساختگی و هش آن با گره Code یا تابع رمزنگاری) ← گره پیام با «فرستادن و انتظار برای پاسخ» در کانال گفتگوی داخلی n8n یا کانالی که داری، با مهلت کوتاه برای آزمون ← Switch سهشاخه. در شاخه تأیید، پیش از ارسال هش را دوباره بررسی کن. یک بار تأیید، یک بار رد، و یک بار بیپاسخ بگذار تا مهلت تمام شود.
سرویس میزبانیشده (در دسترس قانونی)
اگر ایجنت n8n با یک ارائهدهنده مدل در دسترس قانونی داری: یک ابزار «لغو سفارش» ساختگی (Edit Fields یا HTTP Request به API آزمایشی) بساز و آن را به Human review وصل کن. پیام سیستمی بگوید این ابزار بازبینی میشود و پس از رد چه کند. یک بار رد کن و ببین ایجنت چه پاسخی به کاربر میدهد.
اشتباههای رایج
| اشتباه | نتیجه | کار درست |
|---|---|---|
| تأیید برای همه چیز | تأیید عادتی و بیاثر | فقط اقدام پراثر، برگشتناپذیر یا تازه |
| تأیید بدون وابستگی به نسخه | متن تأییدنشده ارسال میشود | هش نسخه در درخواست و در ارسال |
| هر کسی در گروه میتواند تأیید کند | تصمیم مالی با نقش نادرست | نقش مشخص |
| انتظار بیپایان | مشتری بیجواب، شکست بیصدا | مهلت و شاخه پایان مهلت |
| نمایش خلاصه بهجای متن کامل | تأیید چیزی که دیده نشده | همان چیزی که اثر میگذارد |
| تأیید بهجای دسترسی کمینه | ابزار خطرناک فقط با یک کلیک فاصله | ابزار را اصلاً نده |
| متن پیشنویس در دفتر ثبت | داده مشتری در سابقه گسترده | فقط هش و شناسه |
اشکالزدایی
درخواستهای تأیید آخر هفته روزها بیجواب میمانند.
مهلت ندارد، یا شاخه پایان مهلت به جایی وصل نیست.
اجراهای منتظر در فهرست اجراها و سن آنها را ببین.
مهلت مشخص؛ پایان مهلت به نفر بعد یا مدیر؛ برای داخلی، عدم ارسال و هشدار.
متن ارسالشده با متنی که تأییدکننده دیده بود فرق دارد.
پیشنویس پس از درخواست ویرایش یا دوباره تولید شده و تأیید به نسخه گره نخورده است.
هش متن ارسالشده را با هش ثبتشده در دفتر مقایسه کن.
هش در درخواست و بررسی دوباره پیش از ارسال؛ هر تغییر، درخواست تازه.
پس از رد تأیید ابزار، ایجنت به کاربر میگوید «انجام شد».
پیام سیستمی نگفته پس از رد چه کند، یا نسخه n8n رفتار متفاوتی دارد.
اجرا را ببین: ابزار اجرا شد یا نه؟ پاسخ مدل پس از رد چه بود؟
پیام سیستمی صریح درباره رد؛ آزمون رد عمدی پس از هر بهروزرسانی n8n.
تمرین کوتاه
تمرین · 10 دقیقه
هدف: طراحی سیاست تأیید.
گامها: برای ورکفلوی «پیام به مشتریانی که سبد خرید رها کردهاند» با تخفیف ۱۰ درصدی، بنویس: آیا تأیید لازم است؟ کدام بخش؟ چه کسی؟ مهلت و رفتار پایان مهلت؟
معیار پذیرش: تأیید قالب و تخفیف (نه هر پیام) با نقش بازاریابی یا مدیر؛ مهلت؛ پایان مهلت = ارسال نشود؛ هر تغییر قالب یا درصد تخفیف، تأیید تازه.
راهحل نمونه
پیامها زیاد و قالبیاند، پس تأیید هر پیام عادتی میشود. بهجایش قالب و درصد تخفیف یک بار توسط مدیر فروش تأیید میشود (وابسته به نسخه قالب). هر پیام از قالب تأییدشده ساخته میشود و فقط نام و سبد عوض میشود. مهلت تأیید قالب مثلاً یک روز کاری؛ پایان مهلت = کمپین شروع نشود و هشدار. هر تغییر متن یا درصد تخفیف = نسخه تازه و تأیید تازه. نمونهبرداری هفتگی از پیامهای ارسالشده.
چالش
تمرین · 30 دقیقه
موقعیت: در طرح خودکارسازی کار خودت، همه اقدامهای اثردار را پیدا کن و سیاست تأیید بنویس. اگر داده حساس است، نمونهها را ساختگی کن.
- جدول اقدامها: اثر، برگشتپذیری، تازگی ورودی، و تصمیم تأیید (با دلیل).
- برای هر اقدام نیازمند تأیید: نقش، مهلت، رفتار پایان مهلت و رد، و آنچه به تأییدکننده نشان داده میشود.
- سازوکار وابستگی به نسخه و یکبار مصرف را برای دستکم یک اقدام پیاده یا شبیهسازی کن (n8n یا
approval_gate.py). - نمونه دفتر ثبت برای سه رویداد.
خروجی مورد انتظار: جدول اقدامها، سیاست تأیید، شاهد اجرای سازوکار نسخه و نمونه دفتر ثبت.
معیار پذیرش:
- هیچ اقدام مالی یا رو به مشتریِ تولیدشده با مدل بدون تأیید یا دلیل روشن نیست.
- هر دروازه تأیید سه نتیجه دارد.
- تأیید به نسخه گره خورده است.
- دفتر ثبت داده حساس ندارد.
پرسشهای سنجش
جمعبندی
- تأیید برای اقدام پراثر، برگشتناپذیر یا ورودی تازه؛ نه برای همه چیز.
- تأیید به نسخه دقیق، نقش، مهلت و یکبار مصرف گره بخورد.
- هر دروازه سه نتیجه دارد: تأیید، رد، پایان مهلت؛ هرکدام مسیر از پیش تعیینشده.
- در n8n: انتظار با تأیید در گرههای پیام، و Human review برای ابزارهای ایجنت.
- دفتر ثبت با شناسه و هش، بدون متن و داده حساس.
- تأیید جایگزین دسترسی کمینه نیست.
پرسشهای سنجش
برای هر اقدام بگو تأیید انسانی لازم است یا نه، و چرا: (الف) برچسبزدن تیکتها با مدل برای گزارش داخلی؛ (ب) ارسال کد تخفیف ۵۰ درصدی به مشتری ناراضی که مدل پیشنهاد داده؛ (ج) پاککردن سفارشهای آزمایشی قدیمی از پایگاه داده؛ (د) پیام خوشآمد با قالب ثابت به مشتری تازه.
پاسخ نمونه و معیار ارزیابی
(الف) نه؛ داخلی و برگشتپذیر، با نمونهبرداری. (ب) بله؛ مالی و رو به مشتری و پیشنهاد مدل، با نقش مشخص. (ج) بله؛ برگشتناپذیر، حتی اگر «آزمایشی» است (یا بهتر: ابزار حذف اصلاً به خودکارسازی داده نشود). (د) نه برای هر پیام؛ قالب یک بار تأیید شده است.
- الف و د بدون تأیید با دلیل (1 امتیاز)
- ب با تأیید و نقش (1 امتیاز)
- ج با تأیید یا حذف ابزار (1 امتیاز)
- همه تأیید لازم دارند ← تأیید زیاد به عادت تبدیل میشود و دیگر کنترل نیست.
دفتر ثبت نشان میدهد درخواست apr_1 ساعت ۱۰:۰۰ برای پیشنویسی با هش a1 ساخته شد، ساعت ۱۰:۲۰ تأیید شد، و ساعت ۱۰:۲۵ پیامی با هش b7 ارسال شد. چه ایرادی در ورکفلو هست و چطور جلویش را میگیری؟
پاسخ نمونه و معیار ارزیابی
متن ارسالشده با متن تأییدشده یکی نیست؛ پیشنویس پس از تأیید (یا پس از درخواست) تغییر کرده یا دوباره تولید شده و ارسال، نسخه را بررسی نکرده است. اصلاح: پیش از ارسال هش متن را با هش درخواست تأییدشده مقایسه کن؛ اگر فرق دارد، ارسال نکن و درخواست تازه بساز. و هیچ گامی پس از تأیید نباید متن را تغییر دهد.
- اختلاف هش را ارسال تأییدنشده میداند (1 امتیاز)
- بررسی هش پیش از ارسال (1 امتیاز)
- درخواست تازه برای هر تغییر (1 امتیاز)
- مشکلی نیست چون تأیید شده ← چیزی که تأیید شد، ارسال نشد.
در n8n، دروازه تأیید پیشنویس پاسخ به مشتری را طراحی کن: گرهها، مهلت و سه شاخه با رفتار هرکدام.
پاسخ نمونه و معیار ارزیابی
پس از گره تولید پیشنویس: Edit Fields یا Code که هش پیشنویس را بسازد؛ گره پیام با «فرستادن و انتظار برای پاسخ» به کانال سرپرست با متن کامل و دکمه تأیید و رد، با Limit Wait Time مثلاً ۲ تا ۴ ساعت؛ Switch سهشاخه: تأیید ← بررسی دوباره هش ← ارسال با کلید ایدمپوتنسی ← ثبت؛ رد ← بازگشت به صف دستی با دلیل ← ثبت؛ پایان مهلت ← ارجاع به مدیر یا نفر بعد و هشدار ← ثبت.
- انتظار با تأیید و مهلت (1 امتیاز)
- سه شاخه با رفتار (1 امتیاز)
- بررسی هش پیش از ارسال (1 امتیاز)
- ثبت در هر شاخه (1 امتیاز)
- فقط تأیید و رد ← بدون شاخه پایان مهلت، ورکفلو بیصدا منتظر میماند.
ابزار «ثبت بازپرداخت» ایجنت n8n به Human review وصل است و سرپرست آن را رد میکند. طبق مستندات n8n چه اتفاقی میافتد؟
- ابزار با پارامترهای دیگری دوباره اجرا میشود.
- اقدام لغو میشود، ابزار اجرا نمیشود و به مدل اطلاع داده میشود که رد شد.
- ورکفلو با خطا متوقف میشود.
- ابزار اجرا میشود ولی نتیجهاش به کاربر نشان داده نمیشود.
پاسخ نمونه و معیار ارزیابی
- a ← رد یعنی لغو؛ اجرای دوباره خودکار نیست.
- c ← ورکفلو ادامه میدهد و مدل از رد مطلع میشود.
- d ← ابزار ردشده اجرا نمیشود.
تیم میخواهد برای سادگی، متن کامل پیشنویس و پیام مشتری را در دفتر ثبت تأیید بگذارد تا «همه چیز یکجا باشد». موازنه را بنویس و طرح پیشنهادیات را بده.
پاسخ نمونه و معیار ارزیابی
یکجا بودن، بازبینی را آسان میکند؛ ولی دفتر ثبت معمولاً دسترسی گستردهتر و نگهداری طولانیتر دارد و داده شخصی مشتری در آن ماندگار میشود، و حذف به درخواست مشتری سختتر است. پیشنهاد: دفتر ثبت فقط شناسه، هش نسخه، نقش، تصمیم، زمان و دلیل رد؛ متن در محل جدا با دسترسی محدود و مدت نگهداری کوتاهتر، که با شناسه پیدا میشود. هش ثابت میکند کدام متن تأیید شد بیآنکه متن در دفتر باشد.
- مزیت یکجا بودن (1 امتیاز)
- ریسک دسترسی و نگهداری داده (1 امتیاز)
- جداسازی متن و نقش هش (1 امتیاز)
- دفتر ثبت امن است ← دفترهای ثبت معمولاً بیشتر از همه جا خوانده و نگه داشته میشوند.
فایلهای درس
دروازه تأیید وابسته به نسخه پیشنویس با دفتر ثبت
approval_gate.pyخروجی نمونه هفت حالت تأیید
sample-run.txtقالب سیاست تأیید برای یک ورکفلو
approval-policy-template.mdابزارها و جایگزینها
- n8n 2.x یا Python 3.9 یا بالاتر — ساخت دروازه تأیید — مسیر بدون اجرا با خروجی نمونه
منابع
Production AI Playbook: Human Oversight n8n (blog) accessed 2026-10-20
Human-in-the-loop for tools n8n accessed 2026-10-20
Building effective agents Anthropic 2024-12-19 (page notes tooling has changed since)