Тохиргоо — AiHummer Баримт бичиг

AiHummer нь дамжин тохируулагддаг тохиргооны каталог, орчны хувьсагчуудын овоолго биш. gateway.env Энэ зөвхөн bootstrap: DSN мэдээллийн сан, сонсох хаяг/порт, мастер түлхүүр гэх мэт. Бусад бүх түлхүүр мэдээллийн сангийн дотор оршиж, вэб админ UI-аас ажиллаж байх үед эсвэл ашиглан өөрчилдөг aihummer settings CLI. Удирдах дүрэм энгийн: вэб интерфэйс дээр бүх тохируулж болох зүйл тохируулгатай байдаг — зөвхөн орчны хувьсагч биш, бас кодонд хатуу бичигдсэн биш.

Шийдвэрлэх дараалал

Бүх каталогын тохиргоо нэгэн ижил аргаар шийдэгддэг, эхний тааралт ялна:

Өгөгдлийн сан — админ UI-гаар дамжуулан тохируулсан утга эсвэл aihummer settings set.
Анхдагч — гаргасан хувилбарын хамт багтсан дотоод өнгөц тохиргоо.

Орчинд байдал нь зориудаар энэ гинжний хэсэг биш: каталогийн түлхүүрүүдэд AIHUMMER_* өөрчлөгч дотор gateway.env Энэ үл тоомсорлосон, бүр тогтоосон ч гэсэн. Энэ нь тус бүр тохиргоонд яг нэг л үнэн эхийг — өгөгдлийн сантай — өгч байгаа бөгөөд ингэснээр UI утга нь орхигдсон env файлын мөрөөр ч нам гүмээр далдлагдах боломжгүй болно.

[!NOTE] Үйлдвэрлэлд зан үйлээ өөрчлөхдөө та тохиргооны файлуудыг засварладаггүй — та өөрийгөө өөрчилдөг админ UI-д тохиргоо (Менежмент → Тохиргоо, хайлтаар орох боломжтой хуудас) эсвэл ажиллуулна aihummer settings set <KEY> <VALUE> (get / list уншихад), мөн энэ нь авдаг тэр ажлын орчинд нөлөөлнө. Суулгагч нь анхны каталогийн утгуудыг суулгадаг өгөгдлийн санд дамжуулан aihummer settings set.

Халуун ба дахин ачааллах шаардлагатай

Өөрчлөгдсөн тохиргоо хэрхэн үйлчилж эхлэх нь түлхүүрээс хамаарна:

Зан байдал	Жишээнүүд	Хэзээ хэрэглэх вэ
Халуун	багажийг идэвхжүүлэх, дэд агентын хамгийн их гүн	Гүйцэтгэл явж байх үед дахин уншина, дахин эхлүүлэх шаардлагагүй
Дахин ачаалах шаардлагатай	хуурцаг хаяг сонсох, тодорхой үйлчилгээний утас холбоо	Дараагийн гарц дахин асаахад хэрэглэгдсэн

Халуун товчлуурууд амьд үед дахин уншигддаг тул хэрэгслийг солих эсвэл тохиргоог өөрчлөх subagent-depth дараагийн эргэлтэд нөлөө үзүүлдэг. Зарим бүтэцийн түлхүүрүүд зөвхөн дахин ачаалахад хүчинтэй болдог; админ UI аль нь аль болохыг заадаг.

Bootstrap хувьсагчид зөвхөн орчны хэмжээнд үлддэг

Тохиргооны толь бичиг (болон түүнээс уншдаг өгөгдлийн сан) үүсэхээс өмнө шаардлагатай байдаг учраас байгаль орчинд хэд хэдэн хувьсагч байх ёстой. Эдгээр бутстрап хувьсагчид зөвхөн орчны хувилбар бөгөөд удирдлагын интерфэйс дээр ил гардаггүй:

Хувьсах	Яагаад энэ нь бутстрэп вэ
`AIHUMMER_DATABASE_URL`	Өгөгдлийн сан нь ямар ч өгөгдлийн сантай холбоотой тохиргоог уншихаас өмнө оршин байх ёстой.
`AIHUMMER_DB_APP_URL`	RLS-г идэвхжүүлэх хязгаарлагдмал үүрэгтэй DSN.
`AIHUMMER_MASTER_KEY`	base64-32 байт; амар амгалан байгаа нууцыг нээнэ / сан / BYOK.
`AIHUMMER_GATEWAY_ADDR`	Олон нийтийн сонсох хаяг (урьдчилсан тохиргоо) `:8780`) — API, хослол, WS/SSE, орж ирэх болон апп/цүнх прокси.
`AIHUMMER_WEBUI_ADDR`	Хувийн захиргаа Web UI сонсох хаяг (анхдагч) `:8781`), үндсэнд үйлчилсэн `/`; тохируулсан `0` унтраах
`AIHUMMER_BLOB_DIR`	Blob/медиа директорыг файл системийн зам — ачаалах үед шаардагдана.
`AIHUMMER_OIDC_ISSUER`	Хамгаалдаг `/v1/admin/*` UI итгэл үзүүлэхээс өмнө.

Телеметрийн OTLP төгсгөлийн цэг гэх мэт Ops утаслалтууд нь ижил эхлүүлэгч ангилалд ордог. Энэ богино жагсаалтад багтсан зүйлгүй бол бүгд каталогийн түлхүүр юм: энэ нь өгөгдлийн сан дахь амьдралтай, env-д анхаардаггүй.

[!WARNING] Хадгалах AIHUMMER_MASTER_KEY аюулгүй ба нөөцлөгдсөн тусгаарлан таны өгөгдлийн сангаас нөөц. Энэ нь нэвтрэх бичиг баримтын сейфийг тодоорхойлдог; үүнийг алдвал шифрлэсэн нууцыг алдана эргүүлэн авах боломжгүй.

Тохиргооны файл

Хост-дотоод суулгалтуудын хувьд, bootstrap орчин нь systemd нэгжээр ачаалдаг нэг файлд байдаг:

~/.aihummer/etc/gateway.env

Энэ файлыг засах зөвхөн бутстрап утгуудын хувьд, дараа нь өөрчлөлтүүдийг хэрэгжүүлэхийн тулд gateway үйлчилгээг дахин эхлүүлнэ:

# ~/.aihummer/etc/gateway.env (excerpt)
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-н утгыг орхигдуулна, энэ файлаас биш.

Утасны сонголттой боломжууд

Олон боломжууд нь дэмжлэг үзүүлэх үйлчилгээ рүү чиглүүлт хийх хүртэл унтарсан байдаг. Эдгээр бүх түлхүүрүүд нь каталогийн тохиргоо юм (тэдгээр нь өгөгдлийн сан руу байрладаг): админ UI-д тохируулна уу (Менежмент → Тохиргоо) эсвэл CLI-тэй; тэдгээрийг байрлуулж gateway.env юу ч хийхгүй — тэдэнд env нь үл тоомсорлогддог. Багц (STT/TTS гэх мэт) суулгасан сайдкаруудын хувьд суулгагч нь утгуудыг өөрөө өгөгдлийн санд оруулдаг.

# Wire a real model (unset → deterministic 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

# Enable tools by pointing at their backends

# Voice sidecars (STT/TTS auto-configured by the installer)
aihummer settings set AIHUMMER_STT_URL http://localhost:8001
aihummer settings set AIHUMMER_TTS_URL http://localhost:8002

# Real vector store + embedder (example URLs; the embedder is installed with
# --with-embedder, otherwise memory uses the lexical fallback)
aihummer settings set AIHUMMER_QDRANT_URL http://localhost:6333
aihummer settings set AIHUMMER_EMBEDDER_URL http://localhost:8080

[!TIP] Жинхэнэ загвар огт шаардлагатай биш. Үгүй бол AIHUMMER_LLM_* утасласан, хариу ирнэ тодорхойлогдсон дууриамлын хувилбаас; AiHummer мөн үнэгүй/орон нутгийн OpenAI-тэй нийцсэн дээр ажиллана төгсгөлийн цэгүүд болон Codex/ChatGPT-г захиалгаар дамжуулах, хүссэн тохиолдолд BYOK-той.

Мэдэгдэл

Админ UI-ийн Мэдэгдэл хуудас (“Удирдлага” дор) нь тухайн жишээний үйл явдлын ил захидал (админ нэвтрэлт, шинэчлэлт боломжтой/хийгдсэн, сайдкар унтарсан буюу сэргээж буй болон бусад) бөгөөд ангилал, ноцтой байдал, уншаагүйгээр шүүлт хийж болно. Үүний хажууд нь байрладаг ангилал × хүргэх-сувагын матриц: та идэвхжүүлж буй үйл явдлын ангилал бүрт веб интерфейс, имэйл, телеграм болон түлхэх суваг. Веб UI мэдэгдлүүдийг орон нутгийн түвшинд хүргэдэг; Telegram нь “Link Telegram” товчоор (гүн холбоос) холбогддог, имэйл дэмжлэгийн хаягийг баталгаажуулсны дараа идэвхэждэг, push мэдэгдэл нь гар утасны апп-д ирдэг. Чухал үйл явдлуудыг веб UI сувгаар дуугүй болгох боломжгүй.

Дараа хаашаа явах вэ

Админ нэвтрэх эрхийг хаах: Эхний нэвтрэлт.
Файлууд хаана хадгалагдсан байгааг харах: Суулгах.
Шаардлагуудыг шалгаарай: Шаардлагууд.