Жылдам бастау — AiHummer Құжаттама

Бұл жылдам бастау AiHummer-дің алғашқы іске қосылуын — орнатудан бастап бірінші агенттің арнада жауап беруіне дейін — баяндайды. Әр қадамның толық мәліметі бар жеке беті бар, жүру барысында сілтемелермен берілген.

AiHummer-ді орнату

Орнату жеке кабинеттен басталады: my.aihummer.ru сайтында тіркеліп, «Орнату» экранын ашыңыз және дербес орнату сілтемесін алыңыз. Кабинет дайын команданы көрсетеді — оны серверде sudo арқылы іске қосыңыз (root-сыз орнату да қолдау табады — Орнату бөлімін қараңыз):

curl -fsSL "<дербес орнату сілтемесі>" | sudo bash

Орнатушы сіздің архитектураңызды анықтайды, қол қойылған буманы жүктеп, тексереді, орнату түбірін орналастырады және шлюз қызметін systemd астында тіркейді. Толық мәлімет үшін — дербес сілтеме, релиз арналары, sidecar таңдау, тексеру — Орнату бөлімін қараңыз.

PostgreSQL-ге бағыттау

Жалғыз қатаң тәуелділік — pgcrypto кеңейтімі қосылған PostgreSQL. Орнатушы дерекқор қосылымын автоматты түрде жалғайды. Егер дерекқорды қолмен орнатсаңыз, 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;

Дерекқор көшірмелері (migrations) іске қосылу кезінде автоматты түрде қолданылады.

Әкімші интерфейсін ашу

Қызмет көтерілгеннен кейін серверде әкімші интерфейсін ашыңыз:

http://localhost:8781/

Бос дерекқорда бір реттік әкімші паролі басып шығарылады. Оны қалай алу және бірден өзгерту туралы Алғашқы кіру бөлімін қараңыз.

Алғашқы арнаңызды қосу

Әкімші интерфейсінен хабарламалар AiHummer-ге жете алуы үшін арна қосыңыз:

Telegram — бастауға ең өндіріске дайын коннектор.
Веб-виджет — бәрін браузерде сынаудың ең жылдам жолы.
MAX — орыс мессенджері, ол да қолжетімді.

Алғашқы агентіңізді жасау

Әкімші интерфейсінде агент жасаңыз: оған персона және қалауыңызша әр агентке арналған модель беріңіз. Маршрутизатор хабарламаларды қайда жіберетінін білуі үшін оны жаңа қосқан арнаға байланыстырыңыз («Арналар» бетіндегі «Байланыстырулар» блогы). Арна арқылы хабарлама жіберіп, кезеңнің басынан аяғына дейін орындалуын бақылаңыз.

Агентпен тікелей админкадан сөйлесіңіз

Алғашқы тексеру үшін арна міндетті емес: «Сессиялар» бетіндегі «+ Жаңа сессия» түймесі агентпен диалогты тікелей админкада ашады. Композерде файлдар тіркеуге болады (суреттер мен құжаттар — модель шығарылған мәтінді алады), ал хат алмасу үстіндегі екі ауыстырғыш қадамдар құнын және құралдар шығысын көрсетуді қосады — агенттің әр қадамда не істегенін көру үшін ыңғайлы.

[!TIP] Сондай-ақ AiHummer-ді кез келген арнасыз тікелей оның OpenAI-үйлесімді API арқылы жүргізе аласыз:
POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}
SSE ағыны үшін "stream": true орнатыңыз.

Mock модельге назар аударыңыз

Сіз нақты модельді жалғағанша, жауаптар детерминистік mock-тан келеді — кез келген модель шығынынсыз арналарды, маршруттауды және агенттерді тексеру үшін пайдалы.

[!NOTE] Нақты модель ешқашан талап етілмейді: AiHummer тегін/жергілікті OpenAI-үйлесімді соңғы нүктелерде және Codex/ChatGPT-жазылым тасымалында жұмыс істейді. Өз провайдеріңізді (BYOK) жалғау үшін AIHUMMER_LLM_* конфигурация параметрлерін орнатыңыз — бұл қосымша. Талаптар бөлімін қараңыз.

Әрі қарай қайда

Өндіріске орналастыру: Орнату.
Интерфейстен мінез-құлықты баптау: Конфигурация.
Алғашқы кіруді қорғау: Алғашқы кіру.