Хуткі старт

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

AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable

-- once, in the target database
CREATE EXTENSION IF NOT EXISTS pgcrypto;

http://localhost:8781/

Гэта хуткае кіраўніцтва правядзе вас праз першы запуск AiHummer — ад нуля да таго моманту, калі першы агент пачне адказваць у канале. Яно напісана для тых, хто робіць гэта ўпершыню **першы раз**: кожны крок заканчваецца **што ты павінен убачыць**, і ў канцы ёсць раздзел «Калі гэта не спрацавала». ## Спачатку выберыце свой шлях Ёсць два спосабы атрымаць AiHummer (поўнае параўнанне ў [Уводзіны](/be/v1.0/getting-started/introduction#cloud-or-your-own-server-which-to-pick)): - **Воблака** — мы кіруем серверам, вы атрымліваеце гатовую адрасу. Нічога ўсталёўваць не трэба. ісьці да **[Шлях A: воблак](#path-a-cloud)**. - **Самастойна размешчана (ваш уласны сервер)** — вы ўсталёўваеце AiHummer на свой сервер Linux адной камандай. → пайсці да **[Маршрут B: ваш уласны сервер](#path-b-your-own-server)**. Абодва шляхі затым зліваюцца на агульныя крокі — [першы агент](#step-create-your-first-agent) і [першы канал](#step-connect-your-first-channel). ## Шлях A: воблак **Што вам спатрэбіцца:** электронны адрас, нумар тэлефона і банкаўская картка (для пробнага перыяду банк здыме ₽1 і неадкладна верне яго). 1. Зарэгіструйцеся на [my.aihummer.ru](https://my.aihummer.ru)увядзіце ваш e-mail, тэлефон і пароль, прымайце два дазволы. *Вы ўбачыце* пацверджанне рахунку экран 2. Пацвердзіце рахунак — па званку (увядзіце апошнія лічбы ўваходнага нумара) або з кодам з электроннай пошты. Вы ўбачыце, што ўваход адбыўся аўтаматычна і майстар усталёўкі адкрыўся. Падрабязнасці: [Рэгістрацыя і ўваход](/be/v1.0/portal/registration). 3. У чараўніка выберы **Воблака** шлях, тады а **план** (штомесячна/штогадова). план уваходу пастаўляецца з **10-дзённы бясплатны пробны перыяд**Дэталі: [Планы](/be/v1.0/portal/plans). 4. Запоўніце ваш **плацежныя дадзеныя** (асоба або кампанія/індывідуальны прадпрымальнік) — яны патрэбныя для рахунку і акта. 5. Выберыце **назва паддомену** (ваш адрас будзе `<name>.cloud.aihummer.ru`) і **аплаціць**Вы ўбачыце статус «Падрыхтоўка вашага памочніка» з ходам выканання. Дэталі: [Заказ і аплата](/be/v1.0/portal/order-payment). 6. Чакайце забеспячэння (звычайна некалькі хвілін). Калі статус зменіцца **Ваш памочнік працуе**, націсніце **«Адкрытая панэль»** — вэб-інтэрфейс адміністратара вашага экземпляр адкрываецца. Падрабязнасці: [Панэль прыкладання](/be/v1.0/portal/instance). Настройка працягваецца ў вэб-інтэрфейсе адміністратара — перайдзіце да свайго [першы агент](#step-create-your-first-agent)Пароль адміністратара для воблачнага інстанса ўсталёўваецца пры першым адкрыцці панэлі (адзінкавы файл пароля, які выкарыстоўваецца ў самаасбюдаванага варыянту, тут не патрэбны). ## Маршрут B: ваш уласны сервер **Што вам спатрэбіцца:** сервер на Linux (x86_64 або arm64) `sudo` права, і PostgreSQL (ці дазволіць усталёўшчыку яго наладзіць). Поўны спіс: [Патрабаванні](/be/v1.0/getting-started/requirements). ### Крок 1. Атрымаеце сваю асабістую спасылку для ўстаноўкі Публічнай інсталяцыйнай праграмы няма — спасылка наступная **асабісты**Зарэгіструйцеся на [my.aihummer.ru](https://my.aihummer.ru), адкрыйце **Усталяваць** на экране націсніце «Атрымаць маю асабістую спасылку для ўстаноўкі». Вы ўбачыце гатовую каманду з кнопкай для капіявання. ### Крок 2. Усталюйце адной камандай Запусціце скапіяваную каманду на серверы: ```bash curl -fsSL -o install.sh "<your personal install link>" && sudo bash install.sh ``` Усталёўшчык вызначае архітэктуру, загружае і **правярае падпісаны пакет**вызначае каранёвы каталог для ўстаноўкі `~/.aihummer` і рэгіструе сэрвіс шлюза ў systemd. *Вы ўбачыце* журнал крокаў усталёўкі і, напрыканцы, паведамленне пра запуск сэрвісу. Поўныя дэталі (каналы выпуску, сайдкары, усталёўка без правоў root): [Устаноўка](/be/v1.0/getting-started/installation). ### Крок 3. Нацэліцца на PostgreSQL Адзіная строгая залежнасць — гэта PostgreSQL з `pgcrypto` пашырэнне. Усталёўшчык падключае злучэнне за вас; каб наладзіць базу дадзеных уручную, выкарыстоўвайце `AIHUMMER_DATABASE_URL` параметр канфігурацыі: ```ini AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer?sslmode=disable ``` ```sql -- once, in the target database CREATE EXTENSION IF NOT EXISTS pgcrypto; ``` Міграцыі баз дадзеных аўтаматычна прымяняюцца пры запуску. ### Крок 4. Першая аўтарызацыя Пасля запуску службы адкрыйце адміністрацыйны Web-інтэрфейс на серверы (прыватны порт) `:8781` па змаўчанні): ```text http://localhost:8781/ ``` У пустой базе дадзеных уваход `admin` створаны і пачатковы пароль запісаны ў `~/.aihummer/etc/initial-admin-password.txt`Прачытайце гэта, увайдзіце, затым **змяніце пароль і неадкладна выдаліце файл** — крок за крокам у [Першы ўвод](/be/v1.0/getting-started/first-login). ## Крок: стварыце свайго першага агента Гэты крок агульны для воблачнага і самастойна размешчанага варыянтаў. У вэб-інтэрфейсе адміністратара адкрыйце **Агенты** → **Стварыць**вызначце імя, персону (сілавы запыт) і, па жаданні, спецыяльную мадэль. *Вы ўбачыце* новага агента ў спісе як асобную плашку. Поўныя дэталі з наладамі характару і паводзінаў: [Агенты](/be/v1.0/webui/agents). ## Крок: падключыце ваш першы канал Каб паведамленні даходзілі да AiHummer, дадайце канал: - **Тэлеграм** — найбольш гатовы для вытворчасці раз'ём; поўны пакрокавы праход "ад BotFather да першага паведамлення" знаходзіцца ў [Тэлеграм](/be/v1.0/channels/telegram). - **Сесіі ў вэб-інтэрфейсе** — найхутчэйшы спосаб праверыць агента перад падключэннем да знешні канал - **МАКС** — таксама даступны расійскі мэсанджар. Раз'ём усталяваны на [Плагіны/Маркетплэйс](/be/v1.0/webui/marketplace) экран, затым наладжаны на [Каналы](/be/v1.0/webui/channels) экран, дзе **«Звязкі»** наборы блокаў, якія вызначаюць, які агент кіруе гэтым каналам. Адпраўце паведамленне ў канал і назірайце, як ход праходзіць ад пачатку да канца. ## Размаўляйце з агентам непасрэдна з адміністрацыйнага інтэрфейсу Канал не патрабуецца для першага тэсту: на **Сесіі** старонка кнопка «Новая сесія» адкрывае чат з агентам непасрэдна ў інтэрфейсе адміністратара. У кампазітары вы можаце **прымацаваць файлы** (выявы і дакументы — мадэль атрымлівае выдзелены тэкст), і два пераключальнікі над тэмай паказваюць **кошт за ход** і **вынік інструмента** — зручна для таго, каб убачыць, што агент рабіў на кожным кроку. > [!TIP] > Вы таксама можаце непасрэдна выклікаць AiHummer праз яго сумяшчальны з OpenAI API без > канал наогул > > ```http > POST /v1/chat/completions > Content-Type: application/json > > {"model": "default", "messages": [{"role": "user", "content": "Hello"}]} > ``` > > Набор `"stream": true` для струменевай перадачы SSE ## Запомніце макет мадэлі Пакуль вы не падключыце рэальную мадэль, адказы будуць паступаць ад **детэрмінацыйная імітацыя** — зручна для тэставання каналаў, маршрутаў і агентаў без кошту мадэлі. Як падключыць сапраўднага пастаўшчыка (OpenAI, Anthropic, YandexGPT, GigaChat, Codex праз падпіску на ChatGPT і інш.) можна знайсці на [Мадэлі](/be/v1.0/webui/models) старонка. > [!NOTE] > Сапраўдная мадэль ніколі не з'яўляецца *прымусовай*: AiHummer працуе на бясплатнай/лакальнай версіі > Сумяшчальныя з OpenAI канчатковыя пункты і транспарт Codex/ChatGPT-падпіскі. ## Калі гэта не спрацавала - **Каманда ўстаноўкі не выканалася** — праверце, што вы запускаеце гэта на Linux x86_64/arm64 і што асабістая спасылка не састарэла (яна дзейнічае 30 дзён; атрымаць новую на Экран «Устанавіць». Дыягностыка: [Устаноўка](/be/v1.0/getting-started/installation#verify-the-installation). - **Інтэрфейс адміністратара не адкрываецца** — вэб-інтэрфейс слухае на прыватным порце `:8781`, не грамадскасць `:8780`Праверце сэрвіс: `systemctl status aihummer-gateway`. - **Немагчыма знайсці першапачатковы пароль** — гэта знаходзіцца ў `~/.aihummer/etc/initial-admin-password.txt`, не ў журналах. Глядзі [Першы ўвод](/be/v1.0/getting-started/first-login#find-the-initial-password). - **Аплата праз воблака не ўдалася** — статус падпіскі на панэлі паказвае прычына; паўтарыць, або (для кампаній) выбраць аплату па рахунку, глядзець [Заказ і аплата](/be/v1.0/portal/order-payment). - **Агент не адказвае ў канале** — пераканайцеся, што канал звязаны з агент у блоку «Шэры», і адпраўнік вядомы сістэме (па па змаўчанні агент адказвае толькі вядомым карыстальнікам, глядзі [Каналы](/be/v1.0/webui/channels). ## Куды далей - Разгортванне вытворчасці на ўласным серверы: [Устаноўка](/be/v1.0/getting-started/installation). - Наладзіць паводзіны з інтэрфейсу карыстальніка: [Канфігурацыя](/be/v1.0/getting-started/configuration). - Забяспечце першую ўваход [Першы ўвод](/be/v1.0/getting-started/first-login). - Падключыць мадэль: [Мадэлі](/be/v1.0/webui/models).