AiHummer
Polski▾
Zaloguj sięKonto
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Rozpoczynanie/Szybki start

Szybki start

v1.0.x · zaktualizowany 2026-07-20

Ten przewodnik szybkiego startu przeprowadzi Cię przez Twój pierwszy uruchomienie AiHummer — od zera do pierwszego agenta odpowiadającego w kanale. Jest napisany dla osoby, która robi to po raz pierwszy pierwszy raz: każdy krok kończy się to, co powinieneś zobaczyć, a na końcu znajduje się sekcja „Jeśli to nie zadziałało”.

Najpierw wybierz swoją drogę

Są dwa sposoby na uzyskanie AiHummer (pełne porównanie w Wprowadzenie):

  • Chmura — my obsługujemy serwer, ty otrzymujesz gotowy adres. Nic do instalowania. → iść do Ścieżka A: chmura.
  • Samodzielnie hostowane (własny serwer) — instalujesz AiHummer na swoim serwerze Linux za pomocą jednego polecenia. → przejdź do Ścieżka B: własny serwer.

Obie ścieżki następnie łączą się na wspólnych etapach — pierwszy agent i pierwszy kanał.

Ścieżka A: chmura

Czego będziesz potrzebować: adres e-mail, numer telefonu i karta bankowa (na okres próbny bank pobiera 1 ₽, a następnie natychmiast go zwraca).

  1. Zarejestruj się na my.aihummer.ru: wpisz swój e-mail, telefon i hasło, zaakceptuj dwie zgody. Zobaczysz potwierdzenie konta ekran.
  2. Potwierdź konto — przez telefon (wprowadź ostatnie cyfry przychodzącego numeru) lub za pomocą kodu z e-maila. Zobaczysz, że logowanie nastąpiło automatycznie i otwarto kreatora wdrażania. Szczegóły: Rejestracja i logowanie.
  3. W kreatorze wybierz ścieżkę Chmura, a następnie plan (miesięczny / roczny). plan wejścia zawiera 10-dniowy darmowy okres próbny. Szczegóły: Plany.
  4. Wypełnij swoje dane rozliczeniowe (osoba fizyczna lub firma/jednoosobowa działalność gospodarcza) — oni są potrzebne do faktury i aktu.
  5. Wybierz nazwa subdomeny (Twój adres będzie <name>.cloud.aihummer.ru) i płacić. Zobaczysz status „Przygotowywanie twojego asystenta” z postępem. Szczegóły: Zamówienie i płatność.
  6. Poczekaj na przygotowanie (zwykle kilka minut). Gdy status się zmieni Twój asystent działa, kliknij Otwórz panel — interfejs administracyjny sieci Twojego instancja otwiera. Szczegóły: Panel instancji.

Konfiguracja kontynuuje się w interfejsie administracyjnym w sieci — przejdź do swojego pierwszy agent. Hasło administratora dla instancji w chmurze jest ustawiane podczas pierwszego otwarcia panelu (tutaj nie jest potrzebny osobny plik z hasłem stosowany w wersji hołdowanej samodzielnie).

Ścieżka B: własny serwer

Czego będziesz potrzebować: serwer Linux (x86_64 lub arm64), sudo prawa oraz PostgreSQL (lub pozwól instalatorowi je udostępnić). Pełna lista: Wymagania.

Nie ma publicznego skryptu instalacyjnego — link jest osobisty. Zarejestruj się na my.aihummer.ru, otwórz Zainstaluj wyświetl ekran i kliknij „Pobierz mój osobisty link do instalacji”. Zobaczysz gotową komendę z przyciskiem kopiowania.

Krok 2. Zainstaluj za pomocą jednej komendy

Uruchom skopiowane polecenie na serwerze:

curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh

Instalator wykrywa architekturę, pobiera i weryfikuje podpisany pakiet, ustawia katalog główny instalacji na ~/.aihummer i rejestruje usługę bramy w systemd. Zobaczysz dziennik kroku instalacji i na końcu komunikat o uruchomieniu usługi. Pełne szczegóły (kanały wydania, sidecary, instalacja bez uprawnień root): Instalacja.

Krok 3. Wskaż PostgreSQL

Jedynym twardym zależnością jest PostgreSQL z pgcrypto rozszerzenie. Instalator podłącza połączenie za Ciebie; aby ustawić bazę danych ręcznie, użyj AIHUMMER_DATABASE_URL opcje konfiguracyjne:

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable
-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;

Migracje bazy danych stosowane są automatycznie przy uruchomieniu.

Krok 4. Pierwsze logowanie

Gdy usługa jest uruchomiona, otwórz interfejs Web UI administratora na serwerze (port prywatny) :8781 domyślnie):

http://localhost:8781/

Na pustej bazie danych logowanie admin jest tworzony i początkowe hasło jest zapisane w ~/.aihummer/etc/initial-admin-password.txt. Przeczytaj to, zaloguj się, a następnie zmień hasło i natychmiast usuń plik — krok po kroku w Pierwsze logowanie.

Krok: stwórz swojego pierwszego agenta

Ten krok jest wspólny dla chmury i instalacji lokalnej. W interfejsie administracyjnym w przeglądarce otwórz “Agenci” → + Utwórz, ustaw nazwę, personę (polecenie systemowe) i opcjonalnie dedykowany model. Zobaczysz nowego agenta jako kafelek na liście. Pełne szczegóły, z dostosowaniem charakteru i zachowania: Agenci.

Krok: podłącz swój pierwszy kanał

Aby umożliwić przesyłanie wiadomości do AiHummer, dodaj kanał:

  • Telegram — najbardziej gotowy do produkcji konektor; przewodnik krok po kroku „od BotFathera do pierwszej wiadomości” jest w Telegram.
  • Sesje w interfejsie internetowym — najszybszy sposób, aby przetestować agenta przed połączeniem się z zewnętrzny kanał.
  • MAX — rosyjski posłaniec, również dostępny.

Złącze jest zainstalowane na Wtyczki/Sklep ekran, następnie skonfigurowany na Kanały ekran, gdzie Wiązania blokuje zestawy, które agent uruchamia ten kanał. Wyślij wiadomość do kanału i obserwuj, jak przepływ tury kończy się od początku do końca.

Rozmawiaj z agentem bezpośrednio z interfejsu administracyjnego

Kanał nie jest wymagany do pierwszego testu: na “Sesje” strona przycisk „Nowa sesja” otwiera czat z agentem bezpośrednio w interfejsie administracyjnym. W kreatorze możesz załącz pliki (obrazy i dokumenty — model otrzymuje wyodrębniony tekst), a dwa przełączniki nad wątkiem ujawniają koszt na turę i wynik narzędzia — przydatne do zobaczenia, co agent zrobił na każdym etapie.

[!TIP] Możesz również zadzwonić do AiHummer bezpośrednio przez jego zgodne z OpenAI API bez żadnych kanał wcale:

POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}

Zestaw "stream": true do strumieniowania SSE.

Pamiętaj o modelu próbny

Dopóki nie podłączysz prawdziwego modelu, odpowiedzi pochodzą od deterministyczny makiet — przydatne do testowania kanałów, routingu i agentów bez kosztów modelu. Jak podłączyć prawdziwego dostawcę (OpenAI, Anthropic, YandexGPT, GigaChat, Codex przez subskrypcję ChatGPT i inne) znajduje się na Modele strona.

[!NOTE] Prawdziwy model nigdy nie jest obowiązkowy: AiHummer działa na darmowym/lokalnym Zgodne z OpenAI punkty końcowe oraz transport subskrypcji Codex/ChatGPT.

Jeśli to nie zadziałało

  • Polecenie instalacji nie powiodło się — sprawdź, czy uruchamiasz to na Linux x86_64/arm64 i że osobisty link nie jest przestarzały (istnieje przez 30 dni; zdobądź nowy na Ekran „Instaluj”). Diagnostyka: Instalacja.
  • Interfejs administracyjny się nie otwiera — interfejs Web UI nasłuchuje na prywatnym porcie :8781, nie publiczny :8780. Sprawdź usługę: systemctl status aihummer-gateway.
  • Nie można znaleźć początkowego hasła — jest w ~/.aihummer/etc/initial-admin-password.txt, nie w logach. Zobacz Pierwsze logowanie.
  • Płatność w chmurze nie powiodła się — status subskrypcji na pulpicie nawigacyjnym pokazuje powód; spróbuj ponownie, lub (dla firm) wybierz płatność na fakturę, zobacz Zamówienie i płatność.
  • Agent nie odpowiada na kanale — upewnij się, że kanał jest powiązany z agent w bloku „Bindings” oraz że nadawca jest znany systemowi (przez domyślnie agent odpowiada tylko znanym użytkownikom), zobacz Kanały.

Dokąd dalej