Google Song Tử
Đại lý Hermes hỗ trợ Google Gemini với tư cách là nhà cung cấp gốc bằng cách sử dụng Google AI Studio / Gemini API — không phải điểm cuối tương thích với OpenAI. Điều này cho phép Hermes dịch vòng lặp công cụ và thông báo có hình OpenAI nội bộ của mình sang API generateContent gốc của Gemini trong khi vẫn duy trì lệnh gọi công cụ, phát trực tuyến, đầu vào đa phương thức và siêu dữ liệu phản hồi dành riêng cho Gemini.
Hermes cũng hỗ trợ một nhà cung cấp Google Gemini (OAuth) riêng biệt sử dụng cùng một chương trình phụ trợ Cloud Code Assist như Gemini CLI của Google. Sử dụng nhà cung cấp khóa API (gemini) cho đường dẫn API chính thức có rủi ro thấp nhất.
Điều kiện tiên quyết
- Khóa API Google AI Studio — tạo một khóa tại aistudio.google.com/apikey
- Dự án Google Cloud hỗ trợ thanh toán — được khuyến nghị để sử dụng cho đại lý. Cấp miễn phí của Gemini quá nhỏ cho các phiên đại lý kéo dài vì Hermes có thể thực hiện một số cuộc gọi mẫu cho mỗi lượt người dùng.
- Đã cài đặt Hermes — không cần gói Python bổ sung đối với nhà cung cấp Gemini gốc.
Đặt GOOGLE_API_KEY hoặc GEMINI_API_KEY. Hermes kiểm tra cả hai tên để tìm nhà cung cấp gemini.
Bắt đầu nhanh
# Add your Gemini API key
echo "GOOGLE_API_KEY=..." >> ~/.hermes/.env
# Select Gemini as your provider
hermes model
# → Choose "More providers..." → "Google AI Studio"
# → Hermes checks your key tier and shows Gemini models
# → Select a model
# Bắt đầu trò chuyện
trò chuyện Hermes
Nếu bạn muốn chỉnh sửa cấu hình trực tiếp, hãy sử dụng URL cơ sở API Gemini gốc:
model:
default: gemini-3-flash-preview
provider: gemini
base_url: https://generativelanguage.googleapis.com/v1beta
Cấu hình
Sau khi chạy hermes model, ~/.hermes/config.yaml của bạn sẽ chứa:
model:
default: gemini-3-flash-preview
provider: gemini
base_url: https://generativelanguage.googleapis.com/v1beta
Và trong ~/.hermes/.env:
GOOGLE_API_KEY=...
API Gemini bản địa
Điểm cuối được đề xuất là:
https://generativelanguage.googleapis.com/v1beta
Hermes phát hiện điểm cuối này và tạo bộ chuyển đổi Gemini nguyên gốc của nó. Trong nội bộ, Hermes vẫn giữ vòng lặp tác nhân trong các tin nhắn có hình dạng OpenAI, sau đó chuyển từng yêu cầu sang lược đồ gốc của Gemini:
tin nhắn[]→ Song Tửnội dung[]- lời nhắc của hệ thống → Gemini
systemInstruction - lược đồ công cụ → Gemini
functionDeclarations - kết quả công cụ → phần
functionResponsecủa Gemini - phản hồi phát trực tuyến → Các đoạn luồng có hình dạng OpenAI cho vòng lặp Hermes
Đối với việc sử dụng công cụ Gemini 3, Hermes giữ nguyên các giá trị thoughtSignature được đính kèm với các phần gọi hàm và phát lại chúng ở lượt công cụ tiếp theo. Điều đó bao gồm lộ trình quan trọng xác thực cho quy trình làm việc của tổng đài viên gồm nhiều bước.
Song Tử 3 cũng có thể đính kèm chữ ký suy nghĩ vào các phần phản hồi khác. Bộ điều hợp gốc của Hermes ngày nay được tối ưu hóa cho các vòng lặp công cụ tác nhân, do đó, nó chưa phát lại mọi chữ ký không phải lệnh gọi công cụ với độ trung thực hoàn toàn ở cấp độ phần.
Ưu tiên Điểm cuối gốc
Google cũng tiết lộ điểm cuối tương thích với OpenAI:
https://generativelanguage.googleapis.com/v1beta/openai/
Đối với các phiên đại lý Hermes, hãy ưu tiên điểm cuối Gemini gốc ở trên. Hermes bao gồm bộ điều hợp Gemini gốc để nó có thể ánh xạ việc sử dụng công cụ nhiều lượt, kết quả gọi công cụ, phát trực tuyến, đầu vào đa phương thức và siêu dữ liệu phản hồi của Gemini trực tiếp lên API generateContent của Gemini. Điểm cuối tương thích với OpenAI vẫn hữu ích khi bạn đặc biệt cần khả năng tương thích API OpenAI.
Nếu trước đây bạn đã đặt GEMINI_BASE_URL thành URL /openai, hãy xóa hoặc thay đổi nó:
GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta
Nhà cung cấp OAuth
Hermes cũng có nhà cung cấp google-gemini-cli:
hermes model
# → Choose "Google Gemini (OAuth)"
Điều này sử dụng thông tin đăng nhập PKCE của trình duyệt và chương trình phụ trợ Cloud Code Assist. Nó có thể hữu ích cho những người dùng muốn OAuth kiểu Gemini CLI, nhưng Hermes đưa ra cảnh báo rõ ràng vì Google có thể coi việc sử dụng ứng dụng khách Gemini CLI OAuth từ phần mềm của bên thứ ba là vi phạm chính sách. Để sản xuất hoặc sử dụng với rủi ro thấp nhất, hãy ưu tiên nhà cung cấp khóa API ở trên.
Các mẫu có sẵn
Bộ chọn mô hình Hermes hiển thị các mô hình Gemini được duy trì trong sổ đăng ký nhà cung cấp của Hermes. Các lựa chọn phổ biến bao gồm:
| Model | ID | Notes |
|---|---|---|
| Gemini 3.1 Pro Preview | gemini-3.1-pro-preview | Most capable preview model when available |
| Gemini 3 Pro Preview | gemini-3-pro-preview | Strong reasoning and coding model |
| Gemini 3 Flash Preview | gemini-3-flash-preview | Recommended default balance of speed and capability |
| Gemini 3.1 Flash Lite Preview | gemini-3.1-flash-lite-preview | Fastest / lowest-cost option when available |
Tính khả dụng của mô hình thay đổi theo thời gian. Nếu một mô hình biến mất hoặc không được kích hoạt cho khóa của bạn, hãy chạy lại mô hình hermes và chọn một mô hình từ danh sách hiện tại.
:::thông tin ID mẫu
Sử dụng ID mô hình gốc của Gemini chẳng hạn như gemini-3-flash-preview, không phải ID kiểu OpenRouter như google/gemini-3-flash-preview, khi nhà cung cấp: gemini.
:::
Bí danh mới nhất
Google xuất bản các bí danh di động cho dòng Pro và Flash Gemini. gemini-pro-latest và gemini-flash-latest rất hữu ích khi bạn muốn Google tự động nâng cấp mô hình mà không cần thay đổi cấu hình Hermes của bạn.
| Alias | Currently tracks | Notes |
|---|---|---|
gemini-pro-latest | Latest Gemini Pro model | Best when you want Google's current Pro default |
gemini-flash-latest | Latest Gemini Flash model | Best when you want Google's current Flash default |
model:
default: gemini-pro-latest
provider: gemini
base_url: https://generativelanguage.googleapis.com/v1beta
Nếu bạn cần khả năng tái tạo nghiêm ngặt, hãy ưu tiên các ID mô hình rõ ràng, chẳng hạn như gemini-3.1-pro-preview hoặc gemini-3-flash-preview.
Gemma thông qua API Gemini
Google cũng trưng bày các mô hình Gemma thông qua API Gemini. Hermes nhận ra đây là các mô hình của Google nhưng ẩn các mục nhập Gemma có thông lượng rất thấp khỏi bộ chọn mô hình mặc định để người dùng mới không vô tình chọn mô hình cấp đánh giá cho phiên đại lý kéo dài.
ID đánh giá hữu ích bao gồm:
| Model | ID | Notes |
|---|---|---|
| Gemma 4 31B IT | gemma-4-31b-it | Larger Gemma model; useful for compatibility and quality evaluation |
| Gemma 4 26B A4B IT | gemma-4-26b-a4b-it | Smaller active-parameter variant when available |
Tốt nhất, các mô hình này được coi là tùy chọn đánh giá trên khóa API Gemini. Giá API Gemma của Google chỉ ở mức miễn phí và giới hạn sử dụng thấp so với các mô hình Gemini sản xuất, do đó, việc duy trì sử dụng đại lý Hermes thường sẽ chuyển sang mô hình Gemini trả phí, triển khai tự lưu trữ hoặc nhà cung cấp khác có hạn mức phù hợp.
Để sử dụng mô hình Gemma bị ẩn khỏi bộ chọn, hãy đặt trực tiếp:
model:
default: gemma-4-31b-it
provider: gemini
base_url: https://generativelanguage.googleapis.com/v1beta
Chuyển đổi mô hình giữa phiên
Sử dụng lệnh /model trong cuộc trò chuyện:
/model gemini-3-flash-preview
/model gemini-flash-latest
/model gemini-3-pro-preview
/model gemini-pro-latest
/model gemma-4-31b-it
/model gemini-3.1-flash-lite-preview
Nếu bạn chưa định cấu hình Gemini, hãy thoát khỏi phiên và chạy mô hình hermes trước. /model chuyển đổi giữa các nhà cung cấp và mô hình đã được cấu hình sẵn; nó không thu thập các khóa API mới.
Chẩn đoán
hermes doctor
Bác sĩ kiểm tra:
- Liệu
GOOGLE_API_KEYhayGEMINI_API_KEYcó sẵn hay không - Liệu thông tin đăng nhập Gemini OAuth có tồn tại cho
google-gemini-clihay không - Liệu thông tin đăng nhập của nhà cung cấp đã định cấu hình có thể được giải quyết hay không
Để sử dụng hạn ngạch OAuth, hãy chạy phần này trong phiên Hermes:
/gquota
/gquota áp dụng cho nhà cung cấp OAuth google-gemini-cli, không phải nhà cung cấp khóa API AI Studio.
Cổng (Nền tảng nhắn tin)
Gemini hoạt động với tất cả các nền tảng cổng Hermes (Telegram, Discord, Slack, WhatsApp, LINE, Feishu, v.v.). Định cấu hình Gemini làm nhà cung cấp của bạn, sau đó khởi động cổng thông thường:
hermes gateway setup
hermes gateway start
Cổng đọc config.yaml và sử dụng cùng cấu hình của nhà cung cấp Gemini.
Khắc phục sự cố
"Ứng dụng gốc của Gemini yêu cầu khóa API"
Hermes không thể tìm thấy khóa API có thể sử dụng được. Thêm một trong những thứ này vào ~/.hermes/.env:
GOOGLE_API_KEY=...
# or
GEMINI_API_KEY=...
Sau đó chạy lại mô hình Hermes.
"Khóa Google API này nằm ở bậc miễn phí"
Hermes thăm dò các khóa API Gemini trong quá trình thiết lập. Hạn ngạch bậc miễn phí có thể cạn kiệt sau một vài lượt tổng đài viên vì việc sử dụng công cụ, thử lại, nén và các tác vụ phụ trợ có thể yêu cầu nhiều lệnh gọi mô hình.
Bật tính năng thanh toán cho dự án Google Cloud được đính kèm với khóa của bạn, tạo lại khóa nếu cần, sau đó chạy:
hermes model
"Không tìm thấy mẫu 404"
Kiểu máy đã chọn không có sẵn cho tài khoản, khu vực hoặc khóa của bạn. Chạy lại mô hình Hermes và chọn một mô hình Song Tử khác từ danh sách hiện tại.
Model Gemma không được hiển thị trong model hermes
Theo mặc định, Hermes có thể ẩn các mẫu Gemma có thông lượng thấp khỏi bộ chọn. Nếu bạn cố tình muốn đánh giá một cái, hãy đặt ID mô hình trực tiếp trong ~/.hermes/config.yaml.
"vượt quá hạn ngạch 429" trên Gemma
Các mô hình Gemma được hiển thị thông qua API Gemini rất hữu ích cho việc đánh giá, nhưng giới hạn cấp miễn phí API Gemini của chúng lại thấp. Sử dụng chúng để kiểm tra khả năng tương thích, sau đó chuyển sang mô hình Gemini trả phí hoặc nhà cung cấp khác để duy trì các phiên đại lý.
Điểm cuối tương thích với OpenAI đã được định cấu hình
Kiểm tra ~/.hermes/.env để biết:
GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai/
Thay đổi nó thành điểm cuối gốc hoặc xóa phần ghi đè:
GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta
Cảnh báo đăng nhập OAuth
Nhà cung cấp google-gemini-cli sử dụng luồng OAuth Gemini CLI / Cloud Code Assist. Hermes cảnh báo trước khi bắt đầu vì điều này khác với đường dẫn khóa API AI Studio chính thức. Sử dụng nhà cung cấp: gemini với GOOGLE_API_KEY để tích hợp khóa API chính thức.
Công cụ gọi không thành công do lỗi lược đồ
Nâng cấp Hermes và chạy lại mô hình Hermes. Bộ điều hợp Gemini gốc làm sạch các lược đồ công cụ cho định dạng khai báo hàm chặt chẽ hơn của Gemini; các bản dựng cũ hơn hoặc điểm cuối tùy chỉnh có thể không.
Có liên quan
- Nhà cung cấp AI
- Cấu hình
- Nhà cung cấp dự phòng
- AWS Bedrock — tích hợp nhà cung cấp đám mây gốc bằng thông tin đăng nhập AWS