Tích hợp OAuth MiniMax

Hãy nghĩ về API key như chìa khóa nhà—chúng hoạt động tốt, nhưng bạn phải tự quản lý, và nếu lỡ mất một cái thì coi như bị khóa trái cửa. OAuth thì giống như thẻ từ khách sạn: tạm thời, gắn với danh tính của bạn, và có thể cấp lại bất cứ lúc nào. Đối với người dùng MiniMax, đó chính xác là những gì Hermes Agent hiện đang cung cấp.

Có gì mới?

Hermes Agent đã bổ sung hỗ trợ OAuth cho MiniMax, nghĩa là giờ đây bạn có thể đăng nhập bằng tài khoản MiniMax của mình thay vì phải vật lộn với một API key. Điều này đặc biệt hữu ích nếu bạn là người dùng MiniMax thường xuyên và muốn có một kết nối an toàn hơn, dựa trên phiên làm việc. Phần tuyệt nhất? Nó hoạt động với cả endpoint toàn cầu và endpoint Trung Quốc.

Tại sao nên dùng OAuth thay vì API key?

• Không cần quản lý key – Không còn phải sao chép, dán, hay lo lắng về việc lộ key trong các tệp .env.
• Tự động làm mới – Token OAuth tự động hết hạn và gia hạn, nên bạn không cần phải tự tay xoay vòng key.
• Vẫn đầy đủ công cụ, vẫn mạnh mẽ – Bạn vẫn truy cập được tất cả các mô hình MiniMax như MiniMax-M2.7 với chất lượng tương tự.

Cách thiết lập

Đầu tiên, hãy đảm bảo bạn đã cài đặt và cập nhật Hermes Agent. Sau đó, thêm thông tin xác thực OAuth MiniMax của bạn:

hermes auth add minimax-oauth

Lệnh này sẽ mở một cửa sổ trình duyệt để bạn đăng nhập vào tài khoản MiniMax và cấp quyền truy cập. Khi hoàn tất, bạn đã sẵn sàng để trò chuyện.

Sử dụng MiniMax với OAuth

Giờ đây, thay vì phải đặt MINIMAX_API_KEY trong ~/.hermes/.env, bạn chỉ cần chạy:

hermes chat --provider minimax --model MiniMax-M2.7

Đối với người dùng ở Trung Quốc, hãy sử dụng endpoint chuyên dụng:

hermes chat --provider minimax-cn --model MiniMax-M2.7

Hermes tự động phát hiện bạn đang sử dụng OAuth và bỏ qua bước kiểm tra API key.

Còn endpoint Trung Quốc thì sao?

Nếu bạn đang dùng endpoint Trung Quốc, quy trình OAuth vẫn tương tự. Chỉ cần đảm bảo bạn chọn MiniMax (Trung Quốc) khi thêm xác thực:

hermes auth add minimax-cn-oauth

Sau đó dùng --provider minimax-cn như bình thường.

Một vài điều cần lưu ý

• Token OAuth được lưu trữ an toàn trong cấu hình Hermes, không phải trong các tệp .env dạng văn bản thuần túy.
• Nếu token hết hạn, Hermes sẽ nhắc bạn xác thực lại—không cần phải hoảng loạn.
• Bạn vẫn có thể sử dụng API key nếu muốn; OAuth chỉ là một tùy chọn bổ sung.

Tóm lại

Tích hợp OAuth MiniMax trong Hermes Agent giống như việc nâng cấp từ chìa khóa vật lý lên ổ khóa thông minh. An toàn hơn, tiện lợi hơn, và loại bỏ rắc rối trong việc quản lý key. Dù bạn đang ở endpoint toàn cầu hay Trung Quốc, giờ đây bạn có thể trò chuyện với các mô hình MiniMax chỉ trong vài giây.

Mẹo thực tế: Nếu bạn đang thử nghiệm nhiều mô hình MiniMax, hãy đặt nhà cung cấp cố định trong config.yaml:

model:
  provider: "minimax"
  default: "MiniMax-M2.7"

Sau đó bạn chỉ cần chạy hermes chat mà không cần thêm bất kỳ cờ nào. Chúc bạn xây dựng vui vẻ!

---