# رفع خودکار با هوش مصنوعی

> https://docs.errora.org/products/ai-autofix

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

## پیش‌نیازها

1. یک **یکپارچه‌سازی کنترل نسخه** متصل و یک **مخزن پیوندخورده به پروژه** — نگاه کنید به
   [یکپارچه‌سازی‌ها](/products/integrations). بدون آن نه کدی برای خواندن هست و نه جایی برای
   باز کردن MR.
2. یک **پیکربندی هوش مصنوعی** برای سازمان (یا برای یک پروژهٔ خاص).

## تنظیم ارائه‌دهنده

**تنظیمات ← هوش مصنوعی**، یا از راه API:

```bash
curl -X POST "$ERRORA/api/v1/organizations/$ORG_ID/ai-configs" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Default fixer",
        "provider": "claude",
        "model": "claude-opus-4-8",
        "api_key": "sk-…",
        "base_url": "",
        "project": null,
        "auto_trigger": false,
        "enabled": true
      }'
```

| فیلد | توضیح |
| --- | --- |
| `provider` | `openai` (هر نقطهٔ سازگار با OpenAI)، `claude` (Claude Agent SDK)، `cursor` (Cursor Agents SDK) |
| `model` | شناسهٔ مدل، مختص همان ارائه‌دهنده |
| `api_key` | رمزگذاری‌شده ذخیره می‌شود؛ API هرگز آن را کامل برنمی‌گرداند |
| `base_url` | برای درگاه‌های سازگار با OpenAI و نقاط اختصاصی |
| `project` | `null` یعنی برای کل سازمان؛ با تعیین آن، پیکربندی به یک پروژه محدود می‌شود |
| `auto_trigger` | اجرای خودکار هنگام ساخته‌شدن خطای جدید |
| `enabled` | خاموش‌کردن پیکربندی بدون حذف آن |

پیکربندی مخصوص پروژه بر پیکربندی کل سازمان اولویت دارد.

## اجرای یک رفع

از **صفحهٔ خطا**، دکمهٔ **رفع خودکار** را بزنید. یا:

```bash
curl -X POST "$ERRORA/api/v1/projects/$PROJECT_ID/issues/$ISSUE_ID/autofix" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

اجرا به توانمندی **`ai:trigger`** نیاز دارد (به‌طور پیش‌فرض owner، admin و member).

## چه اتفاقی می‌افتد

1. ارورا **زمینه** را جمع می‌کند: استثنا، فریم‌های ردپا و فایل‌های منبعی که آن فریم‌ها به آن‌ها
   اشاره دارند، از مخزن پیوندخورده.
2. از ارائه‌دهنده **وصله به‌همراه توضیح** خواسته می‌شود.
3. ارورا یک شاخه می‌سازد (`errora/autofix-<issue>-<timestamp>`)، تفاوت‌ها را کامیت می‌کند و یک
   **مرج‌ریکوئست** باز می‌کند.
4. اجرا با وضعیت، دیف، توضیح، آدرس MR، مدل و مصرف توکن ثبت می‌شود.

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

هر مرحله یک رویداد هشدار فعال می‌کند که می‌توانید به یک کانال بفرستید: `autofix.started`،
`autofix.mr_created`، `autofix.failed` — نگاه کنید به [هشدارها](/products/alerts).

## هزینه

هر اجرا زیر سرویس **رفع هوش مصنوعی** محاسبه می‌شود (به‌طور پیش‌فرض ۲۰٬۰۰۰ تومان به ازای هر
اجرا)، جدا از هزینه‌ای که ارائه‌دهندهٔ هوش مصنوعی از شما می‌گیرد. نگاه کنید به
[کیف پول](/billing/wallet).

## بازبینی وصله

با آن مثل پیش‌نویس همکاری رفتار کنید که فقط ردپای خطا را خوانده و چیز دیگری نمی‌داند:

- فریم‌ها و فایل‌هایی را که به آن‌ها اشاره دارند می‌بیند — نه تست‌های شما، نه تصمیم‌های محصول،
  نه تیکت مربوطه.
- تست‌ها را اجرا کنید. دیف را بخوانید. آن MR نقطهٔ شروع است، نه حرف آخر.

## عیب‌یابی

| نشانه | علت / راه‌حل |
| --- | --- |
| دکمه غیرفعال است یا `403` می‌گیرید | نقش شما توانمندی `ai:trigger` ندارد |
| پیام «مخزنی وصل نیست» | در [یکپارچه‌سازی‌ها](/products/integrations) مخزنی به پروژه وصل کنید |
| اجرا بی‌درنگ شکست می‌خورد | کلید API یا شناسهٔ مدل اشتباه است، یا `base_url` برای ارورا قابل دسترسی نیست |
| MR ساخته نمی‌شود | توکن یکپارچه‌سازی روی مخزن دسترسی نوشتن ندارد |
| وصله بی‌ربط به نظر می‌رسد | فریم‌ها به کد کتابخانه‌ها اشاره داشته‌اند — مخزن درست را وصل کنید و مطمئن شوید سورس‌مپ/نسخه فریم‌ها را به فایل‌های خودتان می‌رساند |