Тез баштоо — 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;

Маалымат базасынын миграциялары иштеп баштаганда автоматтык түрдө колдонулат.

Админ UI’ди ачуу

Кызмат иштеп баштагандан кийин, серверде админ UI’ди ачыңыз:

http://localhost:8781/

Бош маалымат базасында бир жолку админ паролу чыгарылат. Аны кантип алуу жана аны дароо алмаштыруу боюнча Биринчи кирүү караңыз.

Биринчи каналыңызды туташтыруу

Админ UI’ден билдирүүлөр AiHummer’ге жетиши үчүн канал кошуңуз:

Telegram — баштоо үчүн эң продакшнга даяр коннектор.
Веб-виджет — браузерде баарын текшерүүнүн эң тез жолу.
MAX — орус мессенджери, ошондой эле жеткиликтүү.

Биринчи агентиңизди түзүү

Админ UI’де агент түзүңүз: ага персона жана, кааласаңыз, ар бир агентке тиешелүү модель бериңиз. Роутер билдирүүлөрдү кайда жөнөтөрүн билиши үчүн аны жаңы кошкон каналыңызга байлаңыз («Каналдар» барагындагы «Байланыштар» блогу). Канал аркылуу билдирүү жөнөтүп, кезектин баштан аягына чейин иштешин көрүңүз.

Агент менен түз эле админкадан сүйлөшүңүз

Биринчи текшерүү үчүн канал милдеттүү эмес: «Сессиялар» барагындагы «+ Жаңы сессия» баскычы агент менен диалогду түз эле админкада ачат. Композерде файлдарды тиркесе болот (сүрөттөр жана документтер — модель алардан чыгарылган текстти алат), ал эми кат алышуунун үстүндөгү эки которгуч кезектердин наркын жана куралдардын чыгарылышын көрсөтүүнү күйгүзөт — агент ар бир кадамда эмне кылганын көрүү үчүн ыңгайлуу.

[!TIP] Сиз AiHummer’ди эч кандай каналсыз эле анын OpenAI-шайкеш API’си аркылуу түз да башкара аласыз:
POST /v1/chat/completions
Content-Type: application/json

{"model": "default", "messages": [{"role": "user", "content": "Hello"}]}
SSE стриминг үчүн "stream": true коюңуз.

Мак моделге көңүл буруңуз

Чыныгы моделди байланыштырганга чейин жооптор детерминисттик мактан келет — бул каналдарды, багыттоону жана агенттерди эч кандай модель чыгымысыз текшерүү үчүн пайдалуу.

[!NOTE] Чыныгы модель эч качан талап кылынбайт: AiHummer акысыз/локалдык OpenAI-шайкеш эндпойнттордо жана Codex/ChatGPT-жазылуу транспортунда иштейт. Өзүңүздүн камсыздоочуңузду (BYOK) туташтыруу үчүн AIHUMMER_LLM_* конфигурация опцияларын коюңуз — бул кошумча. Талаптар караңыз.

Кийинки кадам

Продакшн жайылтуу: Орнотуу.
Жүрүм-турумду UI’ден ыңгайлоо: Конфигурация.
Биринчи кирүүнү коргоо: Биринчи кирүү.