AiHummer
Қазақша▾
КіруЖеке кабинет
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Жұмысты бастау/Жылдам бастау

Жылдам бастау

v1.0.x · жаңартылды 2026-07-20

Бұл жылдам бастау сізді алғашқы AiHummer іске қосуыңыз арқылы өткізеді — нөлден бастап бірінші агенттің арнада жауап беруге дейін. Ол осыны істеп жүрген адам үшін жазылған. бірінші рет: әрбір қадам осымен аяқталады не көруің керек, және соңында «Егер жұмыс істемесе» бөлімі бар.

Алдымен жолыңды таңда

AiHummer алу үшін екі жол бар (толық салыстыруда Кіріспе):

  • Бұлт — біз серверді іске қосамыз, сіз дайын мекенжай аласыз. Орнататын ештеңе жоқ. → бару Бағыт A: бұлт.
  • Өз серверіңізде орналастырылған — сіз Linux серверіңізге AiHummer орнатасыз бір пәрменмен. → өту B жолы: сіздің өз серверіңіз.

Содан кейін екі жол да ортақ қадамдарға бірігеді — бірінші агент және бірінші арна.

Бағыт A: бұлт

Сізге қажет нәрселер: электрондық пошта мекенжайы, телефон нөмірі және банктік карта (сынақ үшін банк 1₽ алады және оны дереу қайтарады).

  1. Тіркелу my.aihummer.ru: электрондық поштаңызды, телефоныңызды енгізіңіз және құпиясөз, екі келісімді қабылдаңыз. Сіз көресіз есептік жазбаны растау экран.
  2. Аккаунтты растаңыз — қоңырау арқылы (келіп түскен нөмірдің соңғы цифрларын енгізіңіз) немесе электрондық поштадағы кодпен. Сіз көресіз кіру автоматты түрде орындалды және onboarding шебері ашылды. Мәліметтер: Тіркелу және кіру.
  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 астында тіркейді. Сіз көресіз орнату кезеңінің журналын және соңында қызметтің басталғаны туралы хабарламаны. Толық мәліметтер (жариялау арналары, сайдкарлар, rootless орнату): Орнату.

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. Алғашқы кіру

Қызмет іске қосылғаннан кейін, серверде әкімші Web UI-ын ашыңыз (жеке порт :8781 әдепкі бойынша):

http://localhost:8781/

Бос дерекқорда кіріс admin жасалады және бастапқы құпия сөз жазылады ~/.aihummer/etc/initial-admin-password.txt. Оны оқыңыз, кіріңіз, содан кейін құпиясөзді өзгертіңіз және файлды дереу өшіріңіз — қадам бойынша кіріңіз Бірінші кіру.

Қадам: өзіңіздің алғашқы агентіңізді жасаңыз

Бұл қадам бұлтты және өз тарапынан орналастырылатын нұсқаларда бірдей. Веб әкімші интерфейсінде ашыңыз Агенттер → “+ Жасау”, атын қойыңыз, персонажын (жүйелік нұсқаулық) тағайындаңыз және қажет болса, арнайы модельді қосыңыз. Сіз жаңа агентті тізімде плитка ретінде көресіз. Толық мәлімет, кейіпкер мен мінез-құлықты баптауымен: Агенттер.

Қадам: бірінші арнаңызды қосыңыз

Хабарламалардың AiHummer-ге жетуін қамтамасыз ету үшін канал қосыңыз:

  • Телеграм — ең өндірістікке дайын қосқыш; басынан аяғына дейінгі толық шолу “BotFather-дан алғашқы хабарламаға дейін” осы жерде Телеграм.
  • Веб интерфейсіндегі сессиялар — агентті қосу алдында сынаудың ең жылдам жолы сыртқы арна.
  • МАКС — соқ Ресей хабаршысы, сондай-ақ қолжетімді.

Коннектор орнатылған Плагиндер/Нарық экран, содан кейін бапталды Каналдар экран, онда “Байланыстар” каналды қай агент басқаратындығын блоктар арқылы орнатыңыз. Каналға хабарлама жіберіп, айналымның басынан аяғына дейін қалай өтетінін көріңіз.

Әкімші интерфейсінен тікелей агентпен сөйлесіңіз

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

[!TIP] Сіз AiHummer-ді OpenAI үйлесімді API арқылы да тікелей шақыра аласыз, ешқандай канал мүлде:

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 күнге жарамды; жаңасын алу үшін “Орнату” экраны). Диагностика: Орнату.
  • Әкімші интерфейсі ашылмайды — Веб UI жеке портта тыңдайды :8781, қоғамдық емес :8780. Қызметті тексеріңіз: systemctl status aihummer-gateway.
  • Бастапқы құпиясөзді табу мүмкін болмады — ол ішінде ~/.aihummer/etc/initial-admin-password.txt, журналдарда жоқ. Қараймыз Бірінші кіру.
  • Бұлттық төлем сәтсіз аяқталды — бақылау тақтасындағы жазылу мәртебесі көрсетеді себеп; қайталап көріңіз немесе (компаниялар үшін) шот арқылы төлеуді таңдаңыз, қараңыз Тапсырыс және төлем.
  • Агент арнада жауап бермейді — арнаның біреуіне байланғанына көз жеткізіңіз “Байланыстар” блогындағы агент және жіберуші жүйеге белгілі (арқылы әдепкі бойынша агент тек таныс пайдаланушыларға ғана жауап береді), қараңыз Каналдар.

Келесі қайда