# محیط آزمایشی عامل

URL: https://discuvr.org/agent-playground/?hl=fa
Last updated: 2026-11-07

عامل‌های هوش مصنوعی که از ابزار استفاده می‌کنند - جستجوی وب، ماشین‌حساب، دریافت URL - را روی چند ارائه‌دهنده اجرا کنید و هر مرحله از حلقه را هنگام وقوع ببینید.

Agent Playground یک کار را همزمان با حداکثر هشت عامل ابزارمحور اجرا می‌کند و هر مرحله را نشان می‌دهد: هر فراخوانی ابزار، آرگومان‌هایش و آنچه برگشت. بیشتر خطاهای یک عامل در حلقه است نه در مدل، پس خطا چیزی می‌شود که می‌بینید، نه چیزی که حدس می‌زنید.

## عملکرد

- سه ابزار که برای هر عامل روشن می‌کنید: جستجوی وب (پنج نتیجه اول DuckDuckGo)، ماشین‌حساب و دریافت URL.
- نه گزینه ارائه‌دهنده: OpenAI, Anthropic, Google Gemini, Groq, Mistral, DeepSeek, OpenRouter, xAI و هر endpoint سازگار با OpenAI.
- هر فراخوانی ابزار و نتیجه‌اش به ترتیب نشان داده می‌شود، همراه با تعداد مراحل و توکن‌های هر عامل.
- پیام‌های بعدی ۱۰ پیام آخر گفتگوی هر عامل را با خود می‌برند.

## چرا ردگیری مهم است

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

## هر ابزار چه می‌تواند و چه نمی‌تواند

جستجوی وب عنوان، پیوند و خلاصه پنج نتیجه اول را برمی‌گرداند، نه کل صفحه را. دریافت URL تا ۵۱۲ کیلوبایت از یک صفحه عمومی http یا https را می‌خواند، HTML را حذف می‌کند و ۴٬۰۰۰ نویسه اول متن را به مدل می‌دهد؛ نشانی‌های خصوصی، loopback و دیگر نشانی‌های داخلی رد می‌شوند. ماشین‌حساب حساب و توابع ریاضی مانند sqrt و log را تا ۵۰۰ نویسه انجام می‌دهد و توان‌های بسیار بزرگ را رد می‌کند. هیچ ابزاری کد اجرا نمی‌کند.

## محدودیت‌ها و مقصد کلیدهای شما

هر عامل پس از ۸ مرحله متوقف می‌شود. حداکثر ۸ عامل در هر اجرا، کار و پیام سیستمی هر کدام تا ۲۰٬۰۰۰ نویسه، ورود الزامی و ۳۰ اجرا در هر ۱۰ دقیقه برای هر نشانی IP. کلیدها از همان صفحه کلیدهای AI Playground می‌آیند: در حافظه محلی مرورگر شما می‌مانند، با هر اجرا فرستاده می‌شوند و روی سرور ذخیره نمی‌شوند.

## در یک گام چه اتفاقی می‌افتد، به تفکیک ارائه‌دهنده

هر گام یک فراخوانی مدل است. عامل گفت‌وگو و تعریف ابزارهایی را که روشن کرده‌اید می‌فرستد؛ اگر پاسخ ابزار بخواهد، هر فراخوانی درخواستی به ترتیب اجرا می‌شود، نتیجه‌ها به گفت‌وگو افزوده می‌شوند و گام بعدی آغاز می‌شود. پاسخی که فراخوانی ابزار ندارد پاسخ نهایی است. قالب در هر ارائه‌دهنده فرق دارد: APIهای سازگار با OpenAI (OpenAI، Groq، Mistral، DeepSeek، OpenRouter، xAI و Custom) tool_calls برمی‌گردانند و هر نتیجه را در پیام tool دریافت می‌کنند، Anthropic بلوک‌های tool_use برمی‌گرداند و بلوک‌های tool_result می‌گیرد، و Gemini بخش‌های functionCall برمی‌گرداند و بخش‌های functionResponse می‌گیرد. ردگیری، همان فراخوانی و همان نتیجه را در هر قالبی نشان می‌دهد.

## سوالات

**عامل از چه ابزارهایی می‌تواند استفاده کند؟**

جستجوی وب، ماشین‌حساب و دریافت URL. همه ارائه‌دهنده‌ها همین سه را دارند و شما انتخاب می‌کنید هر عامل کدام را فراخوانی کند.

**آیا به کلیدهای API خودم نیاز دارم؟**

بله، یکی برای هر ارائه‌دهنده‌ای که اجرا می‌کنید، و مستقیما به همان ارائه‌دهنده پرداخت می‌کنید. کلیدها در مرورگر شما می‌مانند، با هر اجرا فرستاده می‌شوند و روی سرور ذخیره نمی‌شوند.

**وقتی مراحل یک عامل تمام شود چه می‌شود؟**

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

**چرا شمار توکن‌های ورودی در هر گام بیشتر می‌شود؟**

هر گام کل گفت‌وگو را، همراه با همه نتیجه‌های قبلی ابزارها، دوباره می‌فرستد؛ پس اجرایی پنج‌گامی کار شما را پنج بار می‌فرستد و یک نتیجه جست‌وجوی اولیه را در هر گام بعدی. اعداد توکن روی هر کارت جمع همه گام‌هاست، همان‌طور که ارائه‌دهنده گزارش می‌دهد.

**آیا پیام بعدی جست‌وجوهای قبلی را به خاطر دارد؟**

فقط به صورت متن. پیام بعدی ۱۰ پیام آخر گفت‌وگوی آن عامل را با خود می‌برد، یعنی کارهای قبلی شما و پاسخ‌های نهایی عامل، نه فراخوانی‌های ابزار یا نتیجه‌هایشان. اگر پاسخ دوباره به منبع نیاز دارد، از عامل بخواهید دوباره جست‌وجو کند یا صفحه را دوباره بخواند.

**آیا می‌توانم یک مدل محلی مثل Ollama یا LM Studio را وصل کنم؟**

فقط اگر از اینترنت در دسترس باشد. گزینه Custom (سازگار با OpenAI) را انتخاب کنید و نشانی کامل chat completions را وارد کنید، برای نمونه https://your-host/v1/chat/completions. درخواست از سرور Discuvr فرستاده می‌شود، نه از مرورگر شما، و هر نشانی‌ای که به localhost، یک شبکه خصوصی یا محدوده رزرو‌شده دیگری برسد رد می‌شود؛ پس http://localhost:11434 (Ollama) یا http://localhost:1234 (LM Studio) کار نمی‌کند. سرور را پشت یک نشانی HTTPS عمومی که در اختیار خودتان است بگذارید و در صفحه کلیدها برای Custom یک کلید ذخیره کنید، حتی اگر سرورتان آن را نادیده بگیرد، چون اجرای بدون کلید با خطا متوقف می‌شود. برای یک عامل، مدل محلی‌ای هم انتخاب کنید که از فراخوانی ابزار پشتیبانی کند.

---

Part of Discuvr (https://discuvr.org/): Discuvr is a collection of free, focused tools for day-to-day professional work - office and data utilities, legal and compliance helpers, privacy and security checks, and developer formatters. Every tool has its own page, and most can also be called from ChatGPT or Claude over MCP.