Аиҿартәара — AiHummer Адокументациа

AiHummer еиҿкаауп анастройка каталог ала, мап аҵаны акырӡыка environment аҽеиҭакрақәа рыла. gateway.env — бутстрап-мацароуп: adatabaza DSN, алисн адресқәеи портқәеи, амастер-ҕац насгьы убас еиԥш. Егьырҭ клавиш зегьы adatabaza аҟны инхоит насгьы аԥсахуеит аадминистраторатә веб UI аҟынтә аусураан ма CLI aihummer settings ала. Иеилаҳаратәу ахԥара мариоуп: зегьы иарҿиатәу иконфигурациоуп Web UI аҟны — env-мацара акымкуа, насгьы харбекуа акымкуа.

Аиалкаара арыӷьара

Каталог анастройка зегьы иалырхуеит аарыӷьара аканы, актәи аиԥшра аиааира агоит:

Adatabaza — админ UI аҟынтә ма aihummer settings set ала иаргылоу аҵакы.
Дефолт — арелиз иадгылоу идкылоу ахарбара.

Environment ари ацепь аҩныҵҟа аԥхьаӡа иҟам — каталог клавишқәа рзы gateway.env аҟны иҟоу AIHUMMER_* аҽеиҭакра иԥырхагам, инаргылазаргьы. Ари аанагоит: анастройка зегь рзы иҟоуп ак-мацара ҵабыргратә алаку — adatabaza — насгьы UI аҵакы environment файл аҟны иԥсахлоу асахьа-ада ашьаҭыртә асҭр ала акгьы ишьогом.

[!NOTE] Апродукшн аҿы аус зуашьа аԥсахразы шәара иашәԥсахуам аиҿартәаратә файлқәа — шәара иашәԥсахуеит анастройка админ UI аҟны (Аиҿкаара → Анастройкақәа, аԥшаара амоу адаҟьа) ма шәхаргылоит aihummer settings set <KEY> <VALUE> (аԥхьаразы get / list), насгьы уи усура иалагоит убри воркспеис азы. Анинсталлер хаҭала иаргылоит каталог алагаратә ахьынӡа adatabaza аҟны aihummer settings set ала.

Hot ма аиаишьҭра ахьаҭаху

Иаԥсаху анастройк шаныбамхо аклавиш иадҳәалоуп:

Аҟазшьа	Аҿырԥштәқәа	Аныԥшра
Hot	хархәартә арацара, суб-агент иреиҳау аҵаулара	Аусураан аҿыц иаԥхьаргылоуп, аиаишьҭра ахымкуа
Аиаишьҭра ахьаҭаху	алисн адрес, иарбоу маҵзурак рымҵаара	Иаасфароуп нанҳәа гейтуэй аиаишьҭра аҿы

Hot аклавишқәа аҿыц иаԥхьаргылоуп, абри аҟынтә хархәартә аиҿкаара ма subagent-depth ариҿартәара иаасфароуп нанҳәа аиҿцәажәара аҿы. Иарбоу аструктуратә клавишқәак иаасфароуп аиаишьҭра ашьҭахь мацара; аадминистраторатә UI иаанарԥшуеит избандуа избан.

Бутстрап аҽеиҭакрақәа env-мацара аанхоит

Аҽеиҭакрақәа маҷк environment аҟны иҟазароуп, избанзар дара иаҭахуп анастройка каталог (насгьы уи иаԥхьоу adatabaza) ахьыҟалатәамгьы. Абри бутстрап аҽеиҭакрақәа env-мацара инхоит насгьы иаанарԥшуам аадминистраторатә UI аҟны:

Аҽеиҭакра	Избанзаалакь бутстрап
`AIHUMMER_DATABASE_URL`	DB иҟазароуп иарбанзаалакь DB-иадгылоу анастройка аԥхьа аԥхьаргылара.
`AIHUMMER_DB_APP_URL`	Иаагоу аамҭа DSN RLS ианаршьуа.
`AIHUMMER_MASTER_KEY`	base64-32 байт; иаартуеит секретқәа-аҿы-аанхара / vault / BYOK.
`AIHUMMER_GATEWAY_ADDR`	Ажәлартә алисн адрес (дефолт `:8780`) — API, аиԥшьара, WS/SSE, аиҵаху насгьы аԥшәыма/pocket прокси.
`AIHUMMER_WEBUI_ADDR`	Априваттә аадмин Web UI алисн адрес (дефолт `:8781`), рут `/` аҟны иаанарԥшуа; иԥырхагаразы `0` иаргыла.
`AIHUMMER_BLOB_DIR`	Блоб/медиа адиректориа афайлтә система аҵанакы — анадыргылараан иаҭахуп.
`AIHUMMER_OIDC_ISSUER`	Иахьчоит `/v1/admin/*` UI идырҵаргьаанӡа.

Убас еиԥш опс-аиасрақәа, ҿырԥштәыс телеметриа OTLP-эндпоинт, абри бутстрап категориахь иацҵоуп. Ари афарӡ-цыԥхьаӡа ахьыҟам зегьы каталог клавишуп: уи adatabaza аҟны инхоит, насгьы уи азы env иԥырхагам.

[!WARNING] AIHUMMER_MASTER_KEY иашәырхьчала насгьы уи резервтә акопиа шәыҟаҵа хазы, adatabaza бэкап аҟынтә аҳасаб. Уи адешифрациа ауеит акредентциатә vault; уи ашьҭыхра иашьаз, изашифрауа секретқәа рныҟәгара ыҟаӡом.

Аиҿартәаратә файл

Хост-нативтә инсталлқәа рзы, бутстрап environment аанхалоуп файл хадак аҟны, уи systemd аиԥшра иаргылоу:

~/.aihummer/etc/gateway.env

Иашәԥсахла абри файл бутстрап ахьынӡа мацара азы, нас иашәиаишьҭ гейтуэй маҵзура аԥсахрақәа рымҵаразы:

# ~/.aihummer/etc/gateway.env (фрагмент)
AIHUMMER_DATABASE_URL=postgres://user:pass@localhost:5432/aihummer
AIHUMMER_MASTER_KEY=base64-32-bytes...
AIHUMMER_GATEWAY_ADDR=:8780
AIHUMMER_WEBUI_ADDR=:8781
AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main

systemctl restart aihummer-gateway

Зегьы абри бутстрап клавишқәа реиҳа иеихгыла — агентцәа, аусхәырҭақәа, агәынҵара режим, агәаанагаратә стратегиақәа, абиуджетқәа, гардреилқәа насгьы егьырҭ — иманаджироуп админ UI анастройкқәа рҟынтә (ма aihummer settings ала), абри файл аҟынтә акымкуа: урҭ клавишқәа рзы env иԥырхагам.

Иалкаау алшарақәа рымҵаара

Алшарақәа рацәак ихпоуп, шәара дара бекинг-маҵзурак рахь шәхарбаанӡа. Абри клавишқәа зегьы каталог анастройкоуп (DB аҟны инхоит): дара иашәыргыла админ UI аҟны (Аиҿкаара → Анастройкақәа) ма CLI ала; gateway.env аҟны идыргылара акгьы ишьуам — урҭ азы env иԥырхагам. Бандл аҟынтә иргылоу сайдкарқәа рзы (STT/TTS убас еиԥш) анинсталлер хаҭала аҵакқәа adatabaza аҟны инанашьоит.

# Иҵабыргу амодель аиасра (иргылам акәзар → детерминистикатә mock)
aihummer settings set AIHUMMER_LLM_PROVIDER openai
aihummer settings set AIHUMMER_LLM_MODEL gpt-4o-mini
aihummer settings set AIHUMMER_LLM_GATEWAY_URL https://api.openai.com/v1

# Аусхәырҭақәа аланашьара, рбекенд рахь ихарбаны
aihummer settings set SEARXNG_URL http://localhost:8888
aihummer settings set CLOAKBROWSER_CDP_URL http://localhost:9222

# Абжьтә сайдкарқәа (STT/TTS анинсталлер хаҭала иаиҿкоит)
aihummer settings set AIHUMMER_STT_URL http://localhost:8001
aihummer settings set AIHUMMER_TTS_URL http://localhost:8002

# Иҵабыргу векторатә арсаи насгьы эмбеддер (ҿырԥштәтә URL-қәа; эмбеддер
# иргылоуп --with-embedder аамҭаз, мамзар агәынҵара лексикатә fallback ахархәоит)
aihummer settings set AIHUMMER_QDRANT_URL http://localhost:6333
aihummer settings set AIHUMMER_EMBEDDER_URL http://localhost:8080

[!TIP] Иҵабыргу амодель аамҭакала иаҭахым. AIHUMMER_LLM_* иргылам акәзар, аҭакқәа аауеит детерминистикатә mock аҟынтә; AiHummer убас еиԥш иусуеит иуруны хәыда/локалтә OpenAI-иадгылоу эндпоинтқәа насгьы Codex/ChatGPT-абонементтә транспорт иахьыла, иалкаау BYOK аманы.

Аарҥәарақәа

Админ UI «Аарҥәарақәа» адаҟьа («Контроль» группа аҵаҟа) — инстанс адырра-фадҭа ауп (админ иалагара, аҿыцра ыҟоуп/ианагӡахьеит, сайдкар аҟалара/аиҭашьақәыргылара насгьы убас еиԥш), акатегориа, ахадарат насгьы иԥхьам ала ифилтртуп. Уи аҵлак — категориа × адәылгаратә канал матрица: акатегориа зегьы азы шәаланашьар шылшоит webui, email, telegram насгьы push аканалқәа. Webui арҥәарақәа локалла иадгалоуп; Telegram «Telegram аидҳәалара» батон ала иадҳәалоуп (deep link), email асаппорт адрес аныхьчаз иалагоит аусура, push мобилтә аплагали иаауеит. Иасоу арҥәарақәа webui аканал аҿы аԥхьам ргылара ыҟаӡам.

Иахьынтә ашьҭахь

Иашәырхьчала аадминистраторатә логин: Актәи алогин.
Иахьынтә афайлқәа аанхо: Аинсталл.
Иашәырба ахьеилагалатәу: Аҭахрақәа.