فصل ۳۱: راهنمای راه‌اندازی BYOK — پیکربندی ارائه‌دهندگان AI

BYOK (Bring Your Own Key) را مثل آوردن دانه‌های قهوه خودتان به یک کافه که اسپرسوساز دارد تصور کنید—SeaMeet موتور استخراج و تحلیل را فراهم می‌کند، شما اعتبارنامه‌های دسترسی هوش مصنوعی را تهیه می‌کنید. این داده‌های شما را مستقیماً بین شما و ارائه‌دهنده هوش مصنوعی انتخابی‌تان جاری نگه می‌دارد، بدون هیچ واسطه شخص ثالثی.

این فصل شما را از طریق راه‌اندازی هر دو مؤلفه مورد نیاز راهنمایی می‌کند: یک کلید خلاصه هوش مصنوعی (Gemini) و یک ارائه‌دهنده عامل هوش مصنوعی (GitHub Copilot یا Claude Code).

---

اهداف فصل

پس از خواندن این فصل، خواهید توانست:

• بفهمید کدام کلیدها لازم است و چرا
• یک کلید API Gemini رایگان از Google AI Studio دریافت کنید
• GitHub Copilot CLI را نصب و پیکربندی کنید (سطح رایگان)
• یا به عنوان جایگزین Claude Code CLI را نصب و پیکربندی کنید
• تأیید کنید هر دو مؤلفه کار می‌کنند
• در صورت نیاز یک کلید را به‌روز کنید یا حذف کنید

---

مرور کلی: آنچه نیاز دارید

BYOK دو مؤلفه دارد:

┌─────────────────────────────────────────────────────────────┐
│                    مؤلفه‌های BYOK                            │
├──────────────────────┬──────────────────────────────────────┤
│  الف. خلاصه هوش       │  کلید API Gemini (الزامی)            │
│  مصنوعی (الزامی)     │  قدرت می‌دهد: رونویسی، خلاصه‌ها،   │
│                      │  موارد اقدام، تصمیمات، فصل‌ها        │
├──────────────────────┼──────────────────────────────────────┤
│  ب. عامل هوش         │  GitHub Copilot CLI  ← یا →          │
│  مصنوعی (حداقل      │  Claude Code CLI                     │
│  یکی لازم)           │  قدرت می‌دهد: تحلیل تصاویر لحظه‌ای، │
│                      │  پرسش‌های هوش مصنوعی سفارشی         │
└──────────────────────┴──────────────────────────────────────┘

باید الف و حداقل یک گزینه از ب را پیکربندی کنید تا همه ویژگی‌های هوش مصنوعی کار کنند.

---

بخش الف: خلاصه هوش مصنوعی — کلید API Gemini

چرا Gemini؟

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

دریافت کلید API Gemini خود

1. مرورگر خود را باز کنید و به Google AI Studio بروید (aistudio.google.com/apikey)
   • در صورت درخواست با حساب Google خود وارد شوید
2. روی Create API Key کلیک کنید
3. در صورت درخواست یک پروژه Google Cloud انتخاب یا ایجاد کنید
4. کلید تولیدشده را کپی کنید (با AIza… شروع می‌شود)

سطح رایگان: سطح رایگان Gemini تعداد قابل توجهی تماس API در روز اجازه می‌دهد. برای استفاده معمول ضبط جلسات (چند ساعت صدا در هفته)، سطح رایگان برای اکثر کاربران کافی است.

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

وارد کردن کلید در SeaMeet

در حین جادوگر راه‌اندازی (اولین بار بعد از اشتراک):

1. جادوگر بلافاصله بعد از اشتراک به صورت خودکار باز می‌شود
2. مرحله ۱ بخش خلاصه هوش مصنوعی را نشان می‌دهد
3. کلید Gemini خود را در فیلد ورودی جایگذاری کنید
4. کلید به صورت خودکار تأیید می‌شود—خواهید دید:
   • ✅ علامت تیک سبز: کلید معتبر است
   • ❌ X قرمز: کلید نامعتبر است یا به اشتباه کپی شده—بررسی کنید و مجدداً جایگذاری کنید
5. برای ادامه به راه‌اندازی عامل هوش مصنوعی روی Next کلیک کنید

بعداً، از طریق تنظیمات:

1. تنظیمات را باز کنید (⚙️)
2. به AI → API Keys بروید
3. بخش AI Summary را پیدا کنید
4. روی Edit کلیک کنید یا در فیلد کلید Gemini جایگذاری کنید
5. روی Save کلیک کنید—کلید به صورت خودکار تأیید می‌شود

آزمایش و حذف یک کلید

در تنظیمات کلیدهای API:

• دکمه Test — کلید را در برابر API گوگل تأیید می‌کند
• دکمه Remove — کلید ذخیره‌شده را حذف می‌کند؛ ویژگی‌های خلاصه هوش مصنوعی تا زمانی که کلید جدید اضافه کنید در دسترس نخواهند بود

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

---

بخش ب: ارائه‌دهنده عامل هوش مصنوعی

حداقل به یک ارائه‌دهنده عامل هوش مصنوعی نیاز دارید. SeaMeet در حال حاضر دو مورد را پشتیبانی می‌کند:

ارائه‌دهنده	هزینه	محدودیت	بهترین برای
GitHub Copilot CLI	رایگان (طرح Copilot رایگان)	۵۰ چت/ماه	شروع کار، استفاده سبک
Claude Code CLI	پولی (Claude Pro یا Max)	محدودیت‌های بالاتر	استفاده منظم، کاربران قدرتمند

می‌توانید هر دو را نصب کنید و از تنظیمات → AI بین آن‌ها تغییر دهید.

---

گزینه ۱: GitHub Copilot CLI (رایگان)

GitHub Copilot CLI یک ابزار خط فرمان است که SeaMeet از آن به عنوان عامل هوش مصنوعی استفاده می‌کند. سطح رایگان GitHub Copilot شامل ۵۰ درخواست عامل در ماه است—کافی برای تحلیل تصاویر لحظه‌ای گاه‌به‌گاه و پرسش‌های هوش مصنوعی.

مرحله ۱: GitHub Copilot CLI را نصب کنید

روشی را انتخاب کنید که با سیستم شما مطابقت دارد:

ویندوز (winget):

winget install GitHub.cli

macOS (Homebrew):

brew install gh

Linux (apt):

sudo apt install gh

توجه: SeaMeet دکمه‌های کپی کنار هر دستور در رابط راه‌اندازی نشان می‌دهد—می‌توانید دستور دقیق را بدون تایپ کردن کپی کنید.

مرحله ۲: با GitHub احراز هویت کنید

بعد از نصب، یک ترمینال باز کنید و اجرا کنید:

gh auth login

دستورالعمل‌ها را برای ورود به حساب GitHub خود دنبال کنید. این CLI را به حساب GitHub شما متصل کرده و ویژگی‌های Copilot را فعال می‌کند.

مرحله ۳: در SeaMeet تشخیص دهید

1. در راه‌اندازی کلیدهای API (یا تنظیمات → AI → API Keys):
2. بخش AI Agent → کاشی GitHub Copilot را پیدا کنید
3. روی Refresh (🔄) کلیک کنید
4. SeaMeet برای CLI نصب‌شده اسکن می‌کند
5. اگر پیدا شد: وضعیت ✅ «Detected» ظاهر می‌شود
6. اگر پیدا نشد: نصب خود را بررسی کنید و تکرار کنید

محدودیت ۵۰ چت/ماه: طرح رایگان Copilot برای شروع کار کافی است، اما اگر از عامل هوش مصنوعی مکرراً استفاده کنید ممکن است به محدودیت برسید. می‌توانید به GitHub Copilot Pro ارتقا دهید، یا برای محدودیت‌های بالاتر به Claude Code CLI تغییر دهید.

---

گزینه ۲: Claude Code CLI (پولی)

Claude Code ابزار CLI آنتروپیک است. به یک اشتراک Claude Pro یا Max نیاز دارد اما محدودیت‌های استفاده بالاتری نسبت به سطح رایگان Copilot دارد.

مرحله ۱: Claude Code CLI را نصب کنید

ویندوز (PowerShell):

irm https://claude.ai/install.ps1 | iex

macOS / Linux:

curl -fsSL https://claude.ai/install.sh | sh

رابط راه‌اندازی SeaMeet دکمه‌های کپی برای هر دستور نصب نشان می‌دهد.

مرحله ۲: احراز هویت

بعد از نصب، یک ترمینال باز کنید و اجرا کنید:

claude auth

با حساب Anthropic خود وارد شوید (نیاز به طرح Claude Pro یا Max دارد).

مرحله ۳: در SeaMeet تشخیص دهید

1. در تنظیمات → AI → API Keys → AI Agent → کاشی Claude Code
2. برای تشخیص CLI نصب‌شده روی Refresh (🔄) کلیک کنید
3. وقتی پیدا شد ✅ «Detected» ظاهر می‌شود

---

انتخاب ارائه‌دهنده پیش‌فرض

اگر هم Copilot و هم Claude نصب شده‌اند، SeaMeet به شما امکان می‌دهد کدام یک را به عنوان پیش‌فرض استفاده کنید انتخاب کنید:

1. به تنظیمات → AI → API Keys بروید
2. در بخش AI Agent، هر دو کاشی به عنوان تشخیص داده‌شده نشان داده می‌شوند
3. از دکمه رادیویی یا انتخابگر برای انتخاب ارائه‌دهنده فعال استفاده کنید
4. ارائه‌دهنده انتخابی برای همه درخواست‌های عامل هوش مصنوعی استفاده می‌شود

می‌توانید هر زمان از تنظیمات ارائه‌دهنده را تغییر دهید.

---

تأیید همه چیز کار می‌کند

بعد از راه‌اندازی، یک بررسی کامل انجام دهید:

آزمایش خلاصه هوش مصنوعی:

1. هر ضبطی را در کتابخانه خود باز کنید
2. روی AI Insights → "Generate Summary" کلیک کنید
3. اگر بدون خطا کامل شود: ✅ کلید Gemini کار می‌کند

آزمایش عامل هوش مصنوعی:

1. با استفاده از SeaMeet یک تصویر لحظه‌ای بگیرید
2. آن را در نمایشگر تصاویر لحظه‌ای باز کنید
3. روی تب تحلیل هوش مصنوعی کلیک کنید و یک سوال بپرسید
4. اگر پاسخ دریافت کردید: ✅ ارائه‌دهنده عامل هوش مصنوعی کار می‌کند

---

به‌روزرسانی یک کلید

برای به‌روزرسانی کلید Gemini:

1. تنظیمات → AI → API Keys → AI Summary → Edit
2. کلید قدیمی را پاک کنید و کلید جدید را جایگذاری کنید
3. روی Save کلیک کنید

برای به‌روزرسانی ارائه‌دهنده عامل:

• اگر یک کلید منقضی شده، مراحل نصب/احراز هویت CLI را مجدداً اجرا کنید
• در SeaMeet روی Refresh کلیک کنید تا مجدداً تشخیص داده شود

---

مرجع سریع

┌────────────────────────────────────────────────────────────┐
│                  راهنمای راه‌اندازی BYOK                    │
│                  مرجع سریع                                  │
├────────────────────────────────────────────────────────────┤
│  منبع کلید Gemini  │ aistudio.google.com/apikey (رایگان)   │
│  سطح رایگان Gemini │ سخاوتمندانه — کافی برای استفاده معمول│
│  وارد کردن کلید    │ تنظیمات → AI → API Keys → AI Summary  │
├────────────────────────────────────────────────────────────┤
│  نصب Copilot       │ winget / brew / apt (رایگان)          │
│  احراز هویت Copilot│ gh auth login                         │
│  محدودیت Copilot   │ ۵۰ چت/ماه (سطح رایگان)                │
├────────────────────────────────────────────────────────────┤
│  نصب Claude        │ اسکریپت نصب curl/irm (پولی)           │
│  احراز هویت Claude │ claude auth                           │
│  نیاز Claude       │ اشتراک Claude Pro یا Max              │
├────────────────────────────────────────────────────────────┤
│  تشخیص ارائه‌دهنده │ تنظیمات → AI → API Keys → Refresh 🔄 │
│  تغییر ارائه‌دهنده │ دکمه رادیویی در بخش AI Agent          │
│  آزمایش خلاصه AI  │ ضبط را باز کنید → "Generate Summary"  │
└────────────────────────────────────────────────────────────┘

---

آخرین به‌روزرسانی: 2026-03-20

← فصل ۳۰: اشتراک و صورت‌حساب | فصل ۳۲: ارائه‌دهنده GitHub Copilot →