اکوان
مستندات اکوان
مستندات/شروع کار

انتخاب provider و مدل

در اکوان می‌توانید از چندین provider برای ایجنت استفاده کنید؛ provider، احراز هویت و مدل را تنظیم کنید.

Akvan یک رابط مشترک برای چند provider دارد. نام provider باید یکی از شناسه‌های پشتیبانی‌شده باشد و model ID باید با همان provider سازگار باشد.

تنظیم تعاملی

ساده‌ترین راه، اجرای تنظیم‌کنندهٔ مدل است:

bash
akvan model

در مراحل راه‌اندازی، provider، روش احراز هویت و مدل را انتخاب می‌کنید. akvan model تنظیمات را در ~/.akvan/.env ذخیره می‌کند. هنگام اجرای session، Akvan ابتدا environment و ~/.akvan/.env را می‌خواند و سپس .env داخل project_root می‌تواند مقدارها را override کند.

providerهای پشتیبانی‌شده

Provider IDAuthenticationGuide
akvanOTP login → AKVAN_API_KEYAkvan
openrouterOPENROUTER_API_KEYOpenRouter
openai-codexcodex login or OPENAI_API_KEYOpenAI Codex
deepseekDEEPSEEK_API_KEYDeepSeek

تغییر موقت مدل

برای استفادهٔ موقت از یک مدل دیگر، session جدیدی با آن مدل بسازید:

bash
akvan --model MODEL_ID

اجرای akvan --model MODEL_ID یک session جدید با مدل موقت مشخص‌شده ایجاد می‌کند. این دستور مقدار AKVAN_MODEL را در environment یا ~/.akvan/.env تغییر نمی‌دهد.

نمونه‌ها:

bash
akvan --model anthropic/claude-sonnet-4     # OpenRouter
akvan --model gpt-5.5                       # OpenAI Codex

اگر provider فعال با model ID سازگار نباشد، درخواست با خطای provider شکست می‌خورد.

بررسی خطا

اگر اتصال برقرار نشد:

  1. دوباره akvan model را اجرا کنید.
  2. از وجود کلید یا ورود مربوط به provider در ~/.akvan/.env و .env پروژه مطمئن شوید.
  3. نام مدل و دسترسی حساب خود به آن مدل را بررسی کنید.
  4. برای جزئیات بیشتر AKVAN_LOG_LEVEL=DEBUG akvan را اجرا کنید.

برای راهنمای عیب‌یابی هر provider، صفحهٔ همان provider را ببینید.

گزارش مشکل مستندات