<!-- Canonical URL: https://ask.atlascloud.ai/pl/integrate-hermes-agent-atlascloud -->

# Jak zintegrować agenta Hermes z Atlas Cloud?

> Połącz Hermes Agent z Atlas Cloud, przechowując klucz Atlas Cloud w pliku ~/.hermes/.env, wybierając dostawcę: custom, ustawiając podstawowy URL na https://api.atlascloud.ai/v1 oraz wybierając identyfikator aktywnego modelu z /v1/models.

Hermes Agent może używać [Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) jako niestandardowego dostawcy wnioskowania zgodnego z OpenAI. Integracja wymaga trzech rzeczy: klucza API Atlas Cloud, podstawowego adresu URL `https://api.atlascloud.ai/v1` oraz [identyfikatora modelu z listy modeli Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new). Po umieszczeniu ich w bieżącej konfiguracji `model:` w Hermes Agent, agent może działać przez Atlas Cloud bez dedykowanego SDK dostawcy.

> **Kluczowe wnioski**
>
> * Zainstaluj Hermes Agent za pomocą oficjalnego instalatora, a następnie przechowuj klucz Atlas Cloud w `~/.hermes/.env`, a nie w systemie kontroli wersji.
> * Skonfiguruj Hermes Agent z `provider: custom` i `base_url: https://api.atlascloud.ai/v1`.
> * Zapytaj o `/v1/models` przed wyborem modelu. Nazwy modeli zmieniają się szybciej niż kod integracji, więc odpowiedź na żywo jest bezpieczniejsza niż kopiowanie starego identyfikatora z tutoriala.
> * Uruchom `hermes doctor` przed rozpoczęciem długotrwałej pracy agenta, a następnie użyj `hermes`, aby przetestować pierwszą rozmowę.
> * Ujednolicone API Atlas Cloud umożliwia późniejszą zmianę modelu językowego bez przebudowywania integracji z Hermes.

## Czym są Hermes Agent i Atlas Cloud?

[Hermes Agent](https://github.com/NousResearch/hermes-agent) to open-source'owy, samodoskonalący się agent stworzony przez Nous Research. Obejmuje interfejs terminalowy, trwałą pamięć, umiejętności, zaplanowane automatyzacje, bramki komunikacyjne oraz obsługę wielu dostawców wnioskowania. Obecna dokumentacja Hermes Agent podkreśla, że modele można zmieniać bez przepisywania agenta.

[Główna platforma Atlas Cloud](https://www.atlascloud.ai/?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud) udostępnia setki modeli językowych, obrazowych, wideo i audio poprzez ujednolicone API. Dla Hermes Agent istotna jest jego powierzchnia wnioskowania zgodna z OpenAI: Hermes może traktować Atlas Cloud jako niestandardowego dostawcę i wysyłać do niego normalny ruch związany z uzupełnianiem czatu.

To połączenie jest przydatne, gdy chcesz, aby Hermes Agent pozostał niezależny od jednego dostawcy modeli. Konfiguracja agenta pozostaje stabilna, podczas gdy wybrany model Atlas Cloud może się zmieniać w zależności od wymagań, ceny lub dostępności.

## Zanim zaczniesz

Potrzebujesz:

1. Środowiska Linux, macOS, WSL2 lub obsługiwanego Windows.
2. Działającej instalacji Hermes Agent.
3. Konta Atlas Cloud i klucza API.
4. Wystarczającego salda Atlas Cloud lub dostępu do konta dla wybranego modelu.

Nie wklejaj prawdziwego klucza API do publicznego repozytorium, zgłoszenia, zrzutu ekranu ani udostępnionego pliku konfiguracyjnego. Hermes Agent obsługuje lokalny plik `.env` właśnie po to, aby sekrety mogły pozostać oddzielone od zwykłej konfiguracji.

## Krok 1: Zainstaluj Hermes Agent

W systemach Linux, macOS lub WSL2 użyj instalatora opublikowanego przez Nous Research:

```bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
```

Przeładuj powłokę po instalacji:

```bash
source ~/.zshrc
```

Jeśli używasz Bash, przeładuj zamiast tego `~/.bashrc`. Następnie potwierdź, że CLI jest dostępne:

```bash
hermes --help
```

Oficjalny projekt obsługuje również natywny Windows przez instalator PowerShell. Postępuj zgodnie z bieżącą [dokumentacją instalacji Hermes Agent](https://hermes-agent.nousresearch.com/docs/), zamiast samodzielnie tłumaczyć polecenie Uniksa na PowerShell.

## Krok 2: Utwórz klucz API Atlas Cloud

Zaloguj się do konsoli Atlas Cloud i utwórz klucz API dla tego wdrożenia Hermes Agent. Użyj dedykowanego klucza, gdy pozwalają na to ustawienia konta; oddzielenie ruchu agenta ułatwia późniejszą rotację i przegląd użycia.

Zapisz klucz w lokalnym pliku środowiskowym Hermes Agent:

```bash
printf '\nOPENAI_API_KEY=%s\n' 'replace-with-your-atlas-cloud-key' >> ~/.hermes/.env
```

Zastąp symbol zastępczy lokalnie. Nie umieszczaj prawdziwego klucza w `config.yaml`, jeśli ten plik będzie kopii zapasowej, synchronizowany lub zatwierdzany.

Dlaczego `OPENAI_API_KEY`? Bieżąca ścieżka niestandardowego dostawcy Hermes Agent rozwiązuje tę zmienną środowiskową, gdy skonfigurowany jest jawny podstawowy adres URL zgodny z OpenAI. Atlas Cloud używa uwierzytelniania tokenem typu Bearer w tym zgodnym interfejsie.

## Krok 3: Pobierz identyfikator modelu Atlas Cloud na żywo

Nie zgaduj identyfikatora modelu. Sprawdź [listę modeli Atlas Cloud](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new), a następnie zapytaj API o bieżący katalog:

```bash
export ATLASCLOUD_API_KEY='replace-with-your-atlas-cloud-key'

curl https://api.atlascloud.ai/v1/models \
  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"
```

Wybierz model tekstowy, który obsługuje zachowanie potrzebne w Twoim wdrożeniu Hermes, szczególnie użycie narzędzi, rozumowanie, długość kontekstu i oczekiwaną latencję. Skopiuj dokładny `id` zwrócony przez API.

W przypadku trwałego agenta zacznij od ogólnego modelu obsługującego narzędzia, zamiast optymalizować tylko pod kątem najniższej ceny tokena. Po uruchomieniu integracji możesz testować tańsze modele do podsumowań lub innych rutynowych zadań.

## Krok 4: Skieruj Hermes Agent na Atlas Cloud

Otwórz `~/.hermes/config.yaml` i skonfiguruj bieżącą sekcję `model:` na najwyższym poziomie:

```yaml
model:
  default: "replace-with-a-live-atlas-cloud-model-id"
  provider: "custom"
  base_url: "https://api.atlascloud.ai/v1"
```

Przechowuj klucz w `~/.hermes/.env`; plik YAML wymaga tylko dostawcy, punktu końcowego i identyfikatora modelu.

Ten szczegół ma znaczenie, ponieważ starsze przykłady Hermes Agent mogą używać bloku `inference:`. Bieżąca oficjalna próbka konfiguracji używa `model:`. Jeśli zainstalowana wersja zachowuje się inaczej, uruchom `hermes update` i sprawdź dokumentację konfiguracji dołączoną do tej wersji przed zmianą większej liczby ustawień.

## Krok 5: Zdiagnozuj konfigurację

Uruchom wbudowane kontrole Hermes Agent:

```bash
hermes doctor
```

Następnie uruchom agenta:

```bash
hermes
```

Wyślij małe żądanie testowe, które nie wymaga zewnętrznych narzędzi, na przykład:

```text
Odpowiedz nazwą modelu, którego używasz, a następnie podsumuj, jakie narzędzia są dostępne w tej sesji Hermes.
```

Normalna przesyłana strumieniowo odpowiedź potwierdza, że Hermes może uwierzytelnić się, dotrzeć do punktu końcowego Atlas Cloud i wywołać skonfigurowany model.

## Typowe problemy z integracją

### Błędy uwierzytelniania

Sprawdź, czy `OPENAI_API_KEY` istnieje w `~/.hermes/.env`, zawiera klucz Atlas Cloud bez dodatkowych cudzysłowów lub spacji oraz jest ładowany przez tę samą instalację Hermes, którą uruchamiasz. Obróć klucz, jeśli został ujawniony.

### Błędy nieznanego modelu

Wywołaj ponownie `https://api.atlascloud.ai/v1/models` i skopiuj dokładny identyfikator na żywo. Nie usuwaj prefiksu dostawcy ani nie skracaj identyfikatora, chyba że sama odpowiedź API używa krótszej formy.

### Hermes wywołuje niewłaściwego dostawcę

Potwierdź, że aktywna konfiguracja zawiera oba:

```yaml
provider: "custom"
base_url: "https://api.atlascloud.ai/v1"
```

Wybór wbudowanego dostawcy może skierować żądanie do jego własnego punktu końcowego zamiast do Atlas Cloud.

### Konfiguracja pasuje do starego tutoriala, ale nie działa

Hermes Agent szybko ewoluuje. Porównaj swój plik z bieżącym [oficjalnym odniesieniem konfiguracji](https://hermes-agent.nousresearch.com/docs/user-guide/configuration) i użyj `hermes config get`, aby sprawdzić aktywny profil. W szczególności sprawdź, czy Twoja wersja oczekuje bieżącej struktury `model:`.

## Jak zmieniać modele bez przebudowywania integracji

Po skonfigurowaniu Atlas Cloud jako niestandardowego dostawcy, zmiana modeli wymaga tylko nowego identyfikatora z [katalogu modeli na żywo](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=integrate-hermes-agent-atlascloud&sort=new):

1. Zapytaj o `/v1/models`.
2. Zaktualizuj `model.default` w `~/.hermes/config.yaml`.
3. Uruchom `hermes doctor`.
4. Rozpocznij nową testową rozmowę.

Punkt końcowy i obsługa poświadczeń pozostają takie same. To jest praktyczna wartość ujednoliconego API dla agenta: ocena modelu staje się zmianą konfiguracji, a nie nową integracją SDK.

## Kiedy to ustawienie jest dobrym rozwiązaniem

Integracja z Atlas Cloud jest dobrym rozwiązaniem, gdy:

* Chcesz, aby Hermes Agent miał dostęp do wielu rodzin modeli za pomocą jednego konta.
* Spodziewasz się testować lub wymieniać główny model w czasie.
* Chcesz mieć punkt końcowy zgodny z OpenAI zamiast kodu klienckiego specyficznego dla dostawcy.
* Twoje przyszłe umiejętności Hermes mogą wymagać dostępu do modeli obrazu lub wideo z tej samej platformy.

Bezpośrednia integracja z dostawcą modelu może być prostsza, jeśli agent będzie trwale używać jednego dostawcy i nie potrzebujesz szerszego katalogu modeli Atlas Cloud. Właściwy wybór zależy od tego, czy elastyczność i scentralizowany dostęp są ważniejsze niż najkrótsza możliwa konfiguracja z jednym dostawcą.

## Ostateczna lista kontrolna

Przed pozostawieniem Hermes Agent działającego bez nadzoru, sprawdź wszystkie pięć pozycji:

- Klucz Atlas Cloud jest przechowywany poza systemem kontroli wersji.
- `provider` jest ustawiony na `custom`.
- `base_url` to dokładnie `https://api.atlascloud.ai/v1`.
- `model.default` pasuje do identyfikatora z punktu końcowego modeli na żywo.
- `hermes doctor` i prosta rozmowa zakończyły się powodzeniem.

Po tych kontrolach Hermes Agent jest zintegrowany z Atlas Cloud. Możesz teraz oceniać różne modele językowe za tym samym agentem bez zmiany jego narzędzi, pamięci, umiejętności ani interfejsu użytkownika.

## FAQ

### Czy Hermes Agent ma wbudowanego dostawcę Atlas Cloud?

Dedykowany dostawca Atlas Cloud nie jest wymagany. Hermes Agent może się połączyć za pomocą swojego niestandardowego dostawcy kompatybilnego z OpenAI, używając podstawowego adresu URL Atlas Cloud i klucza API.

### Jaki jest bazowy URL Atlas Cloud dla Hermes Agent?

Użyj https://api.atlascloud.ai/v1 jako zgodnego z OpenAI podstawowego adresu URL.

### Gdzie powinienem przechowywać klucz API Atlas Cloud?

Przechowuj go w ~/.hermes/.env jako OPENAI_API_KEY i trzymaj prawdziwy klucz poza plikami konfiguracyjnymi, zrzutami ekranu i kontrolą wersji.

### Którego modelu Atlas Cloud powinien używać Hermes Agent?

Zapytaj https://api.atlascloud.ai/v1/models i wybierz aktualny model tekstowy spełniający Twoje wymagania dotyczące użycia narzędzi, rozumowania, kontekstu, opóźnienia i kosztów.

### Jak mogę zweryfikować integrację?

Uruchom hermes doctor, uruchom Hermesa za pomocą komendy hermes i wyślij mały testowy prompt. Błędy autoryzacji lub nieznanego modelu zazwyczaj wskazują na klucz API, bazowy URL lub ID modelu.