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

AiHummer-ის კონფიგურაცია იყოფა ორი მკაცრად განსხვავებული ჯგუფი:

საწყისი კონფიგურაცია (gateway.env) — რა უნდა იცოდეს გეიტვეიმ მანამდე, სანამ შეძლებს თვითდე მონაცემთა ბაზა: მონაცემთა ბაზის DSN, მოსმენილი მისამართები, სტატიკური დირექტორიები, მასტერული გასაღები. მხოლოდ ეს გასაღები იკითხება გარემოდან.
პარამეტრების კატალოგი (მონაცემთა ბაზა) — ყოველი მეორე მოსახვევი. ისინი ინახება მონაცემთა ბაზა და დაყენება ვებ-ადმინისტრატორის ინტერფეისში (მართვა → პარამეტრები) ან ს aihummer settings set <KEY> <VALUE>. ამისათვის კმაყოფილები ა gateway.env მნიშვნელობა წყვეტს თავიდანვე იგნორირებული იყო — თუნდაც დამონტაჟებული იყოს, მას აქვს ეფექტის გარეშე.

კონფიგურაციის მოდელი

gateway.env არის მხოლოდ bootstrap. წყვეტის მიღების წესრიგი:

პარამეტრის კატალოგის გასაღები: database value → built-in default (გარემოინი გარემო იგნორირდება);
ჩატვირთვის გასაღები: environment variable only.

ამისთანებით, ცალმხრივი სიმართლის წყარო კონფიგურაციის პარამეტრებისთვის არის მონაცემთა ბაზა (ადმინისტრატორის ვებ-ინტერფეისი / aihummer settings); გარემო შეიცავს მხოლოდ იმას, რაც პროცესს დაწყებისთვის სჭირდება.

ინსტალაციის კონფიგურაციის ფაილი მშობლიურ ჰოსტზე მდებარეობს მისამართზე:

# /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`)

ამ ქვემოთ მოცემული თითოეული გასაღები შენახულია მონაცემთა ბაზაში. დააკონფიგურირეთ იგი ადმინისტრატორის ვებ-სინტერფეისში (მართვა → პარამეტრები) ან აი ასე:

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 და ინტეგრაცია.

იაზმ და მოდელები

საბჭი	მიზანი
`AIHUMMER_LLM_PROVIDER`	მოდელის მიმწოდებელი გამოყენებისთვის.
`AIHUMMER_LLM_MODEL`	მოდელის სახელი.
`AIHUMMER_LLM_GATEWAY_URL`	OpenAI-თან თავსებადი LLM გეიტვეის/ბოლო წერტილების საბაზისო URL (`AIHUMMER_LLM_*` გზა; განსხვავდება მშობლიური `AIHUMMER_OPENAI_BASE_URL`-ისგან). იხილეთ BYOK და მომწოდებლები.
`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` ინსტრუმენტი (ნაგულისხმევად გამორთულია საერთო ჰოსტებზე).
`AIHUMMER_BROWSER_PROFILE_SOCKET`	გზა ბრაუზერის სერვისის კერძო `managed-profiles.sock` სოკეტამდე; ცარიელი — მუდმივი `computer` პროფილები გამორთულია.
`AIHUMMER_BROWSER_PROFILE_BINDINGS`	ბრაუზერის მუდმივი პროფილების მკაფიო მიბმების JSON მასივი (`profile_id`, `tenant_id`, `user_id`, `agent_ids`, `conversation_ids`).

ვებ-ძიებას და ბრაუზერს ინსტალატორი მართავს: ისინი ყუთიდანვე დაყენებულია, გამოირთვება --no-search / --no-browser დროშებით და მიემართება არსებულ ინსტანსზე --external-search=URL / --external-browser=URL საშუალებით — მათთვის ოპერატორის პარამეტრები არ არსებობს.

ნახე სრულად ობიექტების კატალოგი რა მიიღწევა თითოეული ინსტრუმენტით.

ხმა და საიდკარები

საბჭი	მიზანი
`AIHUMMER_STT_URL`	მხარდაჭერის მოდულის URL სიტყვის ტექსტში გადაკეთებისთვის (ადგილობრივი დაყენების პროგრამის მიერ შექმნილი).
`AIHUMMER_TTS_URL`	ტექსტის ზმნად გადამყვანი დამხმარე პროგრამის URL (ადგილობრივი დაყენების პროგრამის მიერ შექმნილი).
`AIHUMMER_VIDEO_URL`	ვიდეოს აღქმისთვის დამხმარე მოდულის URL.
`AIHUMMER_TTS_AUTO_REPLY`	როდის გახმოვანდეს მზა პასუხი: `off`, `always`, `inbound` (ნაგულისხმევი), `tagged`.
`AIHUMMER_TTS_MAX_CHARS`	გასახმოვანებელი ტექსტის ზღვარი: `0` — სრული პასუხი, სხვაგვარად `100`–`10000` სიმბოლო.
`AIHUMMER_TTS_SUMMARIZE`	გრძელი პასუხის შემოკლება გახმოვანებისთვის (ნაგულისხმევად ჩართულია).

საიდკარები — ეს არის ცალკეული 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 გაძლევს დაყენების საშუალებას ნიშნის გარეშე პლაგინები. მხოლოდ დეველოპერის კრებულებისთვის — იგნორირება ხდება გამოსაცემ კრებულებში. არასოდეს გარე ხელმისაწვდომ ნიმუშზე.

ცვლადი	მიზანი
`AIHUMMER_PLUGIN_PUBKEY`	დამატებითი ნდობით აღჭურვილი საჯარო გასაღები (base64 ed25519) პლაგინების ხელმოწერების შესამოწმებლად. მხოლოდ დეველოპერებისთვის განკუთვნილი აღუწერებლები — იგნორირებადია გამოშვების აღუწერებებში (რეგისტრის კლავი ბინარულ ფაილშია დაბმული).
`AIHUMMER_PLUGIN_DEV_UNSIGNED`	`1` გაძლევს დაყენების საშუალებას ნიშნის გარეშე პლაგინები. მხოლოდ დეველოპერის კრებულებისთვის — იგნორირება ხდება გამოსაცემ კრებულებში. არასოდეს გარე ხელმისაწვდომ ნიმუშზე.

[!WARNING] რელიზურ ვერსიებში პლაგინის ნდობის ძირი არის ბინარულ ფაილში ჩაშენებული და გარემოს ან პარამეტრებით ვერ შეიცვლება — ეს დაცვის საშუალებაა ჩარევისაგან გარანტია.

რწმენის მოდელი (ოფიციალური → დადასტურებული გასაღები, პრივატული → რწმენის საცავი, გაუფორმებელი → ჩამორთმეული) აღწერილია ინსტალაცია და განახლებები.

სად შემდეგ?

ნახეთ, რომელი ხელსაწყოებს აჯანსაღებს თითოეული გასაღები: ობიექტების კატალოგი.
დღიურად გამოიყენეთ ნიმუში: CLI-ის სახელმძღვანელო.