Hướng dẫn thiết lập BYOK - Cấu hình các nhà cung cấp AI của bạn
Chương 31: Hướng dẫn thiết lập BYOK — Cấu hình các nhà cung cấp AI của bạn
Hãy nghĩ về BYOK (Bring Your Own Key) như việc mang hạt cà phê của riêng bạn đến một quán cà phê có máy pha espresso—SeaMeet cung cấp engine trích xuất và phân tích, bạn cung cấp thông tin xác thực truy cập AI. Điều này giữ cho dữ liệu của bạn chảy trực tiếp giữa bạn và nhà cung cấp AI mà bạn chọn, không có bên trung gian nào.
Chương này hướng dẫn bạn thiết lập cả hai thành phần cần thiết: khóa Tóm tắt AI (Gemini) và nhà cung cấp Trợ lý AI (GitHub Copilot hoặc Claude Code).
Mục tiêu chương
Sau khi đọc chương này, bạn sẽ có thể:
- Hiểu khóa nào cần và tại sao
- Lấy Khóa API Gemini miễn phí từ Google AI Studio
- Cài đặt và cấu hình GitHub Copilot CLI (cấp miễn phí)
- Thay thế cài đặt và cấu hình Claude Code CLI
- Xác minh rằng cả hai thành phần đang hoạt động
- Cập nhật hoặc xóa khóa khi cần
Tổng quan: Những gì bạn cần
BYOK có hai thành phần:
┌─────────────────────────────────────────────────────────────┐
│ CÁC THÀNH PHẦN BYOK │
├──────────────────────┬──────────────────────────────────────┤
│ A. Tóm tắt AI │ Khóa API Gemini (bắt buộc) │
│ (bắt buộc) │ Cung cấp năng lượng: phiên âm, tóm │
│ │ tắt, mục hành động, quyết định, │
│ │ chương │
├──────────────────────┼──────────────────────────────────────┤
│ B. Trợ lý AI │ GitHub Copilot CLI ← HOẶC → │
│ (cần ít nhất một) │ Claude Code CLI │
│ │ Cung cấp năng lượng: phân tích ảnh │
│ │ chụp màn hình, truy vấn AI tùy chỉnh│
└──────────────────────┴──────────────────────────────────────┘
Bạn phải cấu hình A và ít nhất một tùy chọn từ B để tất cả tính năng AI hoạt động.
Phần A: Tóm tắt AI — Khóa API Gemini
Tại sao Gemini?
SeaMeet sử dụng mô hình Gemini của Google để phiên âm âm thanh, tóm tắt cuộc họp, trích xuất mục hành động và các đầu ra AI liên quan. API Gemini có cấp miễn phí hào phóng bao gồm khối lượng công việc cuộc họp điển hình.
Lấy Khóa API Gemini của bạn
- Mở trình duyệt và đi đến Google AI Studio (aistudio.google.com/apikey)
- Đăng nhập bằng tài khoản Google của bạn nếu được nhắc
- Nhấp Create API Key
- Chọn hoặc tạo dự án Google Cloud khi được hỏi
- Sao chép khóa đã tạo (bắt đầu bằng
AIza…)
Cấp miễn phí: Cấp miễn phí của Gemini cho phép số lượng lệnh gọi API đáng kể mỗi ngày. Đối với việc sử dụng ghi cuộc họp điển hình (vài giờ âm thanh mỗi tuần), cấp miễn phí là đủ cho hầu hết người dùng.
Quyền riêng tư: Âm thanh của bạn được gửi trực tiếp đến API của Google để phiên âm. Xem lại chính sách sử dụng dữ liệu AI của Google nếu điều này là mối quan tâm cho trường hợp sử dụng của bạn.
Nhập khóa của bạn vào SeaMeet
Trong trình hướng dẫn thiết lập (lần đầu sau khi đăng ký):
- Trình hướng dẫn mở tự động sau khi bạn đăng ký
- Bước 1 hiển thị phần Tóm tắt AI
- Dán khóa Gemini của bạn vào trường nhập
- Khóa được xác thực tự động — bạn sẽ thấy:
- ✅ Dấu kiểm xanh: Khóa hợp lệ
- ❌ Dấu X đỏ: Khóa không hợp lệ hoặc sao chép không đúng — kiểm tra và dán lại
- Nhấp Next để tiến đến thiết lập Trợ lý AI
Sau đó, qua Cài đặt:
- Mở Cài đặt (⚙️)
- Điều hướng đến AI → Khóa API
- Tìm phần Tóm tắt AI
- Nhấp Edit hoặc dán vào trường khóa Gemini
- Nhấp Lưu — khóa xác thực tự động
Kiểm tra và xóa khóa
Trong cài đặt Khóa API:
- Nút Test — xác thực khóa với API của Google
- Nút Remove — xóa khóa đã lưu; tính năng Tóm tắt AI sẽ không khả dụng cho đến khi bạn thêm khóa mới
Nếu khóa xác thực thất bại, nó tự động bị xóa để tránh lưu trữ khóa bị hỏng. Chỉ cần dán khóa mới.
Phần B: Nhà cung cấp Trợ lý AI
Bạn cần ít nhất một nhà cung cấp Trợ lý AI. SeaMeet hiện hỗ trợ hai:
| Nhà cung cấp | Chi phí | Giới hạn | Tốt nhất cho |
|---|---|---|---|
| GitHub Copilot CLI | Miễn phí (gói Copilot Free) | 50 cuộc trò chuyện/tháng | Bắt đầu, sử dụng nhẹ |
| Claude Code CLI | Trả phí (Claude Pro hoặc Max) | Giới hạn cao hơn | Sử dụng thường xuyên, người dùng chuyên nghiệp |
Bạn có thể cài đặt cả hai và chuyển đổi giữa chúng từ Cài đặt → AI.
Tùy chọn 1: GitHub Copilot CLI (Miễn phí)
GitHub Copilot CLI là công cụ dòng lệnh mà SeaMeet sử dụng làm Trợ lý AI. Cấp GitHub Copilot miễn phí bao gồm 50 yêu cầu trợ lý mỗi tháng—đủ để phân tích ảnh chụp màn hình thông thường và truy vấn AI.
Bước 1: Cài đặt GitHub Copilot CLI
Chọn phương pháp phù hợp với hệ thống của bạn:
Windows (winget):
winget install GitHub.cli
macOS (Homebrew):
brew install gh
Linux (apt):
sudo apt install gh
Lưu ý: SeaMeet hiển thị các nút sao chép bên cạnh từng lệnh trong giao diện người dùng thiết lập — bạn có thể sao chép lệnh chính xác mà không cần gõ.
Bước 2: Xác thực với GitHub
Sau khi cài đặt, mở terminal và chạy:
gh auth login
Làm theo các lời nhắc để đăng nhập vào tài khoản GitHub của bạn. Điều này liên kết CLI với tài khoản GitHub của bạn và bật các tính năng Copilot.
Bước 3: Phát hiện trong SeaMeet
- Trong thiết lập Khóa API của SeaMeet (hoặc Cài đặt → AI → Khóa API):
- Tìm phần Trợ lý AI → thẻ GitHub Copilot
- Nhấp Refresh (🔄)
- SeaMeet quét CLI đã cài đặt
- Nếu tìm thấy: ✅ Trạng thái "Đã phát hiện" xuất hiện
- Nếu không tìm thấy: kiểm tra cài đặt và thử lại
Giới hạn 50 cuộc trò chuyện/tháng: Gói Copilot miễn phí đủ hào phóng để bắt đầu, nhưng nếu bạn sử dụng Trợ lý AI thường xuyên bạn có thể đạt giới hạn. Bạn có thể nâng cấp lên GitHub Copilot Pro, hoặc chuyển sang Claude Code CLI để có giới hạn cao hơn.
Tùy chọn 2: Claude Code CLI (Trả phí)
Claude Code là công cụ CLI của Anthropic. Nó yêu cầu đăng ký Claude Pro hoặc Max nhưng có giới hạn sử dụng cao hơn cấp Copilot miễn phí.
Bước 1: Cài đặt Claude Code CLI
Windows (PowerShell):
irm https://claude.ai/install.ps1 | iex
macOS / Linux:
curl -fsSL https://claude.ai/install.sh | sh
Giao diện người dùng thiết lập SeaMeet hiển thị các nút sao chép cho từng lệnh cài đặt.
Bước 2: Xác thực
Sau khi cài đặt, mở terminal và chạy:
claude auth
Đăng nhập bằng tài khoản Anthropic của bạn (yêu cầu gói Claude Pro hoặc Max).
Bước 3: Phát hiện trong SeaMeet
- Trong Cài đặt → AI → Khóa API → Trợ lý AI → thẻ Claude Code
- Nhấp Refresh (🔄) để phát hiện CLI đã cài đặt
- ✅ "Đã phát hiện" xuất hiện khi tìm thấy
Chọn nhà cung cấp mặc định của bạn
Nếu bạn đã cài đặt cả Copilot và Claude, SeaMeet cho phép bạn chọn cái nào sử dụng mặc định:
- Đi đến Cài đặt → AI → Khóa API
- Trong phần Trợ lý AI, cả hai thẻ sẽ hiển thị là đã phát hiện
- Sử dụng nút radio hoặc bộ chọn để chọn nhà cung cấp đang hoạt động
- Nhà cung cấp được chọn được sử dụng cho tất cả yêu cầu Trợ lý AI
Bạn có thể chuyển đổi nhà cung cấp bất cứ lúc nào từ Cài đặt.
Xác minh mọi thứ hoạt động
Sau khi thiết lập, thực hiện kiểm tra end-to-end nhanh:
Kiểm tra Tóm tắt AI:
- Mở bất kỳ bản ghi nào trong thư viện của bạn
- Nhấp AI Insights → "Generate Summary"
- Nếu hoàn thành mà không có lỗi: ✅ Khóa Gemini đang hoạt động
Kiểm tra Trợ lý AI:
- Chụp màn hình bằng SeaMeet
- Mở nó trong trình xem ảnh chụp màn hình
- Nhấp tab phân tích AI và đặt câu hỏi
- Nếu bạn nhận được phản hồi: ✅ Nhà cung cấp Trợ lý AI đang hoạt động
Cập nhật khóa
Để cập nhật Khóa API Gemini của bạn:
- Cài đặt → AI → Khóa API → Tóm tắt AI → Edit
- Xóa khóa cũ và dán khóa mới
- Nhấp Lưu
Để cập nhật nhà cung cấp Trợ lý:
- Chạy lại các bước cài đặt/xác thực CLI nếu khóa đã hết hạn
- Nhấp Refresh trong SeaMeet để phát hiện lại
Tham khảo nhanh
┌────────────────────────────────────────────────────────────┐
│ HƯỚNG DẪN THIẾT LẬP BYOK │
│ Tham khảo nhanh │
├────────────────────────────────────────────────────────────┤
│ Nguồn khóa Gemini │ aistudio.google.com/apikey (miễn phí) │
│ Cấp miễn phí Gemini│ Hào phóng — đủ cho sử dụng điển hình│
│ Nhập khóa │ Cài đặt → AI → Khóa API → Tóm tắt AI │
├────────────────────────────────────────────────────────────┤
│ Cài đặt Copilot │ winget / brew / apt (miễn phí) │
│ Xác thực Copilot │ gh auth login │
│ Giới hạn Copilot │ 50 cuộc trò chuyện/tháng (cấp miễn phí)│
├────────────────────────────────────────────────────────────┤
│ Cài đặt Claude │ script cài đặt curl/irm (trả phí) │
│ Xác thực Claude │ claude auth │
│ Claude yêu cầu │ Đăng ký Claude Pro hoặc Max │
├────────────────────────────────────────────────────────────┤
│ Phát hiện nhà cung cấp │ Cài đặt → AI → Khóa API → Refresh 🔄│
│ Chuyển đổi nhà cung cấp│ Nút radio trong phần Trợ lý AI │
│ Kiểm tra Tóm tắt AI │ Mở bản ghi → "Generate Summary" │
└────────────────────────────────────────────────────────────┘
Last updated: 2026-03-20
← Chương 30: Đăng ký & Thanh toán | Chương 32: Nhà cung cấp GitHub Copilot →
Published: