Хуткі старт — AiHummer Дакументацыя

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

Усталюйце AiHummer

Усталёўка пачынаецца ў асабістым кабінеце: зарэгіструйцеся на my.aihummer.ru, адкрыйце экран «Усталёўка» і атрымайце персанальную спасылку ўсталёўкі. Кабінет пакажа гатовую каманду — запусціце яе на серверы праз sudo (усталёўка без root таксама падтрымліваецца — глядзіце Усталёўку):

curl -fsSL "<персанальная спасылка ўсталёўкі>" | sudo bash

Усталёўшчык вызначае вашу архітэктуру, спампоўвае і правярае падпісаны пакет, разгортвае корань усталёўкі і рэгіструе сэрвіс gateway пад systemd. Для поўных дэталяў — персанальная спасылка, каналы рэлізу, выбар сайдкараў, праверка — глядзіце Усталёўку.

Накіруйце на 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;

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

Адкрыйце адмінскі UI

Як толькі сэрвіс падняты, адкрыйце адмінскі UI на серверы:

http://localhost:8781/

На пустой базе даных друкуецца аднаразовы адмінскі пароль. Глядзіце Першы ўваход, як яго атрымаць і неадкладна змяніць.

Падключыце свой першы канал

З адмінскага UI дадайце канал, каб паведамленні маглі дасягаць AiHummer:

Telegram — найбольш гатовы да прадакшэну канектар, з якога варта пачаць.
Вэб-віджэт — самы хуткі спосаб праверыць усё ў браўзеры.
MAX — расійскі месенджар, таксама даступны.

Стварыце свайго першага агента

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

Пагаварыце з агентам проста з адмінскага UI

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

[!TIP] Вы таксама можаце кіраваць AiHummer напрамую праз яго OpenAI-сумяшчальны API без якога-небудзь канала:
POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}
Задайце "stream": true для SSE-стрымінгу.

Майце на ўвазе mock-мадэль

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

[!NOTE] Рэальная мадэль ніколі не патрабуецца: AiHummer працуе на бясплатных/лакальных OpenAI-сумяшчальных канчатковых пунктах і транспарце Codex/ChatGPT-падпіскі. Каб падключыць свайго ўласнага правайдара (BYOK), задайце опцыі канфігурацыі AIHUMMER_LLM_* — гэта апцыянальна. Глядзіце Патрабаванні.

Куды далей

Прадакшэн-разгортванне: Усталёўка.
Наладзьце паводзіны з UI: Канфігурацыя.
Абараніце першы ўваход: Першы ўваход.