AiHummer
Беларуская▾
УвайсціАсабісты кабінет
v1.6.x▾
{ }Swagger

Хуткі старт

v1.6.x · абноўлена 2026-11-10

Гэта хуткае кіраўніцтва правядзе вас праз першы запуск AiHummer — ад нуля да таго моманту, калі першы агент пачне адказваць у канале. Яно напісана для тых, хто робіць гэта ўпершыню першы раз: кожны крок заканчваецца што ты павінен убачыць, і ў канцы ёсць раздзел «Калі гэта не спрацавала».

Спачатку выберыце свой шлях

Ёсць два спосабы атрымаць AiHummer (поўнае параўнанне ў Уводзіны):

  • Воблака — мы кіруем серверам, вы атрымліваеце гатовую адрасу. Нічога ўсталёўваць не трэба. ісьці да Шлях A: воблак.
  • Самастойна размешчана (ваш уласны сервер) — вы ўсталёўваеце AiHummer на свой сервер Linux адной камандай. → пайсці да Маршрут B: ваш уласны сервер.

Абодва шляхі затым зліваюцца на агульныя крокі — першы агент і першы канал.

Шлях A: воблак

Што вам спатрэбіцца: Электронная пошта і тэлефон. Для даступнага пробнага перыяду карта і праверачнае спісанне не патрэбныя; платны працяг патрабуе аплаты.

  1. Зарэгіструйцеся на my.aihummer.ruувядзіце ваш e-mail, тэлефон і пароль, прымайце два дазволы. Вы ўбачыце пацверджанне рахунку экран
  2. Пацвердзіце рахунак — па званку (увядзіце апошнія лічбы ўваходнага нумара) або з кодам з электроннай пошты. Вы ўбачыце, што ўваход адбыўся аўтаматычна і майстар усталёўкі адкрыўся. Падрабязнасці: Рэгістрацыя і ўваход.
  3. У чараўніка выберы Воблака шлях, тады а план (штомесячна/штогадова). Першы пробны перыяд Personal Helper (cloud-personal) доўжыцца 14 дзён без банкаўскай карты і праверачнага спісання. Ён даступны адзін раз. У іншых тарыфаў пробны перыяд ёсць толькі пры відавочным указанні ў выбраным тарыфе Billing; карпаратыўныя тарыфы яго не ўключаюць. Для працягу патрэбная аплата; пробны перыяд не ўключае аўтаматычныя спісанні. Пробны перыяд даступны толькі акаўнтам, якія раней не мелі воблачнай падпіскі; выкарыстоўваецца агульная VM, без выдзеленай VM і платных дапаўненняў. Планы.
  4. Для аплаты па рахунку ўкажыце рэквізіты арганізацыі або ІП у профілі. Пацвярджэнне аператарам не патрабуецца; для карты і даступнага пробнага перыяду гэты крок не патрэбны.
  5. Выберыце назва паддомену (ваш адрас будзе <name>.cloud.aihummer.ru) і пачніце даступны пробны перыяд або аплаціце заказВы ўбачыце статус «Падрыхтоўка вашага памочніка» з ходам выканання. Дэталі: Заказ і аплата.
  6. Чакайце забеспячэння (звычайна некалькі хвілін). Калі статус зменіцца Ваш памочнік працуе, націсніце «Адкрытая панэль» — вэб-інтэрфейс адміністратара вашага экземпляр адкрываецца. Падрабязнасці: Панэль прыкладання.

Настройка працягваецца ў вэб-інтэрфейсе адміністратара — перайдзіце да свайго першы агентПароль адміністратара для воблачнага інстанса ўсталёўваецца пры першым адкрыцці панэлі (адзінкавы файл пароля, які выкарыстоўваецца ў самаасбюдаванага варыянту, тут не патрэбны).

Маршрут B: ваш уласны сервер

Што вам спатрэбіцца: сервер на Linux (x86_64 або arm64) sudo права, і PostgreSQL (ці дазволіць усталёўшчыку яго наладзіць). Поўны спіс: Патрабаванні.

Крок 1. Атрымаеце сваю асабістую спасылку для ўстаноўкі

Публічнай інсталяцыйнай праграмы няма — спасылка наступная асабістыЗарэгіструйцеся на my.aihummer.ru, адкрыйце Усталяваць на экране націсніце «Атрымаць маю асабістую спасылку для ўстаноўкі». Вы ўбачыце гатовую каманду з кнопкай для капіявання.

Крок 2. Усталюйце адной камандай

Запусціце скапіяваную каманду на серверы:

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

Усталёўшчык вызначае архітэктуру, загружае і правярае падпісаны пакетвызначае каранёвы каталог для ўстаноўкі ~/.aihummer і рэгіструе сэрвіс шлюза ў systemd. Вы ўбачыце журнал крокаў усталёўкі і, напрыканцы, паведамленне пра запуск сэрвісу. Поўныя дэталі (каналы выпуску, сайдкары, усталёўка без правоў root): Устаноўка.

Крок 3. Нацэліцца на PostgreSQL

Адзіная строгая залежнасць — гэта PostgreSQL з pgcrypto пашырэнне. Усталёўшчык падключае злучэнне за вас; каб наладзіць базу дадзеных уручную, выкарыстоўвайце AIHUMMER_DATABASE_URL параметр канфігурацыі:

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

Міграцыі баз дадзеных аўтаматычна прымяняюцца пры запуску.

Крок 4. Першая аўтарызацыя

Вэб-панэль, праграма і каналы выкарыстоўваюць адзін публічны адрас сервера. Адкрыйце публічны адрас, паказаны ўсталёўшчыкам; лакальны адрас па змаўчанні — http://localhost:8780/. Выбраны пры ўсталяванні порт можа адрознівацца.

http://localhost:8780/

Увайдзіце з імем і паролем адміністратара, выбранымі ў майстры ўсталявання. Калі пачатковыя даныя створаны аўтаматычна, карыстайцеся выніковай зводкай; прыватны файл etc/initial-admin-password.txt адносіцца толькі да гэтага варыянту пачатковай налады. Не перадавайце даныя ўваходу іншым.

Першы ўвод

Крок: стварыце свайго першага агента

Гэты крок агульны для воблачнага і самастойна размешчанага варыянтаў. У вэб-інтэрфейсе адміністратара адкрыйце Агенты → Стварыцьвызначце імя, персону (сілавы запыт) і, па жаданні, спецыяльную мадэль. Вы ўбачыце новага агента ў спісе як асобную плашку. Поўныя дэталі з наладамі характару і паводзінаў: Агенты.

Крок: падключыце ваш першы канал

Каб паведамленні даходзілі да AiHummer, дадайце канал:

  • Тэлеграм — найбольш гатовы для вытворчасці раз’ём; поўны пакрокавы праход “ад BotFather да першага паведамлення” знаходзіцца ў Тэлеграм.
  • Сесіі ў вэб-інтэрфейсе — найхутчэйшы спосаб праверыць агента перад падключэннем да знешні канал
  • МАКС — таксама даступны расійскі мэсанджар.

Раз’ём усталяваны на Плагіны/Маркетплэйс экран, затым наладжаны на Каналы экран, дзе «Звязкі» наборы блокаў, якія вызначаюць, які агент кіруе гэтым каналам. Адпраўце паведамленне ў канал і назірайце, як ход праходзіць ад пачатку да канца.

Размаўляйце з агентам непасрэдна з адміністрацыйнага інтэрфейсу

Канал не патрабуецца для першага тэсту: на Сесіі старонка кнопка «Новая сесія» адкрывае чат з агентам непасрэдна ў інтэрфейсе адміністратара. У кампазітары вы можаце прымацаваць файлы (выявы і дакументы — мадэль атрымлівае выдзелены тэкст), і два пераключальнікі над тэмай паказваюць кошт за ход і вынік інструмента — зручна для таго, каб убачыць, што агент рабіў на кожным кроку.

[!TIP] Вы таксама можаце непасрэдна выклікаць AiHummer праз яго сумяшчальны з OpenAI API без канал наогул

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

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

Набор "stream": true для струменевай перадачы SSE

Мадэлі

[!NOTE] Для працоўных адказаў падключыце сапраўднага правайдара мадэляў. Платны API-ключ не абавязковы: можна выкарыстоўваць лакальную OpenAI-сумяшчальную мадэль, падтрымліваемую падпіску або свой API-ключ. Мадэлі · Пастаўшчыкі BYOK і LLM

Калі гэта не спрацавала

  • Каманда ўстаноўкі не выканалася — праверце, што вы запускаеце гэта на Linux x86_64/arm64 і што асабістая спасылка не састарэла (яна дзейнічае 30 дзён; атрымаць новую на Экран «Устанавіць». Дыягностыка: Устаноўка.
  • Вэб-панэль, праграма і каналы выкарыстоўваюць адзін публічны адрас сервера. Адкрыйце публічны адрас, паказаны ўсталёўшчыкам; лакальны адрас па змаўчанні — http://localhost:8780/. Выбраны пры ўсталяванні порт можа адрознівацца.
  • Немагчыма знайсці першапачатковы пароль — гэта знаходзіцца ў ~/.aihummer/etc/initial-admin-password.txt (толькі калі пачатковыя даныя ўваходу створаны аўтаматычна), не ў журналах. Глядзі Першы ўвод.
  • Аплата праз воблака не ўдалася — статус падпіскі на панэлі паказвае прычына; паўтарыць, або (для кампаній) выбраць аплату па рахунку, глядзець Заказ і аплата.
  • Агент не адказвае ў канале — пераканайцеся, што канал звязаны з агент у блоку «Шэры», і адпраўнік вядомы сістэме (па па змаўчанні агент адказвае толькі вядомым карыстальнікам, глядзі Каналы.

Куды далей