კონფიგურაცია

~/.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

# დააკავშირეთ რეალური მოდელი (დაუყენებელი → დეტერმინისტული 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

# ხმოვანი sidecar-ები (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

AiHummer კონფიგურირდება **პარამეტრების კატალოგით**, არა გარემოს ცვლადების გროვით. `gateway.env` — **მხოლოდ ჩატვირთვისთვის**: ბაზის DSN, მოსასმენი მისამართები/პორტები, master-გასაღები და მისთანანი. დანარჩენი ყველა გასაღები ცხოვრობს მონაცემთა ბაზაში და იცვლება ვებ ადმინ UI-დან გაშვების მომენტში ან CLI-ით `aihummer settings`. წამყვანი წესი მარტივია: **ყველაფერი გასაწყობი კონფიგურირებადია Web UI-ში** — არა მხოლოდ-env და არა მყარად ჩაკოდილი. ## გადაწყვეტის თანმიმდევრობა კატალოგის ყოველი პარამეტრი წყდება ერთი და იმავე თანმიმდევრობით, პირველი დამთხვევა იმარჯვებს: 1. **მონაცემთა ბაზა** — მნიშვნელობა, დაყენებული ადმინ UI-დან ან `aihummer settings set`-ით. 2. **ნაგულისხმევი** — ჩაშენებული ნაგულისხმევი, რომელიც გამოშვებასთან ერთად მოდის. გარემო **განზრახ არ მონაწილეობს** ამ ჯაჭვში: კატალოგის გასაღებებისთვის `AIHUMMER_*` ცვლადი `gateway.env`-ში **იგნორირდება**, თუნდაც ის დაყენებული იყოს. ეს ნიშნავს, რომ ყოველ პარამეტრს ერთადერთი წყარო აქვს — მონაცემთა ბაზა — და UI-დან დაყენებული მნიშვნელობა ვერასოდეს დაიფარება env-ფაილში დავიწყებული ხაზით. > [!NOTE] > წარმოებაში ქცევის შესაცვლელად თქვენ არ ჩასწორებთ კონფიგურაციის ფაილებს — > თქვენ ცვლით პარამეტრს ადმინ UI-ში (**მართვა → პარამეტრები**, ძებნადი > გვერდი) ან უშვებთ ბრძანებას `aihummer settings set <KEY> <VALUE>` > (`get` / `list` — წასაკითხად), და ცვლილება ძალაში შედის ამ სამუშაო > სივრცისთვის. ინსტალერი თავადვე თესავს კატალოგის საწყის მნიშვნელობებს ბაზაში > `aihummer settings set`-ის მეშვეობით. ## ცხელი vs გადატვირთვა-საჭირო როგორ შედის ძალაში შეცვლილი პარამეტრი, დამოკიდებულია გასაღებზე: | ქცევა | მაგალითები | როდის გამოიყენება | |---|---|---| | **ცხელი** | ხელსაწყოს ჩართვა, ქვე-აგენტის მაქს. სიღრმე | ხელახლა იკითხება გაშვების მომენტში, გადატვირთვის გარეშე | | **გადატვირთვა-საჭირო** | მოსასმენი მისამართი, ზოგიერთი სერვისის დაკავშირება | გამოიყენება gateway-ის შემდეგ გადატვირთვაზე | ცხელი გასაღებები ხელახლა იკითხება ცოცხლად, ასე რომ ხელსაწყოს გადართვა ან `subagent-depth`-ის რეგულირება ძალაში შედის შემდეგ სვლაზე. ზოგიერთი სტრუქტურული გასაღები ძალაში შედის მხოლოდ გადატვირთვის შემდეგ; ადმინ UI მიუთითებს, რომელია რომელი. ## ჩატვირთვის ცვლადები რჩება მხოლოდ-env რამდენიმე ცვლადი უნდა იყოს გარემოში, რადგან ისინი საჭიროა, ვიდრე პარამეტრების კატალოგი (და მონაცემთა ბაზა, საიდანაც ის კითხულობს) საერთოდ გაჩნდება. ეს **ჩატვირთვის** ცვლადები მხოლოდ-env არის და არ ჩანს ადმინ UI-ში: | ცვლადი | რატომ არის ჩატვირთვისა | |---|---| | `AIHUMMER_DATABASE_URL` | DB უნდა არსებობდეს, ვიდრე DB-ზე დაფუძნებული ნებისმიერი პარამეტრის წაკითხვა შესაძლებელია. | | `AIHUMMER_DB_APP_URL` | შეზღუდული როლის DSN, რომელიც ააქტიურებს RLS-ს. | | `AIHUMMER_MASTER_KEY` | base64-32 ბაიტი; ხსნის საიდუმლოებს-მოსვენებაში / ვალტს / 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 სანდო გახდება. | იმავე ჩატვირთვის კატეგორიას ეკუთვნის ისეთი ops-პროვოდკაც, როგორიცაა ტელემეტრიის OTLP-ბოლოწერტილი. ყველაფერი, რაც ამ მოკლე სიაში არაა, — კატალოგის გასაღებია: ის ცხოვრობს ბაზაში და env მისთვის იგნორირდება. > [!WARNING] > შეინახეთ `AIHUMMER_MASTER_KEY` უსაფრთხოდ და გააკეთეთ მისი სარეზერვო ასლი > **ცალკე** თქვენი მონაცემთა ბაზის სარეზერვო ასლისგან. ის შიფრავს > რწმუნებების ვალტს; დაკარგეთ ის — და დაშიფრული საიდუმლოები ვერ აღდგება. ## კონფიგურაციის ფაილი ჰოსტ-მშობლიური ინსტალაციებისთვის, ჩატვირთვის გარემო ცხოვრობს ერთ ფაილში, რომელსაც systemd ერთეული ტვირთავს: ```text ~/.aihummer/etc/gateway.env ``` ჩაასწორეთ ეს ფაილი **მხოლოდ ჩატვირთვის მნიშვნელობებისთვის**, შემდეგ გადატვირთეთ gateway სერვისი ცვლილებების გამოსაყენებლად: ```ini # ~/.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 ``` ```bash systemctl restart aihummer-gateway ``` ყველაფერი ამ ჩატვირთვის გასაღებების მიღმა — აგენტები, ხელსაწყოები, მეხსიერების რეჟიმი, მსჯელობის სტრატეგიები, ბიუჯეტები, დამცავი ბარიერები და დანარჩენი — იმართება ადმინ UI-ის პარამეტრებიდან (ან `aihummer settings`-ით), არა ამ ფაილიდან: env ასეთი გასაღებებისთვის იგნორირდება. ## არასავალდებულო შესაძლებლობების დაკავშირება ბევრი ფუნქცია გამორთულია, ვიდრე მათ backing-სერვისზე არ მიუთითებთ. ეს ყველა გასაღები — კატალოგის პარამეტრებია (ცხოვრობენ ბაზაში): დააყენეთ ისინი ადმინ UI-ში (**მართვა → პარამეტრები**) ან CLI-ით; `gateway.env`-ში ჩაწერას აზრი არ აქვს — env მათთვის იგნორირდება. ბანდლიდან დაინსტალირებული sidecar-ებისთვის (STT/TTS და ა.შ.) ინსტალერი თავად სეავს მნიშვნელობებს ბაზაში. ```bash # დააკავშირეთ რეალური მოდელი (დაუყენებელი → დეტერმინისტული 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 # ხმოვანი sidecar-ები (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-ის გვერდი **«შეტყობინებები»** (ჯგუფში «კონტროლი») არის ინსტანსის მოვლენების ინბოქსი (ადმინის შესვლა, ხელმისაწვდომი/გამოყენებული განახლება, sidecar-ის ჩავარდნა ან აღდგენა და ა.შ.) კატეგორიის, სიმძიმისა და წაუკითხავის მიხედვით ფილტრით. გვერდზევე — **კატეგორია × მიწოდების-არხის** მატრიცა: ყოველი მოვლენის კატეგორიისთვის ირთვება არხები **webui**, **email**, **telegram** და **push**. Web UI შეტყობინებები მიწოდდება ლოკალურად; Telegram მიბმულია ღილაკით «Telegram-ის მიბმა» (deep link), ელფოსტა აქტიურდება მხარდაჭერის მისამართის დადასტურების შემდეგ, ხოლო push მოდის მობილურ აპლიკაციაში. კრიტიკული მოვლენების დადუმება webui-არხზე შეუძლებელია. ## სად შემდეგ - დაბლოკეთ ადმინ შესვლა: [პირველი შესვლა](/ka/v1.0/getting-started/first-login). - ნახეთ, სად ცხოვრობს ფაილები: [ინსტალაცია](/ka/v1.0/getting-started/installation). - შეამოწმეთ წინაპირობები: [მოთხოვნები](/ka/v1.0/getting-started/requirements).