انتخاب مدل

چطور مدلی که AiraCode استفاده می‌کنه رو کنترل کنی — alias، env، یا انتخاب مدل خام.

AiraCode به‌جای اینکه مستقیم به Anthropic وصل بشه، درخواست‌ها رو از طریق Gateway آیراکد به موتور inference می‌فرسته (مستندات کامل: Gateway آیراکد). این یعنی هر مدلی که در کاتالوگ هست، در صورت قرار گرفتن در allowlist، در دسترسته.

Alias‌های دوستانه

به‌جای حفظ کردن نام دقیق مدل، از یکی از این alias‌ها استفاده کن:

Aliasمدل پایهبرای چی
aira-fastopenai/gpt-oss-20bعنوان جلسه، intent، کارهای کوتاه
aira-cheapgoogle/gemini-2.5-flash-liteارزون‌ترین، برای تست‌های سریع
aira-balanceddeepseek/deepseek-v4-flashپیش‌فرض، تعادل کیفیت/هزینه
aira-proopenai/gpt-oss-120brefactor، طراحی، reasoning عمیق
aira-maxqwen/qwen3-235b-a22b-2507سنگین‌ترین، بهترین کیفیت
aira-sonnetanthropic/claude-sonnet-4-6Claude Sonnet مستقیم (گرون‌تر)
aira-opusanthropic/claude-opus-4-6Claude Opus، reasoning ممتاز
aira-haikuanthropic/claude-haiku-4-5Claude Haiku، سریع و ارزون

روش‌های تنظیم

یک نشست

aira --model aira-pro
aira --model aira-pro -p "یک پلن برای migration پایگاه‌داده بنویس"

پیش‌فرض دائمی (env)

# توی ~/.zshrc یا ~/.bashrc:
export AIRA_MODEL_DEFAULT=aira-balanced

# یا برای یه پروژه با direnv:
echo "export AIRA_MODEL_DEFAULT=aira-pro" >> .envrc

مدل خام

اگه می‌خوای مدلی استفاده کنی که alias نداره، اسم کامل مدل (با prefix provider) رو پاس بده:

aira --model deepseek/deepseek-v3
aira --model meta-llama/llama-3.3-70b-instruct
aira --model mistralai/mistral-large-2411

مدل باید توی allowlist Gateway باشه. لیست کامل از این endpoint بخون:

curl -H "Authorization: Bearer $TOKEN" \
     https://app.airachat.ir/api/airacode/gateway/v1/models

مدل بر اساس task

فراتر از یک مدل پیش‌فرض، می‌تونی برای هر نوع کار (task_type) یه مدل متفاوت مشخص کنی. اینجا «نوع کار» چیزایی مثل تولید عنوان جلسه، تشخیص intent برای recall، یا خلاصه‌سازی Web fetch است.

# عنوان جلسه با مدل خیلی ارزون
export AIRA_MODEL_TITLE_GENERATION=openai/gpt-oss-20b

# تشخیص intent با Gemini
export AIRA_MODEL_INTENT_DETECTION=google/gemini-2.5-flash-lite

# Compaction context با Haiku
export AIRA_MODEL_MEMORY_COMPACTION=anthropic/claude-haiku-4-5

# task پیش‌فرض اگه نسخهٔ خاصی تعریف نشده
export AIRA_MODEL_SMALL_FAST=deepseek/deepseek-v4-flash

دور زدن Gateway

اگه خواستی AiraCode مستقیم بره به Anthropic یا یه gateway دیگه:

# مستقیم به Anthropic (نیاز به VPN از ایران)
export ANTHROPIC_BASE_URL=https://api.anthropic.com
export ANTHROPIC_API_KEY=sk-ant-...

# یا یه gateway دیگه که شما کنترلش می‌کنی
export AIRA_GATEWAY_BASE_URL=https://my-proxy.example.com/v1

برای ops

  • افزودن مدل بدون deploy: روی سرور AIRACODE_GW_EXTRA_MODELS=foo/bar,baz/qux
  • دور زدن allowlist برای dev: AIRACODE_GW_ALLOW_ALL=1
  • تغییر upstream به مقصد دیگه: AIRACODE_GW_UPSTREAM_BASE=https://...