AiHummer
ქართული▾
შესვლაპირადი კაბინეტი
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
ცნობარი/გარემოს ცვლადები

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

v1.0.x · განახლდა 2026-08-04

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

  1. საწყისი კონფიგურაცია (gateway.env) — რა უნდა იცოდეს გეიტვეიმ მანამდე, სანამ შეძლებს თვითდე მონაცემთა ბაზა: მონაცემთა ბაზის DSN, მოსმენილი მისამართები, სტატიკური დირექტორიები, მასტერული გასაღები. მხოლოდ ეს გასაღები იკითხება გარემოდან.
  2. პარამეტრების კატალოგი (მონაცემთა ბაზა) — ყოველი მეორე მოსახვევი. ისინი ინახება მონაცემთა ბაზა და დაყენება ვებ-ადმინისტრატორის ინტერფეისში (მართვა → პარამეტრები) ან ს 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 ინსტრუმენტი (ნაგულისხმევად გამორთულია საერთო ჰოსტებზე).

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

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

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

საბჭი მიზანი
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] რელიზურ ვერსიებში პლაგინის ნდობის ძირი არის ბინარულ ფაილში ჩაშენებული და გარემოს ან პარამეტრებით ვერ შეიცვლება — ეს დაცვის საშუალებაა ჩარევისაგან გარანტია.

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

სად შემდეგ?