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

~/.aihummer/etc/gateway.env

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

# 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

AiHummer ეწყობა მეშვეობით **კონფიგურაციის კატალოგი**, და არა გარემოს მრავალი ცვლადები. `gateway.env` არის **მხოლოდ bootstrap**: DSN მონაცემთა ბაზა, მოსასმენად მისამართები/პორტები, მთავარი საკვანძო და მსგავსი. სხვა ყველა საკვანძო მდებარეობს მონაცემთა ბაზაში და იცვლება ადმინისტრატორის ვებსაიტის ინტერფეისიდან მუშაობის პერიოდში ან გამოყენებით `aihummer settings` CLI. ძირითადი წესი მარტივია: **ყველა კონფიგურირებადი შეიძლება კონფიგურირდეს ვებ-ინტერფეისის საშუალებით** — არა მხოლოდ გარემოს ცვლადების საშუალებით და არ არის ჰარდკოდირებული. ## ნებადართულია წესრიგი ყოველი საქაღალდის კონფიგურაცია აღინიშნება ერთიდაიგივედ: ყველაზე პირველი შესაბამისობა იგებს: 1. **მონაცემთა ბაზა** — მნიშვნელობა, ადმინისტრატორის ინტერფეისის საშუალებით ნიშანდებული, ან `aihummer settings set`. 2. **ნაგულისხმევი** — ჩაშენებული სტანდარტულად, გამოდის გამოშვებისთანავე. გარემო ერღვება **გონებით არ შედის ამ ჯაჭვში**: კატალოგის გასაღებისთვის `AIHUMMER_*` ცვლადი ვში `gateway.env` არის **გაუთვალისწინებელი**, მაშინაც კი, თუ ეს განსაზღვრულია. ეს თითოეულ პარამეტრს უთმობს სწორი წყაროს მხოლოდ ერთს — მონაცემთა ბაზას — ასე რომ ინტერფეისში მნიშვნელობა არასდროს დაიფარება დავიწყებული სტრიქონით გარემოს ფაილში. > [!NOTE] > პროდუქშენში ქცევის შესაცვლელად, თქვენ არ ცვლილებთ კონფიგურაციის ფაილებს — თქვენ ცვლით > კონფიგურაცია ადმინისტრაციულ ინტერფეისში (**მართვა → პარამეტრები**, საძიებო გვერდი) ან ჩართვა > `aihummer settings set <KEY> <VALUE>` (`get` / `list` კითხვის), და ეს ეყოფა > ეფექტი ამ სამუშაო სივრცისთვის. თავად ინსტალატორი აკეთებს დირექტორიის საწყის მნიშვნელობებზე დაყენებას > მონაცემთა ბაზაში საშუალებით `aihummer settings set`. ## ცხელი ვერსია vs ხელახლა დაწყება საჭიროა თვით, როგორ შეიცვლება პარამეტრების ცვლილება, დამოკიდებულია კლავიშზე: | მოძრაობა | მაგალითები | როდის გამოიყენება | |---|---|---| | **ცხელი** | ინსტრუმენტის ჩართვა, აგენტის მაქსიმალური სიღრმე | გააკეთეთ ხელახლა კითხვას შესრულების დროს, არანაირი გადატვირთვა | | **გჭირდებათ გადატვირთვა** | მოსასმენი მისამართი, გარკვეული სერვისების შესრულება | გამოყენდება შემდეგი გაჯეტის გადატვირთვის დროს | ცხელი კლავიშები გადამოწმდება რეალურ დროში, ამიტომ ინსტრუმენტის გადართვა ან პარამეტრების შეცვლა `subagent-depth` მოქმედებაში შედის შემდეგი ჰოდისას. ზოგი სტრუქტურული გასაღები მოქმედებაში შედის მხოლოდ გადატვირთვის შემდეგ; ადმინისტრატორის ინტერფეისი მიუთითებს, რომელი რომელია. ## Bootstrap-ს ცვლადები რჩება მხოლოდ გარემოში ზოგიერთი ცვლადი უნდა იყოს გარემოში, რადგან ისინი საჭიროა იმაზე ადრე, ვიდრე არსებობს კონფიგურაციის კატალოგი (და მონაცემთა ბაზა, რომელშიც ეს კითხულობს). ეს **ჩატვირთვის** ცვლადები ხელმისაწვდომია მხოლოდ გარემოში და არ ჩანს ადმინისტრაციულ ინტერფეისში: | ცვლადი | რატომ არის ეს bootstrap | |---|---| | `AIHUMMER_DATABASE_URL` | მონაცემთა ბაზა უნდა არსებობდეს იმაში, სანამ შესაძლებელი იქნება ნებისმიერი კონფიგურაციის წაკითხვა, რომელიც დამოკიდებულია მონაცემთა ბაზაზე. | | `AIHUMMER_DB_APP_URL` | შეზღუდული როლი DSN, რომელიც აქტივირებს RLS. | | `AIHUMMER_MASTER_KEY` | base64-32 ბაიტი; აღადგენს საიდუმლოებებს ყოფნის მდგომარეობაში / შესანახად / BYOK. | | `AIHUMMER_GATEWAY_ADDR` | საზოგადოებრივი მოსმენითი მისამართი (ნაგულისხმევად `:8780`) — API, კავშირი, WS/SSE, შემომავალი და პროქსი აპლიკაციის/საფულისთვის. | | `AIHUMMER_WEBUI_ADDR` | ვებ-ადმინისტრატორის ინტერფეისის კერძო მოსმენის მისამართი (სტანდარტულად) `:8781`), მიიღება ძირითადი კატალოგში `/`; დააყენე წინა `0` გათიშვა. | | `AIHUMMER_BLOB_DIR` | ბლოგ/მედია კატალოგის ფაილური სისტემის გზა საჭიროებს ატვირთვისას. | | `AIHUMMER_OIDC_ISSUER` | იცავს `/v1/admin/*` მინიატიურისინდე სანამ მომხმარებლის ინტერფეისი სანდო იქნება. | Ops-ის ასეთი ტრანსმისია, როგორც OTLP ტელემეტრიის ბოლო წერტილი, ყოველთვის ერთ კატეგორიაში მოხვდება. ყველაფერი, რაც ამ მოკლე ჩამონათვალში არ შედის, კატალოგის გასაღებია: იგი ინახება ბაზაში და მისთვის გარემოს ცვლადი იგნორირებულია. > [!WARNING] > დაჭერა `AIHUMMER_MASTER_KEY` უსაფრთხოდ და რეზერვული კოპიით **მიჯნულად** თქვენი მონაცემთა ბაზიდან > შენახვის ასლი. ეს ახსნის ავტორიზაციის მონაცემთა საცავს; დაკარგეთ იგი, და დაშიფრული საიდუმლოებები > არ შეიძლება აღდგეს. ## კონფიგურაციის ფაილი ჰოსტზე ნატიური ინსტალაციებისთვის, bootstrap გარემო მდებარეობს ერთ ფაილში, რომელიც იტვირთავს systemd ერთეულს: ```text ~/.aihummer/etc/gateway.env ``` გააახლებთ ამ ფაილს **მხოლოდ ბუსტრაპის მნიშვნელობებისთვის**, შემდეგ ჩართეთ გაჯეტის სერვისი ცვლილებების შესატანად: ```ini # ~/.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 ``` ```bash systemctl restart aihummer-gateway ``` ყველაფერი, რაც ამ საწყის გასაღებებს სცდება — აგენტები, ინსტრუმენტები, მეხსიერების რეჟიმი, დებულებების სტრატეგიები, ბიუჯეტები, შეზღუდვები და სხვა — კონტროლდება ადმინისტრატორის ინტერფეისის საშუალებით (ან საშუალებით `aihummer settings`), არა ამ ფაილიდან: env იგნორირებულია ამ საკვების შემთხვევაში. ## დამატებითი ფუნქციების ჩართვა ბევრი ფუნქცია გამორთულია, სანამ მათ მხარდაჭერის სერვისს არ გაუთვალისწინებთ. ეს ყველა გასაღები კატალოგის პარამეტრებია (მათ მონაცემთა ბაზაში ინახავენ): დააყენეთ ისინი ადმინისტრაციულ ინტერფეისში (**მართვა → პარამეტრები**) ან CLI-ს დახმარებით; მათი განთავსება `gateway.env` როდესაც არაფერი არ აკეთებს — env მათთვის იგნორირდება. საიდქარისთვის, რომელიც დაინსტალირებულია პაკეტიდან (STT/TTS და ა.შ.), ინსტალატორი თვითონ შეაქვს მნიშვნელობები მონაცემთა ბაზაში. ```bash # 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. ## განცხადებები ადმინისტრატორის ინტერფეისი **განცხადებები** გვერდი (მონაცემთა მართვის განყოფილებაში) არის მოვლენების შემთხვევის საელფოს ყუთი (ადმინისტრატორის შესვლა, ხელმისაწვდომი/დაყენებული განახლება, ქვესისტემის შენელება ან აღდგენა და ასე შემდეგ) კატეგორიის, სერიოზულობის ხარისხის და უცნაურად წაკითხულის მიხედვით ფილტრებით. მის გვერდით არის **მაგისტრალი კატეგორია × მიწოდების არხი**: თითოეული კატეგორიის ღონისძიებისთვის, რომელსაც შეიტანთ **ვებ-მინტერფეისი**, **ელექტრონული ფოსტა**, **ტელეგრამა** და **წიოკება** არხები. Web UI შეტყობინებები მიწოდდება ადგილობრივად; Telegram დაკავშირებულია ღილაკით „Link Telegram“ (გაფართოებული ბმული), ელექტრონული ფოსტა აქტიურდება მხოლოდ მას შემდეგ, რაც მხარდაჭერის მისამართი ვერიფიცირდება, ხოლო push შეტყობინება მიდის მობილური აპლიკაციაში. კრიტიკული მოვლენები არ შეიძლება გამორთული იყოს webui არხზე. ## სად შემდეგ? - ადმინსტრატორის შესვლის დაბლოკვა: [პირველი შესვლა](/ka/v1.0/getting-started/first-login). - ნახეთ, სად იმყოფებიან ფაილები: [დაყენება](/ka/v1.0/getting-started/installation). - შეამოწმეთ წინასწარი მოთხოვნები: [მოთხოვნები](/ka/v1.0/getting-started/requirements).