# Làm thế nào để tích hợp Hermes Agent với Atlas Cloud? > Kết nối Hermes Agent với Atlas Cloud bằng cách lưu khóa Atlas Cloud vào ~/.hermes/.env, chọn provider: custom, đặt base URL là https://api.atlascloud.ai/v1, và chọn live model ID từ /v1/models. Hermes Agent có thể sử dụng [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) làm nhà cung cấp suy luận tùy chỉnh tương thích OpenAI. Việc tích hợp cần ba thứ: khóa API Atlas Cloud, URL cơ sở `https://api.atlascloud.ai/v1` và [ID mô hình từ danh sách mô hình của Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new). Sau khi chúng có trong cấu hình `model:` hiện tại của Hermes Agent, tác nhân có thể chạy qua Atlas Cloud mà không cần SDK riêng của nhà cung cấp. > **Những điểm chính** > > * Cài đặt Hermes Agent bằng trình cài đặt chính thức, sau đó giữ khóa Atlas Cloud trong `~/.hermes/.env` thay vì trong hệ thống kiểm soát phiên bản. > * Cấu hình Hermes Agent với `provider: custom` và `base_url: https://api.atlascloud.ai/v1`. > * Truy vấn `/v1/models` trước khi chọn mô hình. Tên mô hình thay đổi nhanh hơn mã tích hợp, vì vậy phản hồi trực tiếp an toàn hơn sao chép ID cũ từ hướng dẫn. > * Chạy `hermes doctor` trước khi bắt đầu tác nhân hoạt động lâu dài, sau đó sử dụng `hermes` để kiểm tra cuộc trò chuyện đầu tiên. > * API hợp nhất của Atlas Cloud cho phép thay đổi mô hình ngôn ngữ sau này mà không cần xây dựng lại tích hợp Hermes. ## Hermes Agent và Atlas Cloud là gì? [Hermes Agent](https://github.com/NousResearch/hermes-agent) là một tác nhân mã nguồn mở, tự cải thiện do Nous Research xây dựng. Nó bao gồm giao diện terminal, bộ nhớ liên tục, kỹ năng, tự động hóa theo lịch, cổng nhắn tin và hỗ trợ nhiều nhà cung cấp suy luận. Tài liệu Hermes Agent hiện tại nhấn mạnh rằng các mô hình có thể được thay đổi mà không cần viết lại tác nhân. [Nền tảng chính của Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) cung cấp hàng trăm mô hình ngôn ngữ, hình ảnh, video và âm thanh thông qua một API hợp nhất. Đối với Hermes Agent, phần quan trọng là bề mặt suy luận tương thích OpenAI: Hermes có thể coi Atlas Cloud như một nhà cung cấp tùy chỉnh và gửi lưu lượng truy cập hoàn thành cuộc trò chuyện thông thường tới đó. Sự kết hợp này hữu ích khi bạn muốn Hermes Agent độc lập với một nhà cung cấp mô hình duy nhất. Cấu hình tác nhân vẫn ổn định, trong khi mô hình Atlas Cloud được chọn có thể thay đổi khi yêu cầu, giá cả hoặc khả năng sẵn có thay đổi. ## Trước khi bắt đầu Bạn cần: 1. Môi trường Linux, macOS, WSL2 hoặc Windows được hỗ trợ. 2. Một bản cài đặt Hermes Agent hoạt động. 3. Tài khoản và khóa API Atlas Cloud. 4. Đủ số dư Atlas Cloud hoặc quyền truy cập tài khoản cho mô hình bạn chọn. Không dán khóa API thật vào kho lưu trữ công khai, vấn đề, ảnh chụp màn hình hoặc tệp cấu hình dùng chung. Hermes Agent hỗ trợ tệp `.env` cục bộ để các bí mật có thể tách biệt khỏi cấu hình thông thường. ## Bước 1: Cài đặt Hermes Agent Trên Linux, macOS hoặc WSL2, sử dụng trình cài đặt do Nous Research công bố: ```bash curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash ``` Tải lại shell sau khi cài đặt: ```bash source ~/.zshrc ``` Nếu bạn sử dụng Bash, hãy tải lại `~/.bashrc` thay vào đó. Sau đó xác nhận rằng CLI có sẵn: ```bash hermes --help ``` Dự án chính thức cũng hỗ trợ Windows gốc thông qua trình cài đặt PowerShell. Hãy làm theo [tài liệu cài đặt Hermes Agent](https://hermes-agent.nousresearch.com/docs/) hiện tại thay vì tự dịch lệnh Unix sang PowerShell. ## Bước 2: Tạo khóa API Atlas Cloud Đăng nhập vào bảng điều khiển Atlas Cloud và tạo khóa API cho triển khai Hermes Agent này. Sử dụng khóa chuyên dụng khi kiểm soát tài khoản cho phép; tách biệt lưu lượng tác nhân giúp việc luân chuyển và xem xét sử dụng sau này dễ dàng hơn. Lưu khóa vào tệp môi trường cục bộ của Hermes Agent: ```bash printf '\nOPENAI_API_KEY=%s\n' 'replace-with-your-atlas-cloud-key' >> ~/.hermes/.env ``` Thay thế phần giữ chỗ cục bộ. Không đưa khóa thật vào `config.yaml` nếu tệp đó sẽ được sao lưu, đồng bộ hóa hoặc cam kết. Tại sao sử dụng `OPENAI_API_KEY`? Đường dẫn nhà cung cấp tùy chỉnh hiện tại của Hermes Agent giải quyết biến môi trường đó khi URL cơ sở tương thích OpenAI rõ ràng được cấu hình. Atlas Cloud sử dụng xác thực bearer-token trên giao diện tương thích đó. ## Bước 3: Lấy ID mô hình Atlas Cloud trực tiếp Đừng đoán ID mô hình. Kiểm tra [danh sách mô hình Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new), sau đó hỏi API để có danh mục hiện tại: ```bash export ATLASCLOUD_API_KEY='replace-with-your-atlas-cloud-key' curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` Chọn một mô hình văn bản hỗ trợ hành vi mà triển khai Hermes của bạn cần, đặc biệt là sử dụng công cụ, suy luận, độ dài ngữ cảnh và độ trễ dự kiến. Sao chép chính xác `id` do API trả về. Đối với tác nhân liên tục, hãy bắt đầu với mô hình có khả năng sử dụng công cụ đa năng thay vì chỉ tối ưu hóa cho giá token rẻ nhất. Sau khi tích hợp hoạt động, bạn có thể kiểm tra các mô hình chi phí thấp hơn để tóm tắt hoặc các tác vụ thông thường khác. ## Bước 4: Trỏ Hermes Agent tới Atlas Cloud Mở `~/.hermes/config.yaml` và cấu hình phần `model:` hiện tại ở cấp cao nhất: ```yaml model: default: "replace-with-a-live-atlas-cloud-model-id" provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` Giữ khóa trong `~/.hermes/.env`; tệp YAML chỉ cần nhà cung cấp, điểm cuối và ID mô hình. Chi tiết này quan trọng vì các ví dụ Hermes Agent cũ hơn có thể sử dụng khối `inference:`. Mẫu cấu hình chính thức hiện tại sử dụng `model:`. Nếu phiên bản đã cài đặt của bạn hoạt động khác, hãy chạy `hermes update` và kiểm tra tài liệu cấu hình đi kèm với phiên bản đó trước khi thay đổi thêm cài đặt. ## Bước 5: Chẩn đoán cấu hình Chạy các kiểm tra tích hợp sẵn của Hermes Agent: ```bash hermes doctor ``` Sau đó khởi động tác nhân: ```bash hermes ``` Gửi một yêu cầu kiểm tra nhỏ không cần công cụ bên ngoài, chẳng hạn như: ```text Trả lời với tên mô hình bạn đang sử dụng, sau đó tóm tắt những công cụ nào có sẵn trong phiên Hermes này. ``` Một phản hồi được truyền phát bình thường xác nhận rằng Hermes có thể xác thực, đến điểm cuối Atlas Cloud và gọi mô hình đã cấu hình. ## Các vấn đề tích hợp thường gặp ### Lỗi xác thực Kiểm tra rằng `OPENAI_API_KEY` tồn tại trong `~/.hermes/.env`, chứa khóa Atlas Cloud không có dấu ngoặc kép hoặc khoảng trắng thừa và được tải bởi cùng bản cài đặt Hermes bạn đang chạy. Xoay khóa nếu nó đã bị lộ. ### Lỗi mô hình không xác định Gọi lại `https://api.atlascloud.ai/v1/models` và sao chép chính xác ID trực tiếp. Không xóa tiền tố nhà cung cấp hoặc rút ngắn số nhận dạng trừ khi chính phản hồi API sử dụng dạng ngắn hơn. ### Hermes gọi sai nhà cung cấp Xác nhận rằng cấu hình hoạt động chứa cả hai: ```yaml provider: "custom" base_url: "https://api.atlascloud.ai/v1" ``` Việc chọn nhà cung cấp tích hợp sẵn có thể định tuyến yêu cầu đến điểm cuối của nhà cung cấp đó thay vì Atlas Cloud. ### Cấu hình khớp với hướng dẫn cũ nhưng không hoạt động Hermes Agent đang phát triển nhanh chóng. So sánh tệp của bạn với [tham chiếu cấu hình chính thức](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) hiện tại và sử dụng `hermes config get` để kiểm tra hồ sơ hoạt động. Đặc biệt, xác minh xem phiên bản của bạn có mong đợi cấu trúc `model:` hiện tại không. ## Cách thay đổi mô hình mà không cần xây dựng lại tích hợp Khi Atlas Cloud đã được cấu hình làm nhà cung cấp tùy chỉnh, việc chuyển đổi mô hình chỉ cần một ID mới từ [danh mục mô hình trực tiếp](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new): 1. Truy vấn `/v1/models`. 2. Cập nhật `model.default` trong `~/.hermes/config.yaml`. 3. Chạy `hermes doctor`. 4. Bắt đầu một cuộc trò chuyện kiểm tra mới. Điểm cuối và xử lý thông tin xác thực vẫn giữ nguyên. Đây là giá trị thực tế của một API hợp nhất cho tác nhân: đánh giá mô hình trở thành một thay đổi cấu hình thay vì tích hợp SDK mới. ## Khi thiết lập này phù hợp Tích hợp Atlas Cloud phù hợp khi: * Bạn muốn Hermes Agent truy cập nhiều họ mô hình thông qua một tài khoản. * Bạn dự kiến ​​sẽ đánh giá hoặc thay thế mô hình chính theo thời gian. * Bạn muốn một điểm cuối tương thích OpenAI thay vì mã máy khách dành riêng cho nhà cung cấp. * Các kỹ năng Hermes trong tương lai của bạn có thể cần truy cập vào các mô hình hình ảnh hoặc video từ cùng một nền tảng. Tích hợp trực tiếp nhà cung cấp mô hình có thể đơn giản hơn nếu tác nhân sẽ vĩnh viễn sử dụng một nhà cung cấp và bạn không cần danh mục mô hình rộng hơn của Atlas Cloud. Sự lựa chọn đúng đắn phụ thuộc vào việc tính linh hoạt và truy cập tập trung có quan trọng hơn việc có thiết lập một nhà cung cấp ngắn nhất có thể hay không. ## Danh sách kiểm tra cuối cùng Trước khi để Hermes Agent chạy không giám sát, hãy xác minh tất cả năm mục: - Khóa Atlas Cloud được lưu trữ bên ngoài kiểm soát phiên bản. - `provider` được đặt thành `custom`. - `base_url` chính xác là `https://api.atlascloud.ai/v1`. - `model.default` khớp với ID từ điểm cuối mô hình trực tiếp. - `hermes doctor` và một cuộc trò chuyện đơn giản đều thành công. Với các kiểm tra đó hoàn tất, Hermes Agent đã được tích hợp với Atlas Cloud. Bạn hiện có thể đánh giá các mô hình ngôn ngữ khác nhau phía sau cùng một tác nhân mà không cần thay đổi công cụ, bộ nhớ, kỹ năng hoặc giao diện người dùng của nó. ## FAQ ### Hermes Agent có tích hợp sẵn nhà cung cấp Atlas Cloud không? Không cần nhà cung cấp Atlas Cloud chuyên dụng. Hermes Agent có thể kết nối thông qua nhà cung cấp tương thích OpenAI tùy chỉnh của nó bằng URL cơ sở và khóa API của Atlas Cloud. ### URL cơ sở của Atlas Cloud cho Hermes Agent là gì? Sử dụng https://api.atlascloud.ai/v1 làm URL cơ sở tương thích với OpenAI. ### Tôi nên lưu trữ khóa API Atlas Cloud ở đâu? Lưu trữ nó trong ~/.hermes/.env dưới dạng OPENAI_API_KEY và giữ khóa thực tế tránh xa khỏi các tệp cấu hình, ảnh chụp màn hình và kiểm soát phiên bản. ### Hermes Agent nên sử dụng mô hình Atlas Cloud nào? Truy vấn https://api.atlascloud.ai/v1/models và chọn một mô hình văn bản hiện tại đáp ứng các yêu cầu về sử dụng công cụ, suy luận, ngữ cảnh, độ trễ và chi phí của bạn. ### Làm cách nào để xác minh tích hợp? Chạy hermes doctor, khởi động Hermes bằng lệnh hermes, và gửi một prompt thử nghiệm nhỏ. Các lỗi xác thực hoặc lỗi mô hình không xác định thường chỉ ra vấn đề với khóa API, URL cơ sở hoặc ID mô hình.