Тохиргоо
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 |
Вэб самбар, апп болон сувгууд серверийн нэг нийтийн хаягийг ашиглана. Суулгагчийн харуулсан нийтийн хаягийг нээнэ үү; дотоод анхдагч хаяг нь http://localhost:8780/. Суулгах үед сонгосон порт өөр байж болно. |
AIHUMMER_WEBUI_ADDR |
AIHUMMER_WEBUI_ADDR нь эхний тохиргооны нийцэлд зориулсан, зөвхөн loopback дээрх нэмэлт оператор сонсогч; анхдагч нь 127.0.0.1:8781. Энэ нь самбарын тусдаа гадаад хаяг биш; 0 хүчингүй. AIHUMMER_WEBUI_ENABLED=false нь хоёр сонсогч дээр самбарыг унтраана. |
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=127.0.0.1:8781
AIHUMMER_OIDC_ISSUER=https://idp.example/realms/main
systemctl restart aihummer-gateway
Эдгээр эхлүүлэх түлхүүрүүдээс гаднах бүх зүйл — агентууд, хэрэгслүүд, санах ой горим, бодох стратегиуд, төсөв, хамгаалалтын хязгаарлалтууд болон бусад — администраторын UI-ийн тохиргооноос (эсвэл дамжуулан) удирдлагад ордог aihummer settings), эдгээр түлхүүрүүдэд env-н утгыг орхигдуулна, энэ файлаас биш.
Утасны сонголттой боломжууд
Олон боломжууд нь дэмжлэг үзүүлэх үйлчилгээ рүү чиглүүлт хийх хүртэл унтарсан байдаг. Эдгээр бүх түлхүүрүүд нь каталогийн тохиргоо юм (тэдгээр нь өгөгдлийн сан руу байрладаг): админ UI-д тохируулна уу (Менежмент → Тохиргоо) эсвэл CLI-тэй; тэдгээрийг байрлуулж gateway.env юу ч хийхгүй — тэдэнд env нь үл тоомсорлогддог. Багц (STT/TTS гэх мэт) суулгасан сайдкаруудын хувьд суулгагч нь утгуудыг өөрөө өгөгдлийн санд оруулдаг.
# Ажиллах хариулт авахын тулд жинхэнэ загварын үйлчилгээ үзүүлэгч холбоно уу.
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] Ажиллах хариулт авахын тулд жинхэнэ загварын үйлчилгээ үзүүлэгч холбоно уу. Төлбөртэй API түлхүүр заавал хэрэггүй: дотоод OpenAI-тай нийцсэн загвар, дэмжигдсэн захиалга эсвэл өөрийн API түлхүүрийг ашиглаж болно. Үйлчилгээ үзүүлэгч тохируулаагүй бол дараах алдаа гарна:
Одоохондоо хиймэл оюун ухааны загвар нийлүүлэгчийг тохируулаагүй байна — Загвар хэсэгт нэгийг нэмнэ үү
Мэдэгдэл
Админ UI-ийн Мэдэгдэл хуудас (“Удирдлага” дор) нь тухайн жишээний үйл явдлын ил захидал (админ нэвтрэлт, шинэчлэлт боломжтой/хийгдсэн, сайдкар унтарсан буюу сэргээж буй болон бусад) бөгөөд ангилал, ноцтой байдал, уншаагүйгээр шүүлт хийж болно. Үүний хажууд нь байрладаг ангилал × хүргэх-сувагын матриц: та идэвхжүүлж буй үйл явдлын ангилал бүрт веб интерфейс, имэйл, телеграм болон түлхэх суваг. Веб UI мэдэгдлүүдийг орон нутгийн түвшинд хүргэдэг; Telegram нь “Link Telegram” товчоор (гүн холбоос) холбогддог, имэйл дэмжлэгийн хаягийг баталгаажуулсны дараа идэвхэждэг, push мэдэгдэл нь гар утасны апп-д ирдэг. Чухал үйл явдлуудыг веб UI сувгаар дуугүй болгох боломжгүй.
Дараа хаашаа явах вэ
- Админ нэвтрэх эрхийг хаах: Эхний нэвтрэлт.
- Файлууд хаана хадгалагдсан байгааг харах: Суулгах.
- Шаардлагуудыг шалгаарай: Шаардлагууд.