# مرور کلی سیستم ToolRate

## ToolRate چیست؟

ToolRate یک **لایه اطمینان‌پذیری مبتنی بر جمع‌سپاری** برای عاملان مستقل هوش مصنوعی است — یک اوراکل اطمینان‌پذیری در زمان واقعی که به عاملان امکان می‌دهد *پیش از* فراخوانی یک ابزار یا API خارجی، میزان قابل‌اعتماد بودن آن را ارزیابی کنند.

این سیستم یکی از مهم‌ترین مشکلات عملی در توسعه عاملان را حل می‌کند: بیشتر شکست‌ها ناشی از خود LLM نیست، بلکه از رفتار غیرقابل‌پیش‌بینی ابزارها و APIهای خارجی — محدودیت‌های نرخ، انحراف طرحواره، مشکلات احراز هویت، محافظت‌های ضدربات و حالات مرزی — ناشی می‌شود.

---

## ToolRate برای چه کسانی است؟

- توسعه‌دهندگانی که عاملان هوش مصنوعی **در سطح تولید** می‌سازند
- تیم‌ها و توسعه‌دهندگان مستقل که با **LangChain، CrewAI، LangGraph، AutoGen** یا **LlamaIndex** کار می‌کنند
- توسعه‌دهندگان اروپایی که به **GDPR و محل ذخیره‌سازی داده** اهمیت می‌دهند
- هر کسی که از عاملانی که در نمایش‌ها خوب کار می‌کنند اما در سناریوهای واقعی مکرراً شکست می‌خورند، خسته شده است

---

## نحوه عملکرد ToolRate

این سیستم به‌عمد ساده و سبک طراحی شده است:

**۱. بررسی پیش از فراخوانی**

پیش از فراخوانی هر ابزار یا API خارجی، عامل از ToolRate استعلام می‌کند:

```python
assessment = toolrate.guard(tool_identifier=..., context=...)
```

**۲. پاسخ ساختاریافته**

ToolRate بلافاصله یک بار داده JSON حاوی موارد زیر برمی‌گرداند:

| فیلد | توضیح |
|---|---|
| `reliability_score` | امتیاز از ۰ تا ۱۰۰ |
| `success_rate` | نرخ تاریخی بر اساس فراخوانی‌های واقعی عاملان |
| `pitfalls` | حالات رایج شکست + راهکارهای پیشنهادی |
| `alternatives` | بهترین جایگزین‌ها به ترتیب عملکرد |
| `jurisdiction` | ریسک GDPR و اطلاعات محل ذخیره‌سازی داده |
| `latency` | تأخیر پاسخ تخمینی |

**۳. تصمیم هوشمند**

عامل می‌تواند سپس:

- با ابزار طبق برنامه ادامه دهد
- به‌طور خودکار به جایگزین بهتر سوئیچ کند
- تصمیم را به کاربر نشان دهد

**۴. حلقه بازخورد اختیاری**

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

---

## پتانسیل جهانی صرفه‌جویی در انرژی

اگر همه عاملان هوش مصنوعی و چت‌بات‌های جهان ToolRate را به‌کار می‌گرفتند، تأثیر آن بر انرژی چشمگیر می‌بود.

با فرض اینکه ظرف یک سال تعداد عاملان فعال هوش مصنوعی از تعداد انسان‌ها روی زمین بیشتر شود (بیش از ۸ میلیارد عامل)، و ToolRate بتواند فراخوانی‌های ابزار ناموفق یا هدررفته را **۶۰ تا ۷۵٪** کاهش دهد، پذیرش گسترده می‌تواند روزانه میلیاردها استنتاج غیرضروری LLM و حلقه‌های تلاش مجدد را جلوگیری کند.

> **تخمین محافظه‌کارانه:** ToolRate می‌تواند سالانه بین **۸ تا ۱۵ TWh برق** برای اکوسیستم جهانی هوش مصنوعی صرفه‌جویی کند — معادل تقریبی مصرف سالانه **۱.۵ تا ۲.۵ میلیون خانوار متوسط آمریکایی**.

صرفه‌جویی‌ها عمدتاً از موارد زیر ناشی می‌شوند:

- فراخوانی‌های API ناموفق کمتر
- کاهش اتلاف توکن
- مسیریابی هوشمندتر به ابزارهای قابل اعتماد

---

## مقایسه با سایر ابزارها

| ابزار | نوع | از شکست جلوگیری می‌کند؟ | داده جمع‌سپاری‌شده | جایگزین ارائه می‌دهد | GDPR / حوزه قضایی | تمرکز اصلی |
|---|---|:---:|:---:|:---:|:---:|---|
| **ToolRate** | اوراکل اطمینان‌پذیری پیش از فراخوانی | ✅ | ✅ | ✅ | ✅ قوی | عاملان تولیدی |
| LangSmith | قابلیت مشاهده + ردیابی | ❌ | ❌ | ❌ | ⚠️ محدود | اکوسیستم LangChain |
| Langfuse | قابلیت مشاهده متن‌باز | ❌ | ❌ | ❌ | ⚠️ محدود | ردیابی متن‌باز |
| Braintrust | ارزیابی‌ها + ردیابی | ⚠️ جزئی | ❌ | ❌ | ⚠️ محدود | تیم‌های ارزیابی‌محور |
| Helicone | قابلیت مشاهده LLM + ابزار | ❌ | ❌ | ❌ | ⚠️ محدود | پایش هزینه و تأخیر |
| AgentOps | پایش عاملان | ❌ | ❌ | ❌ | ⚠️ محدود | تحلیل رفتار عامل |

> ToolRate در حال حاضر **تنها راه‌حلی** است که به‌صورت پیشگیرانه با استفاده از تجربه واقعی عاملان جمع‌سپاری‌شده کار می‌کند.

---

## دسترس‌پذیری

| کانال | جزئیات |
|---|---|
| وب‌سایت | [toolrate.ai](https://toolrate.ai) |
| API | [api.toolrate.ai](https://api.toolrate.ai) |
| Python SDK | `uv add toolrate` (recommended)<br>`pip install toolrate` (alternative) |
| TypeScript SDK | `npm install toolrate` |
| مجوز | Business Source License 1.1 (BUSL-1.1) |

---

*آخرین به‌روزرسانی: آوریل ۲۰۲۶*