# Jak uruchomić Hermes Agent z DeepSeek API z Atlas Cloud > Przewodnik krok po kroku dotyczący uruchamiania agenta open-source Hermes Agent na modelach DeepSeek V4 za pomocą kompatybilnego z OpenAI API Atlas Cloud, z przykładami konfiguracji i cenami. Zainstalowałeś Hermes Agent, otwartoźródłowego autonomicznego agenta od Nous Research, i teraz potrzebujesz modelu, który będzie wystarczająco tani, by działać cały dzień, i wystarczająco wydajny, by obsługiwać prawdziwe wywołania narzędzi. [DeepSeek](https://www.atlascloud.ai/models/list/llm?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=run-hermes-agent-deepseek-api-atlascloud) V4 to oczywisty wybór pod względem kosztów, a Atlas Cloud udostępnia rodzinę DeepSeek przez jeden punkt końcowy zgodny z OpenAI, obsługujący ponad 300 innych modeli. Ten przewodnik przeprowadzi Cię przez podłączenie Hermes Agent do DeepSeek na Atlas Cloud – od bazowego URL i identyfikatorów modeli po działający plik `config.yaml` – tak, aby agent działał na infrastrukturze klasy produkcyjnej bez potrzeby stosowania dodatkowego SDK. ## Co łączysz Hermes Agent to trwały, samodoskonalący się agent, który działa na Twoim własnym serwerze. Jest z założenia niezależny od modelu i dostawcy, więc nie ma znaczenia, czy tokeny DeepSeek pochodzą bezpośrednio z DeepSeek, czy przez bramę – tak długo, jak punkt końcowy mówi językiem API OpenAI. Atlas Cloud to wielomodalna platforma wnioskowania AI, która udostępnia modele tekstowe, obrazowe i wideo przez jeden klucz API i jedno konto rozliczeniowe, zgodne z OpenAI. Ponieważ interfejs jest zgodny z OpenAI, podłączenie Hermes sprowadza się do zmiany bazowego URL i klucza, a nie do przepisywania kodu. To połączenie ma znaczenie dla trwałego agenta. Hermes jest zbudowany do działania przez tygodnie, gromadząc pamięć i wielokrotnego użytku umiejętności, więc model za nim to koszt cykliczny, a nie jednorazowe wywołanie. DeepSeek V4 utrzymuje ten koszt cykliczny na niskim poziomie, nie tracąc na jakości wywoływania narzędzi, a kierowanie go przez Atlas Cloud oznacza, że ten sam klucz, który odpowiada na czat, może później wygenerować obraz lub klip wideo, gdy umiejętność będzie tego potrzebować. Wybierasz nie tylko tani model, ale punkt końcowy, którego agent nie przerasta. Dwa fakty decydują o całej konfiguracji i warto je dokładnie zrozumieć, zanim dotkniesz pliku konfiguracyjnego: * Bazowy URL Atlas Cloud to `https://api.atlascloud.ai/v1`. * Identyfikatory modeli DeepSeek na Atlas Cloud mają prefiks `deepseek-ai/`, na przykład `deepseek-ai/deepseek-v4-pro`. Różni się to od gołego `deepseek-v4-pro`, którego Hermes używa z wbudowanym dostawcą DeepSeek, wskazującym na własny punkt końcowy DeepSeek. Gdy kierujesz ruch przez Atlas Cloud, używasz pełnego identyfikatora z prefiksem i niestandardowego dostawcy zgodnego z OpenAI, a nie wbudowanego. ## Krok 1: Uzyskaj klucz API Atlas Cloud Zaloguj się na console.atlascloud.ai, otwórz API Keys, kliknij Create API Key i skopiuj go w bezpieczne miejsce. Dostęp jest na zasadzie pay-as-you-go, więc nie wymaga depozytu ani minimalnych wydatków. Rejestrujesz się, otrzymujesz klucz i płacisz za każde żądanie. Przechowuj klucz poza systemem kontroli wersji. Hermes celowo rozdziela sekrety od ustawień: `config.yaml` zawiera nieczułe struktury i można go bezpiecznie zatwierdzać lub udostępniać, podczas gdy `~/.hermes/.env` zawiera klucze i jest domyślnie ignorowany przez git. Umieszczenie klucza Atlas Cloud w `.env` i odwoływanie się do niego po nazwie z konfiguracji pozwala na wersjonowanie konfiguracji agenta bez wycieku poświadczeń. ``` echo "ATLASCLOUD_API_KEY=twój-klucz-atlas-cloud" >> ~/.hermes/.env ``` ## Krok 2: Potwierdź identyfikatory modeli DeepSeek, które możesz wywołać Atlas Cloud publikuje swoją listę aktywnych modeli na publicznym punkcie końcowym, więc nigdy nie musisz zgadywać identyfikatora. Szybkie wywołanie zwraca dokładne ciągi, które API akceptuje. ``` curl https://api.atlascloud.ai/v1/models \ -H "Authorization: Bearer $ATLASCLOUD_API_KEY" ``` Sprawdzenie listy na początku to nie strata czasu. Identyfikatory modeli zmieniają się wraz z wydawaniem nowych wersji, a nieaktualny identyfikator z wpisu na blogu lub starego skryptu to najczęstsza przyczyna niepowodzenia pierwszego wywołania. Punkt końcowy `/v1/models` to źródło prawdy o tym, co API dziś zaakceptuje, więc sprawdzenie go przed edycją konfiguracji oszczędza rundę błędów nieznanego modelu. Wpisy DeepSeek, które będą najczęściej używane, to: | Identyfikator modelu | Najlepsze zastosowanie | Kontekst | |---|---|---| | `deepseek-ai/deepseek-v4-pro` | Główna pętla agenta, kodowanie, wywołania narzędzi | 1 mln tokenów | | `deepseek-ai/deepseek-v4-flash` | Zadania pomocnicze, wysoka przepustowość | 1 mln tokenów | | `deepseek-ai/deepseek-v3.2` | Ogólny czat wrażliwy na koszty | 163 tys. tokenów | DeepSeek V4 Pro kosztuje 1,68 USD za milion tokenów wejściowych i 3,38 USD za milion tokenów wyjściowych na Atlas Cloud, podczas gdy V4 Flash kosztuje 0,14 USD za wejście i 0,28 USD za wyjście. Ta różnica to cały powód, dla którego warto podzielić główne i pomocnicze zadania między te dwa modele, co robi poniższa konfiguracja. ## Krok 3: Skieruj Hermes na Atlas Cloud Ponieważ Atlas Cloud to niestandardowy punkt końcowy zgodny z OpenAI, a nie wbudowany dostawca DeepSeek w Hermes, definiujesz go jawnie w `~/.hermes/config.yaml`. Blok dostawcy określa bazowy URL i zmienną środowiskową przechowującą klucz, a blok modelu wybiera identyfikator DeepSeek z prefiksem. ``` inference: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: default: deepseek-ai/deepseek-v4-pro ``` Zapisz plik, a następnie uruchom agenta. ``` hermes ``` Jeśli pierwsza wiadomość zwróci normalną odpowiedź, połączenie jest poprawne. Jeśli otrzymasz błąd uwierzytelniania, klucz w `.env` jest nieprawidłowy lub nie został załadowany; jeśli otrzymasz błąd nieznanego modelu, sprawdź ponownie prefiks `deepseek-ai/` względem wyników `/v1/models` z Kroku 2. Najczęstszym błędem jest tutaj sięgnięcie po wbudowanego dostawcę `deepseek` w Hermes, oczekując, że odpowie Atlas Cloud. Wbudowany dostawca jest na stałe podpięty do własnego punktu końcowego DeepSeek i jego gołych nazw modeli, więc będzie chętnie obciążał Twoje konto DeepSeek, ignorując Atlas Cloud. Kierowanie przez Atlas Cloud to celowy wybór niestandardowego dostawcy: własny `base_url`, klucz Atlas Cloud i identyfikatory modeli z prefiksem `deepseek-ai/`. Trzymaj te trzy rzeczy razem, a te dwie ścieżki nigdy się nie pomylą. ## Krok 4: Kieruj tanie zadania do Flash Hermes wykonuje wiele niskowartościowych wywołań w tle: podsumowywanie stron internetowych, analiza wizyjna, kompresja kontekstu, zatwierdzanie poleceń. Płacenie stawek V4 Pro za nie to marnotrawstwo. Skieruj pomocnicze sloty na V4 Flash, aby główna pętla korzystała z silniejszego modelu, podczas gdy zadania w tle działają za ułamek kosztów. ``` auxiliary: web_extract: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash compression: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash timeout: 120 ``` Każdy slot pomocniczy akceptuje własnego dostawcę, model, bazowy URL, klucz i łańcuch zastępczy, więc możesz niezależnie dostroić każde zadanie w tle. ## Krok 5: Dodaj rozwiązanie zastępcze dla odporności Długo działający agent prędzej czy później napotka limit szybkości lub przekroczenie czasu połączenia. Łańcuch zastępczy utrzymuje go w działaniu zamiast kończyć się błędem. Tutaj zadanie kompresji najpierw próbuje V4 Flash, a następnie wraca do drugiego modelu Atlas Cloud, zanim się podda. ``` auxiliary: compression: provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v4-flash fallback_chain: - provider: atlascloud base_url: https://api.atlascloud.ai/v1 api_key_env: ATLASCLOUD_API_KEY model: deepseek-ai/deepseek-v3.2 ``` Hermes próbuje każdego wpisu po kolei, aż jeden się powiedzie, więc pojedyncza usterka dostawcy nie zatrzymuje agenta. Dla agenta działającego bez nadzoru zgodnie z harmonogramem, to różnica między zadaniem cron, które po cichu się odbudowuje, a takim, które umiera o 3 nad ranem i zostawia Ci ślad stosu o poranku. ## Kiedy ta konfiguracja jest odpowiednia Uruchamianie Hermes na DeepSeek przez Atlas Cloud ma największy sens, gdy chcesz mieć jeden klucz i jeden rachunek za wszystko, czego agent dotknie. Ponieważ ten sam punkt końcowy obsługuje również modele obrazowe i wideo, agent, który zaczyna jako tekstowy, może później generować obrazy lub klipy bez nowej integracji lub drugiego konta dostawcy. Jeśli Twój agent będzie kiedykolwiek wywoływać tylko DeepSeek i nic więcej, wbudowany dostawca DeepSeek skierowany na własne API DeepSeek jest prostszą ścieżką. Droga przez Atlas Cloud ma sens, gdy chcesz mieć miejsce na dodawanie modeli w różnych modalnościach za jednym, zgodnym z OpenAI interfejsem. Możesz potwierdzić każdy identyfikator modelu i aktualną cenę na atlascloud.ai/models, zanim zatwierdzisz to w pliku konfiguracyjnym – to nawyk, który warto zachować, gdy linia DeepSeek ewoluuje. Powiązane wskazówki implementacyjne znajdziesz w [przełączaniu aplikacji zgodnej z OpenAI na inne modele LLM](https://ask.atlascloud.ai/what-api-provider-lets-me-switch-from-openai-to-other-llms) oraz [ocenie API wnioskowania AI dla produkcji](https://ask.atlascloud.ai/what-to-evaluate-before-choosing-ai-inference-api).