Оғози зуд — AiHummer Ҳуҷҷатнигорӣ

Ин оғози зуд аз иҷрои аввали AiHummer мегузарад — аз насб то аввалин агенте, ки дар канал ҷавоб медиҳад. Ҳар як қадам саҳифаи махсуси худро бо тафсилоти пурра дорад, ки дар ҳол пайванд карда мешавад.

AiHummer-ро насб кунед

Насб дар кабинети шахсӣ оғоз меёбад: дар my.aihummer.ru сабти ном кунед, экрани «Насб»-ро кушоед ва пайванди шахсии насб гиред. Кабинет фармони тайёрро нишон медиҳад — онро дар сервер тавассути sudo иҷро кунед (насб бе root низ дастгирӣ мешавад — нигаред ба Насб):

curl -fsSL "<пайванди шахсии насб>" | sudo bash

Насбкунанда меъмории шуморо муайян мекунад, бастаи имзошударо зеркашӣ ва тасдиқ мекунад, решаи насбро мерезонад ва хидмати gateway-ро дар зери systemd сабт мекунад. Барои тафсилоти пурра — пайванди шахсӣ, каналҳои релиз, интихоби sidecar-ҳо, тасдиқ — ба Насб нигаред.

Ба 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;

Migration-ҳои пойгоҳи додаҳо ҳангоми оғоз ба таври худкор татбиқ карда мешаванд.

Интерфейси маъмуриро кушоед

Пас аз он ки хидмат боло меравад, интерфейси маъмуриро дар сервер кушоед:

http://localhost:8781/

Дар пойгоҳи додаҳои холӣ пароли яккаратаи маъмур чоп карда мешавад. Барои чӣ тавр бозёбӣ ва фавран тағйир додани он ба Воридшавии аввал нигаред.

Аввалин каналро пайваст кунед

Аз интерфейси маъмурӣ, як канал илова кунед, то паёмҳо ба AiHummer расанд:

Telegram — омодатарин коннектори истеҳсолӣ барои оғоз.
Виҷети веб — зудтарин роҳ барои санҷидани ҳама чиз дар браузер.
MAX — паёмрасони русӣ, инчунин дастрас.

Аввалин агенти худро созед

Дар интерфейси маъмурӣ, як агент созед: ба он персона ва ба таври ихтиёрӣ модели ҳар як агент диҳед. Онро ба канале, ки шумо ҳозир илова кардед, пайваст кунед (блоки «Пайвандҳо» дар саҳифаи «Каналҳо»), то router донад, ки паёмҳоро ба куҷо фиристад. Тавассути канал паём фиристед ва тамошо кунед, ки навбат аз аввал то охир иҷро мешавад.

Бо агент бевосита аз интерфейси маъмурӣ гап занед

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

[!TIP] Шумо инчунин метавонед AiHummer-ро бевосита тавассути API-и бо OpenAI мутобиқи он бе ягон канал идора кунед:
POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}
Барои stream-кунии SSE "stream": true-ро танзим кунед.

Ба модели mock диққат диҳед

То он даме, ки шумо модели воқеиро васл кунед, ҷавобҳо аз mock-и детерминистӣ меоянд — барои тасдиқи каналҳо, роҳнамоӣ (routing) ва агентҳо бе ягон хароҷоти модел муфид аст.

[!NOTE] Модели воқеӣ ҳеҷ гоҳ талаб карда намешавад: AiHummer дар нуқтаҳои интиҳоии ройгон/маҳаллии бо OpenAI мутобиқ ва интиқоли обунаи Codex/ChatGPT кор мекунад. Барои пайваст кардани провайдери худ (BYOK), имконоти танзимоти AIHUMMER_LLM_*-ро танзим кунед — ин ихтиёрӣ аст. Ба Талабот нигаред.

Минбаъд ба куҷо

Ҷойгиркунии истеҳсолӣ: Насб.
Рафторро аз интерфейс танзим кунед: Танзимот.
Воридшавии аввалро бехатар кунед: Воридшавии аввал.