გარემოს ცვლადები

# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes

aihummer settings set AIHUMMER_LLM_PROVIDER openai

AiHummer-ის კონფიგურაცია იყოფა **ორი მკაცრად განსხვავებული ჯგუფი**: 1. **საწყისი კონფიგურაცია (`gateway.env`)** — რა უნდა იცოდეს გეიტვეიმ **მანამდე**, სანამ შეძლებს თვითდე მონაცემთა ბაზა: მონაცემთა ბაზის DSN, მოსმენილი მისამართები, სტატიკური დირექტორიები, მასტერული გასაღები. მხოლოდ ეს გასაღები იკითხება გარემოდან. 2. **პარამეტრების კატალოგი (მონაცემთა ბაზა)** — ყოველი მეორე მოსახვევი. ისინი ინახება მონაცემთა ბაზა და დაყენება ვებ-ადმინისტრატორის ინტერფეისში (**მართვა → პარამეტრები**) ან ს [`aihummer settings set <KEY> <VALUE>`](/ka/v1.0/reference/cli). ამისათვის კმაყოფილები ა `gateway.env` მნიშვნელობა წყვეტს **თავიდანვე იგნორირებული იყო** — თუნდაც დამონტაჟებული იყოს, მას აქვს ეფექტის გარეშე. ## კონფიგურაციის მოდელი `gateway.env` არის **მხოლოდ bootstrap**. წყვეტის მიღების წესრიგი: - **პარამეტრის კატალოგის გასაღები**: `database value → built-in default` (გარემოინი გარემო იგნორირდება); - **ჩატვირთვის გასაღები**: `environment variable only`. ამისთანებით, ცალმხრივი სიმართლის წყარო კონფიგურაციის პარამეტრებისთვის არის მონაცემთა ბაზა (ადმინისტრატორის ვებ-ინტერფეისი / `aihummer settings`); გარემო შეიცავს მხოლოდ იმას, რაც პროცესს დაწყებისთვის სჭირდება. ინსტალაციის კონფიგურაციის ფაილი მშობლიურ ჰოსტზე მდებარეობს მისამართზე: ```ini # /home/.aihummer/etc/gateway.env AIHUMMER_DATABASE_URL=postgres://... AIHUMMER_MASTER_KEY=base64-32-bytes ``` > [!TIP] > არ ჩასვათ პარამეტრების კატალოგის ხელსაწყოები `gateway.env` — ეს არანაირ ეფექტს არ ახდენს. შეცვლა > ისინი ადმინისტრატორის ვებ-მინტერფეისში (მოდულში → პარამეტრები, იქ არის ძიება) ან გზით > `aihummer settings set`. ზოგი ცვლილება (მაგალითად, ხელსაწყოების გადართვები და გვერდითი პირები) > დაბადება) აქტიურად გამოიყენება; სხვებისთვის სერვისის აღდგენა სჭირდება. ## გადმოწერა (gateway.env) ერთადერთი გასაღებები, რომელთაც კარიბჭე ნამდვილად კითხულობს გარემოდან. ### გულა და მონაცემთა ბაზა | ცვლადი | მიზანი | |---|---| | `AIHUMMER_DATABASE_URL` | **უპრობლემოდ.** DSN Postgres-სთვის. მის გარეშე გალი მუშაობს მხოლოდ მდგომარეობის შემოწმების რეჟიმში. | | `AIHUMMER_DB_APP_URL` | DSN შეზღუდული როლით, რომელიც ააქტიურებს სტრიქონის დონეზე უსაფრთხო წვდომას (ავტომატურად ეთავსება ადგილობრივი ინსტალაციისთვის). | | `AIHUMMER_GATEWAY_ADDR` | საზოგადოებრივი მოსმენითი მისამართი (ნაგულისხმევად `:8780`) — მთელი გარე ტრეფიკი: API (`/v1/*`), კავშირი, WS/SSE, მოსული ვებჰუქები, აპლიკაციებისა/დაპიების პროქსი და მდგომარეობის შემოწმება. | | `AIHUMMER_WEBUI_ADDR` | ვებ-ადმინისტრატორის ინტერფეისის კერძო მოსმენის მისამართი (სტანდარტულად) `:8781`), მიიღება ძირითადი მარშრუტის მიხედვით `/`; სასურველია ის მხოლოდ შიდა გამოყენებისთვის ინტერფეისს მიამაგროთ. დაყენებულია `0` გათიშვა. | | `AIHUMMER_DEFAULT_WORKSPACE_ID` | არჩენს სამუშაო სივრცეს ნაგულისხმევად კონფიგურებული მოსული ინტეგრაციებისთვის. | | `AIHUMMER_HOME_ROOT` | უყენეთ გული (ჩვეულებრივ განისაზღვრება ბინარული ფაილის გზით); ფიქსავს admin-ui/blob/installer დირექტორიებს და ძირითადი ფაილებს. | | `AIHUMMER_BLOB_DIR` | ამარჯვებს მედია/ფაილების სერვისს (ბლოკური საცავის დირექტორია). ის ასევე ინახავს **პირადი (ხელით დაყენებული) პლაგინის არტეფაქტები** ქვეშ `blob:` ბმულები, რომლებიც საშუალებას აძლევს გამაფართოებელს. | | `AIHUMMER_ADMIN_UI_DIR` | ემსახურება SPA-ს ადმინისტრატორს `/admin/`. | ### საიდუმლოებები და ინფრასტრუქტურა | ცვლადი | მიზანი | |---|---| | `AIHUMMER_MASTER_KEY` | base64-ებით კოდირებული 32 ბაიტი; საშუალებას აძლევს სერიოზული მონაცემების შენახვის გამოყენებას შესვენების დროს, საცავი და BYOK. | | `AIHUMMER_MEDIA_TOKEN_SECRET` | შეინარჩუნებს ხელმოწერილი URL-ების აღიარებულობას გადატვირთვის შემდეგ. | | `AIHUMMER_OTEL_ENDPOINT` | OTLP-ის საბოლოო წერტილი ტრასირების/მეტრიკის გაგზავნისთვის. | | `AIHUMMER_DOWNLOAD_BASE_URL` | ბაზისურ URL გამშვები არტეფაქტებისთვის (თავიდან განახლების წყარო). | > [!WARNING] > შესაძლებლობის დაკვირვება არის **მხოლოდ OTLP push**. AiHummer აკეთებს **არა** გამოუჩინო პრომეთე > `/metrics` საბოლოო წერტილი ან `/debug/pprof`. წერტილი `AIHUMMER_OTEL_ENDPOINT` თქვენზე > გაგროვების მაგივრად. ## პარამეტრების კატალოგი (მონაცემთა ბაზა — ადმინისტრატორის ვებ–ინტერფეისი ან `aihummer settings`) ამ ქვემოთ მოცემული თითოეული გასაღები შენახულია მონაცემთა ბაზაში. დააკონფიგურირეთ იგი ადმინისტრატორის ვებ-სინტერფეისში (**მართვა → პარამეტრები**) ან აი ასე: ```bash aihummer settings set AIHUMMER_LLM_PROVIDER openai ``` ა `gateway.env` მნიშვნელობა ასეთ გასაღებისთვის **გაუთვალისწინებელი**. ### უსაფრთხოება | საბჭი | მიზანი | |---|---| | `AIHUMMER_APPROVAL_TOOLS` | ინსტრუმენტები, რომლებიც ითხოვენ ადამიანის მონაწილეობით დამტკიცებას გაშვებამდე. | | `AIHUMMER_AIRGAPPED` | `1` ბლოკავს მოდელის მიერ მართვად საჯარო გამოსვლას (ჰაერის გაპრილის რეჟიმი). | | `AIHUMMER_AUDIT_RETENTION_DAYS` | ადმინისტრატორის აუდიტის ჟურნალის შენახვის ფანჯარა. | | `AIHUMMER_INBOUND_SECRET` | HMAC საერთო სეკრეტი კონექტორისთვის → გეიტვეი `/v1/inbound/*` ზარები. | ### ავტენტიკაცია და ერთიანი შესვლა (SSO) | საბჭი | მიზანი | |---|---| | `AIHUMMER_OIDC_ISSUER` | იცავს `/v1/admin/*`. მას გარეშე (და LDAP/SAML-ის გარეშე) ადმინი ენდობა შემქმნელის სათაურებს — არასდროს გამოყოთ ასეთი მაგალითი გარეთ. | LDAP/AD და SAML არის კონფიგურირებული OIDC-თან ერთად კორპორატიული შესასვლელისათვის; SCIM უზრუნველყოფს მომხმარებელთა ავტომატურ მიწოდებას. იხ.} [ვებჰუკები, SCIM და ინტეგრაცია](/ka/v1.0/api/webhooks-scim-pairing). ### იაზმ და მოდელები | საბჭი | მიზანი | |---|---| | `AIHUMMER_LLM_PROVIDER` | მოდელის მიმწოდებელი გამოყენებისთვის. | | `AIHUMMER_LLM_MODEL` | მოდელის სახელი. | | `AIHUMMER_LLM_GATEWAY_URL` | OpenAI-თან თავსებადი LLM გეიტვეის/ბოლო წერტილების საბაზისო URL (`AIHUMMER_LLM_*` გზა; განსხვავდება მშობლიური `AIHUMMER_OPENAI_BASE_URL`-ისგან). იხილეთ [BYOK და მომწოდებლები](/ka/v1.0/access/byok-providers). | | `AIHUMMER_OPENAI_API_KEY` | API-კლიენტი OpenAI-სთან თავსებად პროვაიდერისთვის. | | `AIHUMMER_SUBAGENT_MAX_DEPTH` | შექმნილ დახმარეაგენტების მაქსიმალური სიღრმე. | > [!NOTE] > თუ არ არის დამატებული არცერთი მოდელი, გეიტვეი ბრუნდება **დეტერმინირებული bốket** ამდენად > სისტემა ჯერ კიდევ მუშაობს. არასოდეს არის საჭირო გადახდის API-მოდელი — უფასო/ადგილობრივი მოდელები და > Codex/ChatGPT-ის საგამარჯვებო ტრანსპორტი პირველკლასელია. ### ინსტრუმენტები | საბჭი | მიზანი | |---|---| | `AIHUMMER_FS_ROOT` | ჩართულია `filesystem_read`, ამ ფესვის ფარგლებში იზოლირებული. | | `AIHUMMER_DB_QUERY_DSN` | ჩართულია `db_query` (მხოლოდ წაკითხვისთვის) ეს DSN-ის წინააღმდეგ. | | `AIHUMMER_CODE_EXEC` | გადართვა `code_exec` ინსტრუმენტი (ნაგულისხმევად გამორთულია საერთო ჰოსტებზე). | ვებ-ძიებას და ბრაუზერს ინსტალატორი მართავს: ისინი ყუთიდანვე დაყენებულია, გამოირთვება `--no-search` / `--no-browser` დროშებით და მიემართება არსებულ ინსტანსზე `--external-search=URL` / `--external-browser=URL` საშუალებით — მათთვის ოპერატორის პარამეტრები არ არსებობს. ნახე სრულად [ობიექტების კატალოგი](/ka/v1.0/reference/tools-catalog) რა მიიღწევა თითოეული ინსტრუმენტით. ### ხმა და საიდკარები | საბჭი | მიზანი | |---|---| | `AIHUMMER_STT_URL` | მხარდაჭერის მოდულის URL სიტყვის ტექსტში გადაკეთებისთვის (ადგილობრივი დაყენების პროგრამის მიერ შექმნილი). | | `AIHUMMER_TTS_URL` | ტექსტის ზმნად გადამყვანი დამხმარე პროგრამის URL (ადგილობრივი დაყენების პროგრამის მიერ შექმნილი). | | `AIHUMMER_VIDEO_URL` | ვიდეოს აღქმისთვის დამხმარე მოდულის URL. | საიდკარები — ეს არის ცალკეული HTTP-სერვისები; გეითი მიმართავს მათ URL-ებით. ### ვექტორები და ემბედინგები | საბჭი | მიზანი | |---|---| | `AIHUMMER_QDRANT_URL` | რეალური ვექტორული საცავი (Qdrant). არ არის → საცავი მეხსიერებაში. | | `AIHUMMER_EMBEDDER_URL` | რეალური ჩასამონტაჟებელი სერვისი. არ არსებობს → ჰაშჩასამონტაჟებელი. | ### პროტოკოლური ზედაპირები (თავსებად) | საბჭი | მიზანი | |---|---| | `AIHUMMER_MCP_PUBLISH` | ზუსტად `1` ხსნის გარე MCP-სერვერს მისამართზე `POST /v1/mcp`. თავისთავად არცერთ ხელსაწყოს არ ახდენს ექსპორტს. | | `AIHUMMER_MCP_EXPORT_TOOLS` | მძიმით გამოყოფილი ზუსტი ხელსაწყოების სახელები, რომლებსაც დაინახავს MCP-კლიენტი. ცარიელი (ნაგულისხმევი) — ექსპორტდება ნული ხელსაწყო. | | `AIHUMMER_A2A_PUBLISH` | `1` მოუთავსებს ზედაპირს A2A (`/.well-known/agent.json`, `/a2a/message`). | ## მხოლოდ დეველოპერებისთვის განკუთვნილი ბილდები | ცვლადი | მიზანი | |---|---| | `AIHUMMER_PLUGIN_PUBKEY` | დამატებითი ნდობით აღჭურვილი საჯარო გასაღები (base64 ed25519) პლაგინების ხელმოწერების შესამოწმებლად. **მხოლოდ დეველოპერებისთვის განკუთვნილი აღუწერებლები — იგნორირებადია გამოშვების აღუწერებებში** (რეგისტრის კლავი ბინარულ ფაილშია დაბმული). | | `AIHUMMER_PLUGIN_DEV_UNSIGNED` | `1` გაძლევს დაყენების საშუალებას **ნიშნის გარეშე** პლაგინები. **მხოლოდ დეველოპერის კრებულებისთვის — იგნორირება ხდება გამოსაცემ კრებულებში.** არასოდეს გარე ხელმისაწვდომ ნიმუშზე. | > [!WARNING] > რელიზურ ვერსიებში პლაგინის ნდობის ძირი არის **ბინარულ ფაილში ჩაშენებული** და > გარემოს ან პარამეტრებით ვერ შეიცვლება — ეს დაცვის საშუალებაა ჩარევისაგან > გარანტია. რწმენის მოდელი (ოფიციალური → დადასტურებული გასაღები, პრივატული → რწმენის საცავი, გაუფორმებელი → ჩამორთმეული) აღწერილია [ინსტალაცია და განახლებები](/ka/v1.0/marketplace/install-updates#trust-model-and-the-pinned-key). ## სად შემდეგ? - ნახეთ, რომელი ხელსაწყოებს აჯანსაღებს თითოეული გასაღები: [ობიექტების კატალოგი](/ka/v1.0/reference/tools-catalog). - დღიურად გამოიყენეთ ნიმუში: [CLI-ის სახელმძღვანელო](/ka/v1.0/reference/cli).