AiHummer
Тоҷикӣ
ВоридшавӣКабинети шахсӣ
v1.2.x
{ }Swagger

Оғози зуд

v1.2.x · навсозӣ шуд 2026-07-20

Ин оғози зуд шуморо тавассути аввалин давраи AiHummer мебарад — аз сифр то ҷавоби аввалини агент дар канал. Он барои касе навишта шудааст, ки ин корро анҷом медиҳад бори аввал: ҳар қадам бо анҷом меояд чӣ бояд бинед, ва дар охир бахши “Агар кор накард” вуҷуд дорад.

Аввал, роҳи худро интихоб кунед

Ду роҳ барои гирифтани AiHummer вуҷуд дорад (тақлидҳои пурра дар Муқаддима):

  • Облок — мо серверро идора мекунем, шумо суроғаи омодашударо мегиред. Ҳеҷ чизро насб кардан лозим нест. рав Роҳ A: абр.
  • Меҳмоннавозии худ (сервери худатон) — шумо AiHummer-ро дар сервери Linux-и худ насб мекунед бо як фармон. → ба Роҳи B: сервери худатон.

Сипас ҳар ду роҳ ба қадамҳои умумӣ мепайванданд — агенти аввал ва канали аввал.

Роҳ A: абр

Чӣ лозим аст: суроғаи электронии почта, рақами телефон ва кортҳои бонкӣ (барои озмоиш бонк 1 ₽ талаб мекунад ва онро фавран бармегардонад).

  1. Сабти ном кунед my.aihummer.ruПочтаи электронӣ ва рақами телефонатонро ворид кунед ва рамзи гузариш, ду розигиро қабул кунед. Шумо мебинед тасдиқи ҳисоб намоянда
  2. Ҳисобро тасдиқ кунед — бо занг (рақамҳои охирини шумораи воридшударо ворид кунед) ё бо рамзи аз почтаи электронӣ. Шумо мебинед, ки воридшавӣ ба таври худкор сурат гирифт ва мутахассиси омӯзиши оғоз боз шуд. Тафсилот: Сабти ном ва воридшавӣ.
  3. Дар ҷодугар интихоб кунед Абр масир, пас як нақша (моҳона/солона). Он Нақшаи воридшавӣ бо як Санҷиши ройгони 10-рӯзӣТафсилот: Нақшаҳо.
  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 сабт мекунад. Шумо мебинед сабти қадами насби барнома ва дар охир паёми оғозёбии хизмат. Тафсилоти пурра (каналҳои нашр, сайдкарҳо, насби бе реша): Насб.

Қадам 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. Аввал вуруд кунед

Вақте ки хидмат фаъол шуд, интерфейси веби маъмуриро дар сервер кушоед (порт шахсӣ) :8781 ба таври пешфарз)

http://localhost:8781/

Дар пойгоҳи холии додаҳо воридшавӣ admin офарида мешавад ва рамзи ибтидоӣ навишта мешавад ~/.aihummer/etc/initial-admin-password.txt. Онро хонед, ворид шавед, пас Рамзро иваз кунед ва файлро фавран нест кунед — қадам ба қадам дохил шудан Воридшавии аввал.

Қадам: аввалин агенти худро эҷод кунед

Ин қадам тавассути абрӣ ва худмезбонӣ нақл мешавад. Дар интерфейси маъмури веб кушоед АгентҳоЭҷод карданном гузоред, як шахсияти (фармони системаи) ва, ихтиёрӣ, як модели махсус таъмин кунед. Шумо мебинед агенти нав ҳамчун плитка дар рӯйхат. Тафсилоти пурра, бо танзими ҳунар ва рафтор: Агентҳо.

Қадам: аввалин канали худро пайваст кунед

Барои он ки паёмҳо ба AiHummer расанд, як канал илова кунед:

  • Телеграм — пайвасткунаки омодатарини истеҳсолӣ; роҳнамои пурраи аз оғоз то анҷом “аз BotFather ба паёми аввал” дар дохил аст Телеграм.
  • Сессияҳо дар Web UI — зудтарин роҳ барои санҷидани агент пеш аз пайваст кардан ба як канали берунӣ
  • МАХ — паёмбарии русӣ, низ дастрас аст.

Пайвасткунанда насб шудааст дар Плагинҳо/Бозор нармафзор, пас дар он танзим карда шуд Каналҳо экран, ки дар он Чаҳорчӯбаҳо маҷмӯаҳои блок ки агент кадом каналро идора мекунад. Паёмро ба канал фиристед ва ҷараёни навбатро аз аввали то охир тамошо кунед.

Бо агент бевосита аз интерфейси идорагӣ сӯҳбат кунед

Барои санҷиши аввал канали алоҳида талаб намешавад: дар Сессияҳо Саҳифа тугмаи „Сессияи нав“ ро кушода, бо агент дар дохили Интерфейси идоракунӣ чат мекушояд. Дар композитор шумо метавонед замимакунӣ кардани файлҳо (тасвирҳо ва санадҳо — модел матни гирифташударо қабул мекунад), ва ду гузариш дар боло сатрро нишон медиҳанд хароҷоти ҳар гардиш ва натиҷаи васила — барои дидан он ки агент дар ҳар қадам чӣ кард, муфид аст.

[!TIP] Шумо инчунин метавонед тавассути API-и мувофиқ бо OpenAI ба AiHummer бевосита занг занед канал ба ҳама:

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

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

Гурӯҳ "stream": true барои ҷараёнгириии SSE.

Модели намунавиро ба ёд оред

То даме ки шумо як модели воқеиро пайваст накунед, посухҳо аз як таппиқии ҳалкунанда — барои санҷиши каналҳо, роҳнамоӣ ва агентҳо бе хароҷоти модел муфид. Чӣ тавр пайваст кардани провайдери воқеӣ (OpenAI, Anthropic, YandexGPT, GigaChat, Codex тавассути обунаи ChatGPT ва бештар) дар Моделҳо саҳифа.

[!NOTE] Як модел воқеӣ ҳеҷ гоҳ маҷбурӣ нест: AiHummer дар муҳити озод/ маҳаллӣ кор мекунад Пайвандаҳои мувофиқ бо OpenAI ва интиқоли обунаи Codex/ChatGPT.

Агар кор намекард

  • Фармони насб ноком шуд — тафтиш кунед, ки онро дар Linux x86_64/arm64 иҷро мекунед ва ки пайванди шахсӣ кӯҳнашуда бошад (он 30 рӯз амал мекунад; як пайванди нави онро гиред) Скрин «Насб кунед». Тафтишҳо: Насб.
  • Интерфейси маъмуриятӣ боз намешавад — интерфейси веб дар порти хусусӣ гӯш мекунад :8781, на ҷамъият :8780Хизматрасониро санҷед: systemctl status aihummer-gateway.
  • Ниқоби ибтидоиро наёфтам — он дар дохил аст ~/.aihummer/etc/initial-admin-password.txt, дар сабтҳо нест. Бубинед Воридшавии аввал.
  • Пардохт тавассути абр ноком шуд — ҳолати обуна дар панели идоракунӣ нишон медиҳад сабаб; дубора кӯшиш кунед, ё (барои ширкатҳо) интихоб кунед пардохт бо ҳисоб, бинед Фармоиш ва пардохт.
  • Агент дар як канал ҷавоб намедиҳад — боварӣ ҳосил кунед, ки канал ба як пайванд шудааст агент дар блоки “Bindings”, ва фиристанда ба система маълум аст (аз ҷониби дар ҳолати пешфарз агент танҳо ба корбарони шинос ҷавоб медиҳад, нигаред Каналҳо.

Баъд ба куҷо