Хуткі старт
Гэта хуткае кіраўніцтва правядзе вас праз першы запуск AiHummer — ад нуля да таго моманту, калі першы агент пачне адказваць у канале. Яно напісана для тых, хто робіць гэта ўпершыню першы раз: кожны крок заканчваецца што ты павінен убачыць, і ў канцы ёсць раздзел «Калі гэта не спрацавала».
Спачатку выберыце свой шлях
Ёсць два спосабы атрымаць AiHummer (поўнае параўнанне ў Уводзіны):
- Воблака — мы кіруем серверам, вы атрымліваеце гатовую адрасу. Нічога ўсталёўваць не трэба. ісьці да Шлях A: воблак.
- Самастойна размешчана (ваш уласны сервер) — вы ўсталёўваеце AiHummer на свой сервер Linux адной камандай. → пайсці да Маршрут B: ваш уласны сервер.
Абодва шляхі затым зліваюцца на агульныя крокі — першы агент і першы канал.
Шлях A: воблак
Што вам спатрэбіцца: Электронная пошта і тэлефон. Для даступнага пробнага перыяду карта і праверачнае спісанне не патрэбныя; платны працяг патрабуе аплаты.
- Зарэгіструйцеся на my.aihummer.ruувядзіце ваш e-mail, тэлефон і пароль, прымайце два дазволы. Вы ўбачыце пацверджанне рахунку экран
- Пацвердзіце рахунак — па званку (увядзіце апошнія лічбы ўваходнага нумара) або з кодам з электроннай пошты. Вы ўбачыце, што ўваход адбыўся аўтаматычна і майстар усталёўкі адкрыўся. Падрабязнасці: Рэгістрацыя і ўваход.
- У чараўніка выберы Воблака шлях, тады а план (штомесячна/штогадова).
Першы пробны перыяд Personal Helper (
cloud-personal) доўжыцца 14 дзён без банкаўскай карты і праверачнага спісання. Ён даступны адзін раз. У іншых тарыфаў пробны перыяд ёсць толькі пры відавочным указанні ў выбраным тарыфе Billing; карпаратыўныя тарыфы яго не ўключаюць. Для працягу патрэбная аплата; пробны перыяд не ўключае аўтаматычныя спісанні. Пробны перыяд даступны толькі акаўнтам, якія раней не мелі воблачнай падпіскі; выкарыстоўваецца агульная VM, без выдзеленай VM і платных дапаўненняў. Планы. - Для аплаты па рахунку ўкажыце рэквізіты арганізацыі або ІП у профілі. Пацвярджэнне аператарам не патрабуецца; для карты і даступнага пробнага перыяду гэты крок не патрэбны.
- Выберыце назва паддомену (ваш адрас будзе
<name>.cloud.aihummer.ru) і пачніце даступны пробны перыяд або аплаціце заказВы ўбачыце статус «Падрыхтоўка вашага памочніка» з ходам выканання. Дэталі: Заказ і аплата. - Чакайце забеспячэння (звычайна некалькі хвілін). Калі статус зменіцца Ваш памочнік працуе, націсніце «Адкрытая панэль» — вэб-інтэрфейс адміністратара вашага экземпляр адкрываецца. Падрабязнасці: Панэль прыкладання.
Настройка працягваецца ў вэб-інтэрфейсе адміністратара — перайдзіце да свайго першы агентПароль адміністратара для воблачнага інстанса ўсталёўваецца пры першым адкрыцці панэлі (адзінкавы файл пароля, які выкарыстоўваецца ў самаасбюдаванага варыянту, тут не патрэбны).
Маршрут 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(толькі калі пачатковыя даныя ўваходу створаны аўтаматычна), не ў журналах. Глядзі Першы ўвод. - Аплата праз воблака не ўдалася — статус падпіскі на панэлі паказвае прычына; паўтарыць, або (для кампаній) выбраць аплату па рахунку, глядзець Заказ і аплата.
- Агент не адказвае ў канале — пераканайцеся, што канал звязаны з агент у блоку «Шэры», і адпраўнік вядомы сістэме (па па змаўчанні агент адказвае толькі вядомым карыстальнікам, глядзі Каналы.
Куды далей
- Разгортванне вытворчасці на ўласным серверы: Устаноўка.
- Наладзіць паводзіны з інтэрфейсу карыстальніка: Канфігурацыя.
- Забяспечце першую ўваход Першы ўвод.
- Падключыць мадэль: Мадэлі.