thedixitjain استقرار عاملهای مقیاسپذیر با Microsoft Foundry
مهارت همراه برای درس 16 – استقرار عاملهای مقیاسپذیر. از آن برای کمک به یادگیرنده استفاده کنید تا یک عامل را از نمونه اولیه به استقرار تولیدی قابل مقیاس و قابل مشاهده منتقل کند. هر توصیه را بر اساس محتوای درس و دفترچه اجرایی انجامدادنی پایهگذاری کنید؛ از ساختن APIهای Foundry خودداری کنید.
ماشهها
زمانی که یک یادگیرنده میخواهد:
- یک عامل را به Microsoft Foundry به عنوان عامل میزبانیشده مستقر کند و آن را نسخهبندی شده/قابل مشاهده نماید.
- بین الگوهای استقرار میزبانی شده توسط مشتری، عامل میزبانی شده، و جریانکاری عامل انتخاب کند.
- مسیر یابی مدل، کش پاسخها، یا همزمانی محدود را برای کنترل تأخیر و هزینه اضافه کند.
- یک دروازه ارزیابی اضافه کند تا نسخه بد عامل ارسال نشود.
- یک مرحله تأیید انسان در حلقه برای عملیات با ریسک بالا اضافه کند.
- عامل را با ردیابی OpenTelemetry برای قابل مشاهده بودن در تولید مجهز کند.
- بعد از استقرار، عامل را بهسرعت با آزمون دود بررسی کند.
مدل ذهنی اصلی
یک عامل تولیدی بیشتر اسکلت عملیاتی دور مدل است (~۸۰٪)، نه خود مدل. هر توصیه را به یکی از این نگرانیها نسبت دهید:
| نگرانی | نمونه اولیه → تولید |
|---|---|
| میزبانی | دفترچه → سرویس میزبانی شده نسخهبندی شده |
| هویت | ورود شما با az login → هویت مدیریتی + RBAC محدود شده |
| حالت | در حافظه → ذخیره موضوعی/حافظه خارجی |
| خطا | ردیابی خطا → تلاشهای مجدد، بازگشت، هشدارها |
| هزینه | "چند سنت" → رصد شده، مسیردهی شده، کش شده، بودجهبندی شده |
| کیفیت | ارزیابی بصری → دروازه ارزیابی خودکار |
| اعتماد | تأیید شما → سیاست + انسان در حلقه |
الگوهای استقرار (یکی را انتخاب کنید یا ترکیب کنید)
- میزبانی شده توسط مشتری — حلقه استدلال در فرآیند شما اجرا میشود. کنترل حداکثری؛ شما مالک مقیاسبندی/حالت هستید.
- عامل میزبانی شده (خدمت عامل Foundry) — Foundry حلقه را میزبانی میکند، موضوعها را ذخیره میکند، RBAC/امنیت محتوا را اعمال میکند، عامل را در پرتال نشان میدهد. کنترل کمتر، سطح عملیاتی بسیار کمتر.
- جریانکاری عامل — چندین عامل/ابزار ترکیب شده به یک گراف با شاخهها، گرههای تأیید، و نقاط بازبینی پایدار.
چرخه عمر (حلقهای که یک عامل را ارسال میکند)
ایجاد → نسخهبندی → ارزیابی (دروازه) → استقرار میزبانی شده → مشاهده آنلاین → جمعآوری خطاها → تکرار.
ارزیابی آفلاین یک دروازه است، نه فکر بعدی — نسخه ارسال نمیشود
مگر اینکه آستانه را رد کند. مشاهده آنلاین خطاهای واقعی را به مجموعه تست آفلاین بازمیگرداند.
اهرمهای مقیاس و هزینه (به ترتیب اولویت)
- اندازه مدل را مناسب انتخاب کنید — کوچکترین مدلی را که از دروازه ارزیابی عبور میکند، انتخاب کنید.
- مسیر یابی بر اساس پیچیدگی — مدل کوچک/سریع برای درخواستهای ساده، مدل بزرگ برای استدلال واقعی (ردهبند DIY یا Foundry Model Router).
- کش — درخواستهای تقریباً تکراری را بدون فراخوانی مدل پاسخ دهید.
- طراحی بدون حالت + همزمانی محدود — حالت را خارجی کنید؛ با برگشتهای افزایشی تلاش کنید.
الگوهای کلیدی برای بازتولید
یادگیرنده را به اینها از دفترچه راهنمای
16-python-agent-framework.ipynb ارجاع دهید:
- مدیر درخواست: کش → مسیر یابی بر اساس پیچیدگی → ردیابی بازه → اجرا → کش.
- دروازه ارزیابی: نمره دادن یک مجموعه تست آفلاین؛
pass_rate >= thresholdبازگرداند و تنها در صورت درست بودن مستقر شود. - تأیید انسانی:
@tool(approval_mode="always_require")برای عملیاتی مانند بازپرداختهای بزرگ. - ردیابی: هر درخواست را در
tracer.start_as_current_span(...)بپیچید و خصوصیات مثلrouted.model،customer.idرا تنظیم کنید.
آزمایش دود یک عامل مستقر شده
بعد از استقرار، تأیید کنید که نقطه انتهایی واقعاً پاسخ میدهد (یک استقرار سبز هنوز ممکن است
بیصدا باشد). از AI Smoke Test
از طریق .github/workflows/smoke-test.yml
با کاتالوگ در tests/ استفاده کنید. اجراکننده هر
فراخوان را به POST {project_endpoint}/agents/{agent_name}/endpoint/protocols/openai/responses ارسال میکند
و روی متن پاسخ تأیید میکند. هویت باید نقش کاربر AI Azure را در
دامنه پروژه Foundry داشته باشد؛ مخاطب توکن باید https://ai.azure.com/ باشد.
لایههای دروازهها: آزمون دود (دسترسپذیر/پاسخگو، هر بار استقرار) → ارزیابی آفلاین (به اندازه کافی خوب برای ارسال، قبل از ترفیع) → ارزیابی آنلاین (عملکرد واقعی در محیط، مستمر).
کنترلهای سازمانی
- RBAC: به هر عامل میزبانی شده یک هویت مدیریتی با حداقل امتیاز بدهید.
- MCP در تولید: هر سرور MCP را به عنوان یک مرز غیرقابل اطمینان رفتار کنید — نسخه را پین کنید، هویت آن را محدود کنید، خروجیها را اعتبارسنجی کنید، محدودیت نرخ اعمال کنید، هرگز اسرار را در معرض قرار ندهید.
حفاظها برای دستیار
- الگوی استاندارد
FoundryChatClient(...)+provider.as_agent(...)را که در کل دوره استفاده شده ترجیح دهید. - وعده نتایج Azure زندهای که تأیید نکردهاید ندهید؛ روند آزمون دود را برای تأیید استقرار توصیه کنید.
- نصیحتهای ارزیابی و هزینه را به هم وابسته نگه دارید: ارزیابی کف کیفیت را تعیین میکند، مسیر یابی/کش هزینه را نزدیک به آن کف نگه میدارد.
سلب مسئولیت: این سند با استفاده از سرویس ترجمه هوش مصنوعی Co-op Translator ترجمه شده است. در حالی که ما در تلاش برای دقت هستیم، لطفاً توجه داشته باشید که ترجمههای خودکار ممکن است شامل خطاها یا نادرستیهایی باشند. سند اصلی به زبان مادری خود باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حیاتی، ترجمه حرفهای انسانی توصیه میشود. ما در قبال هرگونه سوء تفاهم یا برداشت نادرست ناشی از استفاده از این ترجمه مسئولیتی نداریم.
Source: microsoft/ai-agents-for-beginners → translations/fa/.agents/skills/deploying-scalable-agents/SKILL.md