AMBA
English
日本語
한국어
✓Tiếng Việt

Tiếng Việt

English
日本語
한국어

Giao diện

🔑 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ợ.

🔒 Key Được Lưu Ở Đâu: Chỉ Trong Keychain Của Hệ Điều Hành ​

IMPORTANT

AMBA chỉ lưu API key trong keychain của hệ điều hành:

  • macOS: macOS Keychain.
  • Windows: Windows Credential Manager.
  • Linux: Secret Service qua D-Bus (GNOME Keyring, KWallet 5.97 trở lên, hoặc KeePassXC đã bật Secret Service).

Không có cơ chế lưu dự phòng dạng văn bản thô hay trong cơ sở dữ liệu. Key không được ghi vào nhật ký và chỉ được gửi đến đúng nhà cung cấp sở hữu key. Sau khi lưu, AMBA đọc lại key và chỉ báo thành công khi keychain thực sự giữ key. Key được dán vào sẽ được cắt khoảng trắng thừa; key chứa ký tự xuống dòng, ký tự ẩn hoặc ký tự ngoài ASCII bị từ chối.

Linux không có keyring đang chạy: việc lưu thất bại với thông báo "Không có keychain hệ thống…", và Cài đặt → Chẩn đoán Hệ thống hiển thị keychain không khả dụng. Hãy cài đặt hoặc bật GNOME Keyring hay KWallet rồi khởi động lại AMBA (chi tiết).

TIP

macOS hỏi "AMBA wants to use your confidential information stored in … in your keychain"? AMBA giữ mọi key trong một mục keychain duy nhất và chỉ đọc mục đó nhiều nhất một lần trong mỗi lần chạy. Hãy chọn Always Allow (Luôn cho phép) để macOS không hỏi lại; các bản cập nhật có chữ ký giữ nguyên lựa chọn này. Bản build phát triển do bạn tự biên dịch sẽ hỏi lại sau mỗi lần build, vì mỗi bản build có chữ ký mới. Key lưu từ bản 0.5.11 trở về trước được chuyển vào mục duy nhất này ở lần đầu được dùng, nên bạn có thể được hỏi một lần cho mỗi key cũ, chỉ một lần.

Mục nào, và vì sao "Allow" chưa đủ. Hộp thoại ghi tên mục AMBA – saved API keys and connections (tài khoản amba-vault-v1) — mục duy nhất chứa mọi key và kết nối của AMBA. Mục do phiên bản cũ tạo vẫn hiện tên amba cho đến lần tiếp theo bạn lưu key hoặc đăng nhập. Allow (Cho phép) chỉ cấp quyền một lần, nên macOS sẽ hỏi lại ở lần mở AMBA sau và khi bạn lưu key hoặc đăng nhập Google; Always Allow (Luôn cho phép) cấp quyền lâu dài. Trong lúc chạy, AMBA không đụng lại keychain trừ khi một key thực sự thay đổi: việc làm mới phiên đăng nhập Google Drive mỗi giờ chỉ giữ trong bộ nhớ, không còn ghi lại vào keychain.

WARNING

Cập nhật từ 0.5.9? Các key đã lưu sau khi cập nhật lên 0.5.9 không được giữ lại. Hãy nhập lại trong Cài đặt → Mô hình AI. Key lưu từ bản 0.5.8 trở về trước tự động chuyển vào keychain ở lần khởi động đầu tiên.

📋 Các Nhà Cung Cấp Được Hỗ Trợ & 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.

Mô hình khuyến nghị: Claude Opus 5.5 (mô hình Claude mặc định của AMBA), Claude Sonnet 5.5 cho việc hằng ngày cần nhanh và Claude Haiku 5.5 cho việc nhẹ, số lượng lớn; Claude Fable 5.1 là tuỳ chọn cho việc khó nhất. Các mô hình Claude 3.x được giữ ở dạng cũ (legacy).

  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-...).

Claude trên Amazon Bedrock (khuyến nghị cho doanh nghiệp dùng AWS) ​

Nếu công ty bạn đã dùng AWS, hãy dùng Claude qua Claude in Amazon Bedrock: chi phí tính vào và được quản lý trong chính tài khoản AWS của bạn, AMBA gửi yêu cầu tới bedrock-mantle.<region>.api.aws (hiện trong bảng "Dữ liệu rời khỏi máy này").

  1. Trong AWS console, mở Amazon Bedrock → Model access ở region của bạn (ví dụ us-east-1) và bật các mô hình Claude cần dùng: Claude Opus 5.5, Claude Sonnet 5.5, Claude Haiku 5.5.
  2. Tạo thông tin đăng nhập: một Bedrock API key (Amazon Bedrock → API keys; key ngắn hạn hết hạn trong 12 giờ) hoặc một IAM access key được phép gọi bedrock-mantle:CreateInference.
  3. Trong AMBA: Cài đặt → Mô hình AI → Thêm nhà cung cấp cloud → AWS Bedrock, nhập key và region, rồi chọn các mô hình có ghi (Claude in Amazon Bedrock).

Các mô hình này chạy như Claude với key Anthropic: tóm tắt suy nghĩ, mức nỗ lực (effort), prompt caching và gọi công cụ gốc. Hai tính năng của Anthropic không có trên Bedrock nên AMBA không dùng ở đó: tự chạy lại yêu cầu bị từ chối trên mô hình khác (phía máy chủ), và lược đồ công cụ strict. Các mã mô hình Bedrock cũ như us.anthropic.claude-sonnet-4-5-20250929-v1:0 và các mô hình không phải Claude vẫn dùng Bedrock Converse API như trước. Nếu lượt chạy báo lỗi "model access", hãy bật mô hình đó trong Amazon Bedrock → Model access rồi thử lại.

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.

4. OpenRouter ​

Tối ưu cho: Kết nối tập trung đến hàng trăm mô hình mã nguồn mở và thương mại qua một tài khoản duy nhất.

  1. Truy cập OpenRouter.
  2. Vào mục Keys và tạo khóa API mới (bắt đầu bằng sk-or-...).

5. TypeSafe AI (Động cơ Quyết định Jev System 1) ​

Tối ưu cho: Phân loại ý định dưới 1 giây và tự động định tuyến chế độ tư duy (Research, Plan, Agent).

  1. Truy cập TypeSafe AI.
  2. Lấy khóa API cho động cơ phân loại quyết định Jev.

⚙️ 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 > Cài đặt Models (Model Settings).
  3. Hoàn tất thiết lập qua 3 bước trực quan:
    • Bước 1: Mô hình Chính (Primary Model): Chọn mô hình suy luận chiến lược chính (ví dụ: Claude Opus 5.5 hoặc GPT-4o) và nhập khóa API.
    • Bước 2: Chiến lược Dự phòng (Fallback): Cấu hình mô hình thay thế dự phòng khi bị nghẽn mạng hoặc vượt hạn mức (rate limit).
    • Bước 3: Định tuyến Nâng cao & Thực nghiệm (Advanced & Experimental Routing): Nhập khóa OpenRouter hoặc TypeSafe AI (Jev) để bật tính năng tự động phân luồng chế độ tư duy siêu tốc.
  4. Bấm Save Key. Ô nhập sau đó hiển thị key đã được lưu trong keychain. Nếu keychain không giữ được key, một thông báo lỗi giải thích lý do và key không được lưu.

🧭 Model nào sẽ làm việc ​

Model chọn ở Cài đặt → Mô hình AI → Bước 2 là mặc định cho mọi thứ. Lựa chọn riêng được ưu tiên hơn, theo thứ tự:

  1. Agent — model bạn chọn trong chat của một agent. Lựa chọn lưu cho agent đó (kể cả "Bot 1" đầu tiên), không đổi model của dự án; agent dùng nó trong chat, các bước quy trình và khi thử bước. Theo mặc định (…), lựa chọn đầu tiên trong danh sách, bỏ model riêng của agent.
  2. Dự án — model chọn ở Cài đặt dự án → Chung → Model AI. Dự án mới bắt đầu ở Theo mặc định (…).
  3. Mặc định — Cài đặt → Mô hình AI → Bước 2. Đổi ở đây thì mọi dự án và agent chưa chọn riêng đổi theo.

Nếu chưa có gì được chọn, AMBA dùng model đầu tiên đã có khoá. "Tạo bằng một câu" và bước Nhờ agent ghi rõ model và lý do: Opus 5.5 (Amazon Bedrock) · mặc định, · dự án hoặc · agent.

Dự án và agent từ phiên bản trước giữ model đã có. Muốn đưa tất cả về mặc định một lần, dùng Cho tất cả dự án dùng model mặc định ở Bước 2: AMBA báo trước bao nhiêu dự án và agent sẽ đổi và hỏi bạn xác nhận.