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"). Khi cổng đó không phục vụ một model Claude cho tài khoản của bạn, AMBA tự chuyển model đó sang bedrock-runtime.<region>.amazonaws.com (InvokeModel, giống Bedrock playground); mục Cổng gọi Claude của nhà cung cấp cũng cho phép chọn cố định một trong hai.

  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 (và bedrock:InvokeModel, bedrock:InvokeModelWithResponseStream cho các model gọi qua InvokeModel).
  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 Claude cũ như us.anthropic.claude-sonnet-4-5-20250929-v1:0 vẫn dùng Bedrock Converse API như trước. Các mô hình Bedrock không phải Claude (Nova, Llama, Mistral, …) không còn được hỗ trợ; hồ sơ của chúng được xóa ở lần mở ứng dụng đầu tiên sau khi cập nhật. 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.

Google Cloud — Gemini Enterprise Agent Platform (trước đây là Vertex AI) ​

Dành cho doanh nghiệp trả tiền Gemini qua Google Cloud. Tháng 4/2026 Google đổi tên Vertex AI thành Gemini Enterprise Agent Platform; địa chỉ API vẫn là aiplatform.googleapis.com. AMBA đăng nhập bằng khóa JSON của tài khoản dịch vụ và chỉ lưu khóa trong keychain của hệ điều hành.

  1. Chọn hoặc tạo một dự án đã bật thanh toán (billing).
  2. Bật Agent Platform API (aiplatform.googleapis.com).
  3. Mở IAM & Admin → Service Accounts → Create service account, rồi cấp vai trò Agent Platform User (roles/aiplatform.user).
  4. Mở tài khoản vừa tạo → Keys → Add key → Create new key → JSON. File chỉ tải về được một lần, hãy cất giữ cẩn thận.
  5. Nếu Google báo "Key creation is not allowed on this service account", tổ chức của bạn đang chặn việc tạo khóa (mặc định với tổ chức tạo từ tháng 5/2024). Hãy nhờ quản trị viên tổ chức miễn chính sách Disable service account key creation cho dự án này (hướng dẫn của Google).
  6. Trong AMBA: Cài đặt → Mô hình AI → Thêm nhà cung cấp cloud → Google Cloud. Hộp thoại có sẵn các bước trên, mỗi bước có nút mở đúng trang Console. Dán toàn bộ file JSON: AMBA kiểm tra ngay (báo rõ nếu bạn dán API key, JSON của OAuth client hoặc nội dung bị cắt), tự điền mã dự án và hiện tài khoản dịch vụ để bạn đối chiếu.
  7. Giữ khu vực global trừ khi cần xử lý trong Mỹ (us), châu Âu (eu) hoặc một khu vực cụ thể. Bấm Thử kết nối: AMBA lấy token và gửi một yêu cầu một chữ, rồi nói rõ nếu API chưa bật, thiếu vai trò hoặc thanh toán, hay model không có ở khu vực đó.
  8. Lưu, rồi bấm Tải về trên thẻ nhà cung cấp để thấy các model Gemini hiện hành (Gemini 4 Argon, 3.8 Flash, 3.5 Flash, 3.5 Flash-Lite, 3.1 Pro preview). Có thể tự thêm mã model khác.

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

Cách nhanh nhất để kết nối Claude là Thiết lập nhanh ở thanh bên: chọn Anthropic API hoặc Amazon Bedrock rồi dán key (kèm region AWS nếu dùng Bedrock). Claude Opus 5.5 sẽ trở thành mô hình mặc định. Các nhà cung cấp khác được thêm trong Cài đặt:

  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:
    • 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).
    • Tra cứu web (tuỳ chọn): Nhập key Tavily hoặc Brave Search ở mục Tra cứu web để agent có thể tra cứu trên internet trong các dự án cho phép. Nếu tài khoản AMBA của bạn được bật tra cứu web (xem trong Cài đặt) thì không cần key: lượt tra cứu đi qua tài khoản của bạn (1 credit mỗi lượt, có giới hạn số lượt trong 24 giờ và trong 30 ngày). Khi bạn nhập key riêng, key đó luôn được dùng trướ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.