Đổi danh tính và mô hình của trợ lý
Cách chọn loại danh tính trợ lý (Koog / Claude Code / Codex), đổi mô hình ở đâu, và bốn lỗi thường gặp khi không chuyển được.
Việc «trợ lý AI dùng mô hình nào» trong Braidrun được chọn qua hai bước: trước hết là danh tính trợ lý (ai chạy), sau đó là mô hình (chạy cái gì). Đa số mọi người mắc kẹt vì gộp hai bước này làm một.
Bước 1: chọn danh tính trợ lý
Vào «Thiết lập tài khoản → Trợ lý AI», mục đầu tiên của biểu mẫu chính là loại danh tính trợ lý, chọn một trong ba:
| Danh tính | Nó là gì | Cần loại thông tin xác thực nào |
|---|---|---|
| Koog | Engine tích hợp sẵn, gọi thẳng các LLM thông thường theo Provider + mô hình. Đây là lựa chọn mặc định. | API Key của Provider tương ứng (OpenAI, Anthropic, OpenRouter, DeepSeek…) |
| Claude Code | Chạy dòng lệnh Claude Code như chính bản thân trợ lý. | Token thuê bao Claude — điền provider của thông tin xác thực là claude_code_oauth |
| Codex | Chạy dòng lệnh Codex như chính bản thân trợ lý. | Tệp auth.json của Codex — điền provider của thông tin xác thực là codex_subscription |
Khi chuyển sang Claude Code hoặc Codex mà chưa có thông tin xác thực thuê bao tương ứng, trang sẽ báo «không tìm thấy thông tin xác thực thuê bao dùng được cho danh tính hiện tại» và từ chối lưu — đây là chủ ý, để không lưu một cấu hình không chạy được. Cách xử lý: vào «Tích hợp → Nhà cung cấp mô hình» thêm thông tin xác thực trước, rồi quay lại đổi danh tính.
Bước 2: chọn mô hình
Với danh tính Koog
- Trước hết chọn chế độ cấu hình: mẫu preset (dùng cấu hình có sẵn) hoặc cấu hình tùy chỉnh (tự điền từng mục).
- Chọn Provider — danh sách mô hình được tải theo từng Provider, nên sau khi đổi Provider hãy mở lại danh sách mô hình để nạp mới.
- Chọn mô hình LLM. Nếu danh sách không có mã bạn cần, cứ gõ tay ID mô hình.
- (Tùy chọn) Chỉ định mỗi Provider dùng thông tin xác thực nào. Để trống thì hệ thống tự khớp theo thứ tự cá nhân → nhóm với cùng Provider.
Với danh tính Claude Code / Codex
Danh sách mô hình lấy từ những gì tài khoản thuê bao của bạn hỗ trợ, không đi qua danh sách Provider. Cách điền theo gợi ý trong khối cấu hình của runtime đó — ví dụ phía Codex thường là các tên như gpt-5.6-sol.
Chỗ dễ nhầm nhất
Ở danh tính Koog, phía dưới trang còn một khối «Claude Code / Codex (làm Agent con bên ngoài được gọi như công cụ)». Nó hoàn toàn khác với loại danh tính trợ lý:
- Vai trò — Quyết định ai chạy toàn bộ cuộc trò chuyện. Chọn Claude Code thì bản thân trợ lý chính là Claude Code.
- Agent con bên ngoài — Trợ lý vẫn là Koog, chỉ gọi Claude Code hoặc Codex như một công cụ khi cần. Khối này chỉ hiện khi bạn tích external_agent trong bộ công cụ.
Muốn thay chính bản thân trợ lý thì đổi danh tính ở trên; chỉ muốn nó thỉnh thoảng mượn CLI bên ngoài thì cấu hình Agent con ở dưới.
Danh tính còn quyết định nó có sửa được quy trình không
Danh tính Koog vốn hỗ trợ tạo và sửa quy trình ngay trong hội thoại. Khi chuyển sang Claude Code / Codex, khả năng này phụ thuộc kênh soạn thảo do phía triển khai cấu hình; nếu chưa có, khi bạn yêu cầu dựng quy trình sẽ nhận thông báo rõ ràng: danh tính trợ lý hiện tại không hỗ trợ công cụ chỉnh sửa quy trình trong hệ thống, hãy quay lại Koog.
Nếu nhu cầu chính của bạn là để trợ lý dựng quy trình, cứ ở lại Koog là đỡ phiền nhất. Khi cần đến khả năng lập trình của Claude Code / Codex hãy chuyển sang, hoặc đơn giản là chọn riêng chúng cho một bước Agent trong quy trình — xem trang tiếp theo.
Đối chiếu các lỗi thường gặp
| Bạn thấy gì | Nguyên nhân thật sự | Làm gì |
|---|---|---|
| Không tìm thấy giấy chứng nhận đăng ký cho danh tính hiện thời | Bạn đã chuyển sang danh tính bên ngoài nhưng trung tâm thông tin xác thực chưa có thông tin thuê bao của provider tương ứng. | Thêm thông tin xác thực claude_code_oauth hoặc codex_subscription trước, rồi mới đổi danh tính. |
| Danh tính trợ lý hiện tại không hỗ trợ công cụ chỉnh sửa quy trình trong hệ thống | Kênh soạn thảo quy trình dành cho danh tính bên ngoài chưa sẵn sàng trên bản triển khai này. | Quay lại Koog để hoàn tất việc soạn thảo, hoặc liên hệ quản trị viên kiểm tra cấu hình triển khai. |
| Danh sách mô hình trống | Danh sách mô hình của Provider đó chưa tải được, hoặc bạn vừa đổi Provider mà chưa nạp lại. | Đóng rồi mở lại danh sách để kích hoạt tải lại; nếu vẫn trống thì gõ thẳng ID mô hình. |
| Lưu được nhưng vừa trò chuyện đã báo thiếu Key | Đã chọn Provider nhưng không phân giải được thông tin xác thực nào (cả cá nhân lẫn nhóm đều không có của provider đó). | Thêm một thông tin xác thực cho Provider đó trong trung tâm thông tin xác thực, hoặc chọn rõ một mục đã có trong cấu hình. |
Đọc tiếp
- Đổi mô hình cho Agent trong quy trình — Mô hình trong quy trình là một thiết lập riêng, không ảnh hưởng tới trợ lý.
- Lấy chìa khóa của bạn — Xin Key của từng nhà cung cấp ở đâu, chi phí tính vào tài khoản ai.
- Nhận diện — Cách lưu thông tin xác thực và cách phân giải giữa cá nhân với nhóm.