اجراهای عامل هوش مصنوعی
هر بار که یک عامل هوش مصنوعی اجرا می‌شود، چه از گره عامل هوش مصنوعی و چه از طریق API، MonoChat آن اجرا را ثبت می‌کند: از کدام harness و مدل‌ها استفاده شده، چه درخواستی داشته، چه فراخوانی‌های مدل و ابزاری انجام داده، چه مقدار از بودجه‌اش را مصرف کرده و چگونه پایان یافته است.
اجراها را در تنظیمات › اتوماسیون › اجراهای عامل هوش مصنوعی می‌بینید. این گزینه منو برای کاربرانی نمایش داده می‌شود که مجوز مشاهده اجراهای عامل AI در اتوماسیون را دارند.
جدول اجراها
| ستون | نمایش می‌دهد |
|---|---|
| AI Harness | harnessای که عامل را اجرا کرده است. برای دیدن نوع harness، نشانگر ماوس را روی آن نگه دارید. |
| وضعیت | در صف، در حال اجرا، تکمیل‌شده، ناموفق، بودجه تمام شد، مهلت زمانی تمام شد یا لغوشده. برای دیدن خطای یک اجرای ناموفق، نشانگر ماوس را روی آن نگه دارید. |
| فراخوانی‌های مدل | فراخوانی‌های مدل مصرف‌شده / حداکثر فراخوانی مدل از بودجه. |
| فراخوانی‌های ابزار | فراخوانی‌های ابزار مصرف‌شده / حداکثر فراخوانی ابزار از بودجه. |
| توکن‌ها | مجموع توکن‌ها. با نگه داشتن نشانگر ماوس، توکن‌های ورودی و خروجی و در صورت گزارش ارائه‌دهنده، خواندن و نوشتن کش نمایش داده می‌شود. |
| مدت | مدت زمانی که اجرا طول کشیده است. |
| تاریخ ایجاد | زمان شروع اجرا. |
هر ردیف سه دکمه دارد:
- کپی ID شناسه اجرا را کپی می‌کند، مثلاً برای جست‌وجوی آن با
aiAgentRuns.showیا ارسال برای پشتیبانی. - گفتگو گفتگویی را که اجرا در آن کار کرده است باز می‌کند. این دکمه فقط برای اجراهایی نمایش داده می‌شود که به یک session تعلق دارند.
- نمایش جزئیات اجرا را باز می‌کند.
با فیلترها می‌توانید فهرست را بر اساس هارنس‌های AI، وضعیت و تاریخ ایجاد (بازه تاریخ) محدود کنید. جدول خودکار به‌روز نمی‌شود؛ برای بارگذاری اجراهای جدید و تغییر وضعیت‌ها از دکمه تازه‌سازی در سربرگ جدول استفاده کنید.
جزئیات اجرا
نمایش پنل اجرای عامل هوش مصنوعی را باز می‌کند.
خلاصه
| ردیف | نمایش می‌دهد |
|---|---|
| ID | شناسه اجرا، همراه با دکمه کپی. |
| AI Harness | نام و نوع harness. |
| وضعیت | اجرا چگونه پایان یافته است، یا اینکه هنوز در صف یا در حال اجراست. |
| خطا | پیام خطا برای اجراهایی که تکمیل نشده‌اند. |
| مدل اصلی، مدل جایگزین (پس از رسیدن به حد نرم)، مدل سریع (وظایف سبک پس‌زمینه) | مدل‌های AI که گره تنظیم کرده است، برای harnessهایی که از مدل‌های AI استفاده می‌کنند. |
| مدل (یکی از مدل‌های مجاز Harness) | مدل، برای harness میزبانی‌شده. |
| تاریخ ایجاد، تاریخ شروع، زمان پایان | زمان قرارگرفتن اجرا در صف، شروع و پایان آن. |
| مدت | زمان مصرف‌شده / حداکثر مدت (ثانیه). |
| فراخوانی‌های مدل | فراخوانی‌های مصرف‌شده / حداکثر، به‌همراه حد نرم در صورت تنظیم. |
| فراخوانی‌های ابزار | فراخوانی‌های مصرف‌شده / حداکثر. |
| توکن‌ها | توکن‌های ورودی و خروجی (و توکن‌های کش)، و مجموع / حداکثر کل توکن‌ها. |
مراحل
مراحل کارهایی را که عامل انجام داده به‌ترتیب فهرست می‌کند و در سمت راست، زمان سپری‌شده از شروع اجرا را نشان می‌دهد:
| مرحله | نمایش می‌دهد |
|---|---|
| فراخوانی مدل n | مدل، توکن‌های ورودی و خروجی، و یا ابزارهایی که مدل درخواست کرده است (ابزارهای درخواست‌شده: …) یا پاسخ نهایی. |
| فراخوانی ابزار | نام ابزار و مدت زمانی که طول کشیده است. |
| تغییر به مدل جایگزین | اجرا به حد نرم رسیده و با مدل جایگزین ادامه یافته است. |
| پیام میانی | پیامی که عامل هنگام کار نوشته است، به همان شکل که برای مشتری ارسال شده یا به‌صورت whisper اضافه شده است. |
| تلاش مجدد | فراخوانی مدل ناموفقی که دوباره تلاش شده است، همراه با خطای آن. |
اگر harness هیچ مرحله‌ای گزارش نکند، در پنل نوشته می‌شود «برای این اجرا مرحله‌ای ثبت نشده است.»
دستورالعمل‌ها، ورودی، نتیجه و داده‌های JSON
- دستورالعمل‌ها: دستورالعمل‌های گره، همان‌طور که عامل دریافت کرده است.
- ورودی: وظیفه، با برچسب‌هایی که از قبل مقداردهی شده‌اند.
- نتیجه: پاسخ نهایی عامل.
- داده‌های JSON: کل رکورد اجرا. با دکمه کپی آن را برای توسعه‌دهنده خود یا پشتیبانی MonoChat ارسال کنید.
اشکال‌زدایی یک عامل
| آنچه می‌بینید | چه چیزی را بررسی کنید |
|---|---|
| بودجه تمام شد در حالی که فراخوانی‌های مدل به حداکثر رسیده است | مراحل را ببینید. اگر عامل مدام ابزار فراخوانی می‌کند و به نتیجه نمی‌رسد، دستورالعمل‌ها و توضیحات ابزارها را دقیق‌تر کنید. اگر کار واقعاً به مراحل بیشتری نیاز دارد، حداکثر فراخوانی مدل را افزایش دهید. |
| بودجه تمام شد در حالی که توکن‌ها به حداکثر رسیده است | تاریخچه طولانی گفتگو یا نتایج بزرگ ابزارها بودجه توکن را پر می‌کنند. محدودیت تاریخچه پیام را کاهش دهید، داده کمتری از ابزارهای خود برگردانید یا حداکثر کل توکن‌ها را افزایش دهید. |
| بودجه تمام شد در حالی که فراخوانی‌های ابزار به حداکثر رسیده است | عامل بیش از حد مجاز ابزار درخواست کرده است. حداکثر فراخوانی ابزار را افزایش دهید یا در دستورالعمل‌ها به آن بگویید چه زمانی از کدام ابزار استفاده کند. |
| مهلت زمانی تمام شد | مدت فراخوانی ابزارها را در مراحل بررسی کنید. یک API یا سرور MCP کند، حداکثر مدت (ثانیه) را مصرف می‌کند. |
| ناموفق با پیام «An AI scope or MCP tool was not found in this workspace.» | یک scope یا ابزار MCP روی گره حذف شده است. تنظیمات ابزار گره را به‌روزرسانی کنید. |
| ناموفق با پیام «Choose one of the AI harness's allowed models.» | مدل گره از مدل‌های مجاز harness میزبانی‌شده حذف شده است. |
| ناموفق با پیام «This harness is not available on this server.» | harness به agent runner مربوط به MonoChat نیاز دارد که در دسترس نیست. harness دیگری انتخاب کنید. |
| مشتری پاسخ را دریافت نکرده است | بررسی کنید که اجرا تکمیل‌شده باشد، گزینه ارسال پاسخ در گره روشن باشد و نتیجه خالی نباشد. |
| مشتری پیام‌های «در حال فکر کردن» دیده که نمی‌خواستید | ارسال پیام‌های میانی به مشتری را خاموش کنید؛ در این صورت پیام‌ها فقط به‌صورت whisper برای تیم شما باقی می‌مانند. |
پیش از تغییر بودجه یک گره، چند اجرای آن را با هم مقایسه کنید. مراحل نشان می‌دهند عامل به فضای بیشتر نیاز دارد یا به دستورالعمل‌های بهتر.