فصل 36: راهنمای راه‌اندازی BYOK — پیکربندی ارائه‌دهندگان هوش مصنوعی شما

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

این فصل شما را در راه‌اندازی هر دو مؤلفه مورد نیاز راهنمایی می‌کند: یک کلید AI Summary (Gemini) و یک ارائه‌دهنده AI Agent (GitHub Copilot یا Claude Code). همچنین مزیتی را پوشش می‌دهد که اغلب مشترکان جدید را غافلگیر می‌کند — برنامه BYOK Pro شما همچنین شامل همگام‌سازی متقابل دستگاه رایگان از طریق GitHub است، نه فقط دسترسی AI.

---

شامل GitHub Sync

با شروع از v2.1.x، هر اشتراک BYOK Pro با همگام‌سازی متقابل دستگاه یادداشت‌ها و ویکی‌ها از طریق مخزن خصوصی GitHub شخصی شما ارسال می‌شود — بدون هزینه اضافی، یک مخزن به ازای هر workspace، بدون محدودیت ذخیره. Sync قبلاً در صفحه‌های ارتقا نامرئی بود؛ اکنون در hero ارزش Pre-Subscribe، کارت Plan، FAQ BYOK Explainer و صفحه تنظیمات Sync ظاهر می‌شود.

تفاوت آن با برنامه اختصاصی Sync Pro: BYOK فقط متن سبک (یادداشت‌ها + ویکی) را از طریق GitHub خود همگام می‌کند. Sync Pro یک سرویس مدیریت‌شده جداگانه است که همه چیز را همگام می‌کند — یادداشت‌ها، صدا، ویدیو و تصاویر لحظه‌ای — از طریق زیرساخت SeaMeet. بیشتر کاربران BYOK فقط به همگام‌سازی متن که قبلاً گنجانده شده نیاز دارند.

برای راهنمای کامل به فصل 38: GitHub Sync مراجعه کنید.

---

اهداف فصل

پس از خواندن این فصل، قادر خواهید بود:

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

---

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

BYOK دو مؤلفه پیکربندی دارد — به علاوه یک مزیت همراه که نیازی به پیکربندی ندارید:

┌─────────────────────────────────────────────────────────────┐
│                    اجزای BYOK                          │
├──────────────────────┬──────────────────────────────────────┤
│  A. خلاصه هوش مصنوعی       │  کلید API Gemini (مورد نیاز)           │
│  (مورد نیاز)          │  توان: رونویسی، خلاصه‌ها،   │
│                      │  آیتم‌های اقدام، تصمیمات، فصل‌ها   │
├──────────────────────┼──────────────────────────────────────┤
│  B. AI Agent         │  GitHub Copilot CLI  ← یا →          │
│  (به حداقل یک نیاز دارید) │  Claude Code CLI                     │
│                      │  توان: تحلیل تصویر لحظه‌ای،        │
│                      │  پرس‌وجوهای سفارشی AI                   │
├──────────────────────┼──────────────────────────────────────┤
│  C. GitHub Sync      │  با BYOK Pro همراه              │
│  (همراه، اختیاری) │  مخزن خصوصی GitHub به ازای هر workspace.  │
│                      │  یادداشت‌ها + ویکی را در دستگاه‌ها همگام می‌کند.  │
│                      │  راه‌اندازی: فصل 38.                       │
└──────────────────────┴──────────────────────────────────────┘

شما باید A و حداقل یک گزینه از B را برای اینکه همه ویژگی‌های AI کار کنند پیکربندی کنید. C اختیاری است اما قبلاً پرداخت شده — هر زمان آماده شدید برای همگام‌سازی متقابل دستگاه آن را روشن کنید.

بازآفرینی ارزش پیشنهادی

آنچه $4.99/ماه BYOK Pro پوشش می‌دهد:

• حریم خصوصی — داده‌ها مستقیماً از دستگاه شما به Google / Anthropic / OpenAI می‌روند؛ سرورهای SeaMeet هرگز آن را نمی‌بینند.
• کیفیت — بهترین مدل را برای هر کار انتخاب کنید.
• کنترل هزینه — مستقیماً به ارائه‌دهندگان پرداخت کنید؛ بیشتر کاربران در سطح رایگان Gemini باقی می‌مانند.
• حاکمیت — کلیدها در keychain سیستم‌عامل شما زندگی می‌کنند؛ در هر زمان لغو کنید.
• همگام‌سازی رایگان و خصوصی — یادداشت‌ها و ویکی را به مخزن خصوصی GitHub خود پشتیبان بگیرید.

کجا در برنامه این را خواهید دید

این پنج مزیت در هر نقطه تماس ارتقا BYOK از طریق BYOK Value Hero مشترک تقویت می‌شوند — در توضیح‌دهنده Pre-Subscribe، رسید پس از اشتراک، تنظیمات → AI، کارت‌های ویژگی قفل شده که وقتی یک کاربر رایگان روی یک ویژگی AI-gated (متن، خلاصه، آیتم‌های اقدام، ترکیب یادداشت، لیست ویکی، AI تصویر لحظه‌ای) کلیک می‌کند ظاهر می‌شوند، و بنر فشار تنظیمات Sync.

---

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

چرا Gemini؟

SeaMeet از مدل Gemini Google برای رونویسی صدا، خلاصه‌های جلسه، استخراج آیتم اقدام و خروجی‌های AI مرتبط استفاده می‌کند. 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 Google برای رونویسی ارسال می‌شود. اگر این برای مورد استفاده شما نگرانی است، سیاست استفاده از داده‌های AI Google را بررسی کنید.

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

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

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

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

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

تست و حذف یک کلید

در تنظیمات API Keys:

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

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

---

بخش B: ارائه‌دهنده AI Agent

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

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

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

---

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

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

مرحله 1: نصب GitHub Copilot CLI

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

Windows (winget):

winget install GitHub.cli

macOS (Homebrew):

brew install gh

Linux (apt):

sudo apt install gh

توجه: SeaMeet دکمه‌های کپی را در کنار هر دستور در UI راه‌اندازی نشان می‌دهد — می‌توانید دستور دقیق را بدون تایپ آن کپی کنید. برای سایر توزیع‌های Linux، به مستندات نصب GitHub CLI مراجعه کنید.

مرحله 2: احراز هویت با GitHub

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

gh auth login

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

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

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

محدودیت 50 chat/ماه: طرح رایگان Copilot برای شروع به اندازه کافی سخاوتمندانه است، اما اگر مکرراً از AI Agent استفاده می‌کنید، ممکن است به حد برسید. می‌توانید به GitHub Copilot Pro ارتقا دهید، یا برای محدودیت‌های بالاتر به Claude Code CLI سوئیچ کنید.

---

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

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

مرحله 1: نصب Claude Code CLI

Windows (PowerShell):

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

macOS / Linux:

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

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

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

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

claude auth

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

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

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

---

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

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

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

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

---

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

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

تست AI Summary:

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

تست AI Agent:

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

---

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

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

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

برای به‌روزرسانی ارائه‌دهنده Agent شما:

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

---

مرجع سریع

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

---

فصل‌های مرتبط

• فصل 31: رونویسی زنده · فصل 32: استخراج هوش مصنوعی · فصل 33: قالب‌های خلاصه هوش مصنوعی · فصل 34: ویرایش نتایج هوش مصنوعی — همه با کلید Gemini شما کار می‌کنند
• فصل 35: اشتراک و صورتحساب — مدیریت طرح و پورتال صورتحساب
• فصل 37: Copilot — استفاده از GitHub Copilot CLI به عنوان AI Agent شما
• فصل 38: GitHub Sync — همگام‌سازی متقابل دستگاه که با برنامه BYOK Pro شما همراه است

---

Last updated: 2026-06-04

← فصل 35: اشتراک و صورتحساب | فصل 37: Copilot →