🔑 Cấu Hình Khóa AI (API Keys)

AMBA kết hợp dữ liệu tài liệu cục bộ và năng lực tính toán trên máy tính của bạn với trí tuệ suy luận logic của các mô hình AI hàng đầu thế giới. Để vận hành AMBA, bạn chỉ cần trang bị khóa API từ ít nhất một nhà cung cấp AI được hỗ trợ.

---

🔒 Bảo Mật Cấp Ngân Hàng: Khóa Lưu Trong OS Keychain

IMPORTANT

Khóa API của bạn không bao giờ lưu dưới dạng văn bản thô.
AMBA ghi trực tiếp các khóa truy cập vào hệ thống lưu trữ chứng thư bảo mật phần cứng của hệ điều hành:

• macOS: Mã hóa trong macOS Keychain nguyên bản của Apple.
• Windows: Mã hóa trong Windows Credential Manager.

Khóa API không bao giờ ghi ra tệp văn bản thô trên ổ cứng, không hiển thị trong nhật ký hệ thống và không bao giờ gửi về bất kỳ máy chủ trung gian nào.

---

📋 Các Nhà Cung Cấp Khuyến Nghị & Cách Lấy Khóa

1. Anthropic Claude (Rất Khuyến Nghị)

Tối ưu cho: Tổng hợp điều hành, phân rã dự án đa phòng ban và lập luận logic chuyên sâu.

1. Truy cập Bảng điều khiển Anthropic.
2. Đăng nhập hoặc tạo tài khoản doanh nghiệp.
3. Chọn mục API Keys và bấm Create Key.
4. Đặt tên khóa là AMBA Desktop và sao chép chuỗi ký tự vừa tạo (bắt đầu bằng sk-ant-...).

2. OpenAI

Tối ưu cho: Tác vụ điều hành thông thường, soạn thảo tài liệu chuẩn mực và phân tích nhanh.

1. Truy cập Nền tảng OpenAI.
2. Chọn Settings > API Keys.
3. Bấm Create new secret key, đặt tên AMBA Desktop, và sao chép khóa (bắt đầu bằng sk-proj-...).

3. Google Gemini

Tối ưu cho: Tiếp nhận khối lượng tài liệu khổng lồ và xử lý đa phương thức tốc độ cao.

1. Truy cập Google AI Studio.
2. Bấm nút Get API key và tạo khóa mới.

---

⚙️ Hướng Dẫn Nhập Khóa Vào AMBA

1. Khởi động phần mềm AMBA trên máy tính của bạn.
2. Trên thanh điều hướng bên trái, bấm vào biểu tượng ⚙️ Cài đặt (Settings).
3. Tại mục Cấu hình Mô hình (Model Profiles), chọn nhà cung cấp bạn muốn cấu hình (ví dụ: anthropic-claude-3-5-sonnet hoặc openai-gpt-4o).
4. Bấm Set API Key (Thiết lập khóa).
5. Dán khóa API của bạn vào ô và bấm Save to Keychain (Lưu vào Keychain).
6. Trạng thái sẽ lập tức chuyển sang huy hiệu màu xanh lá Đã lưu trong Keychain (Saved in Keychain).