Միջավայրի փոփոխականներ
AiHummer-ը կարգավորվում է AIHUMMER_* միջավայրի փոփոխականների միջոցով (գումարած մի քանի
գործիք-հատուկ, ինչպիսին է SEARXNG_URL)։ Այս էջը կատալոգն է՝ խմբավորված ըստ
ոլորտի։ Փոփոխականների մեծ մասը նաև խմբագրելի են web admin UI-ից։
Կարգավորման մոդել
Յուրաքանչյուր կարգավորում որոշվում է ֆիքսված կարգով.
database value → environment variable → built-in defaultԴա նշանակում է, որ admin UI-ում պահված արժեքը (պահվում է տվյալների բազայում) գերակայում է
միջավայրին, որը գերակայում է ներկառուցված լռելյայնին։ Bootstrap փոփոխականները —
նրանք, որ gateway-ին անհրաժեշտ են նախքան տվյալների բազան կարդալը, ինչպիսիք են
AIHUMMER_DATABASE_URL-ը և AIHUMMER_MASTER_KEY-ը — մնում են միայն-միջավայր։
Host-native տեղադրման կարգավորման ֆայլը գտնվում է.
# /home/.aihummer/etc/gateway.env
AIHUMMER_DATABASE_URL=postgres://...
AIHUMMER_MASTER_KEY=base64-32-bytes[!TIP] Կարգավորելի, ոչ-bootstrap կարգավորիչներն ավելի լավ է փոխել web admin UI-ում, որպեսզի դրանք ուժի մեջ մտնեն առանց ֆայլեր խմբագրելու։ Որոշ փոփոխություններ (օրինակ՝ գործիքների փոխանջատիչներ և ենթա-ագենտի խորություն) կիրառվում են անմիջապես; մյուսները պահանջում են ծառայության վերագործարկում։
Core և տվյալների բազա
| Փոփոխական | Նպատակ |
|---|---|
AIHUMMER_DATABASE_URL |
Պարտադիր։ Postgres DSN։ Առանց դրա gateway-ն աշխատում է միայն-առողջության ռեժիմով։ |
AIHUMMER_DB_APP_URL |
Սահմանափակ-դերի DSN, որն ակտիվացնում է Row-Level Security-ն (ավտոմատ սահմանվում է տեղական տեղադրումների համար)։ |
AIHUMMER_GATEWAY_ADDR |
Ունկնդրման հասցե (լռելյայն՝ :8780; ինստալերն ընտրում է ազատ պորտ)։ |
AIHUMMER_DEFAULT_WORKSPACE_ID |
Միացնում է մուտքային dispatcher-ը և widget-ի լռելյայն workspace-ը։ |
AIHUMMER_BLOB_DIR |
Միացնում է մեդիա/ֆայլ ծառայությունը (blob պահեստի գրացուցակ)։ |
AIHUMMER_ADMIN_UI_DIR |
Մատուցում է admin SPA-ն /admin/ հասցեում։ |
AIHUMMER_WIDGET_DIR |
Մատուցում է web widget-ը /widget/ հասցեում։ |
Անվտանգություն և vault
| Փոփոխական | Նպատակ |
|---|---|
AIHUMMER_MASTER_KEY |
base64-կոդավորված 32 բայթ; միացնում է secrets-at-rest, vault և BYOK։ |
AIHUMMER_MEDIA_TOKEN_SECRET |
Պահում է ստորագրված ներբեռնման URL-ները վավեր վերագործարկումների միջև։ |
AIHUMMER_APPROVAL_TOOLS |
Գործիքներ, որ պահանջում են մարդկային հաստատում նախքան գործարկվելը։ |
AIHUMMER_AIRGAPPED |
1-ը արգելափակում է մոդելի կողմից վերահսկվող հանրային ելքը (air-gapped ռեժիմ)։ |
AIHUMMER_AUDIT_RETENTION_DAYS |
admin աուդիտի լոգի պահպանման պատուհան։ |
Նույնականացում և SSO
| Փոփոխական | Նպատակ |
|---|---|
AIHUMMER_OIDC_ISSUER |
Պաշտպանում է /v1/admin/*-ը։ Առանց դրա (և առանց LDAP/SAML) admin-ը վստահում է dev header-ներին — երբեք մի՛ բացեք այդպիսի ինստանս։ |
LDAP/AD-ն և SAML-ը կարգավորվում են OIDC-ի կողքին ձեռնարկության մուտքի համար; SCIM-ը ապահովում է օգտատերերի ավտոմատ տրամադրումը։ Տես Webhooks, SCIM և զուգակցում։
Ալիքներ և մուտքային
| Փոփոխական | Նպատակ |
|---|---|
AIHUMMER_INBOUND_SECRET |
HMAC ընդհանուր գաղտնիք կոնեկտոր → gateway /v1/inbound/* կանչերի համար։ |
AIHUMMER_INBOUND_URL |
Կոնեկտորի կողմից՝ gateway-ի մուտքային URL-ը, որին կոնեկտորը ուղարկում է։ |
LLM և մոդելներ
| Փոփոխական | Նպատակ |
|---|---|
AIHUMMER_LLM_PROVIDER |
Օգտագործվող մոդելի մատակարար։ |
AIHUMMER_LLM_MODEL |
Մոդելի անունը։ |
AIHUMMER_LLM_GATEWAY_URL |
Վերջնակետ OpenAI-համատեղելի LLM gateway-ի համար։ |
AIHUMMER_OPENAI_API_KEY |
API բանալի OpenAI-համատեղելի մատակարարի համար։ |
AIHUMMER_SUBAGENT_MAX_DEPTH |
Ստեղծվող ենթա-ագենտների առավելագույն խորություն։ |
[!NOTE] Եթե ոչ մի մոդել միացված չէ, gateway-ը վերադառնում է դետերմինիստիկ mock-ի, որպեսզի համակարգը դեռ աշխատի։ Վճարովի մոդելի API երբեք չի պահանջվում — ազատ/տեղական մոդելները և Codex/ChatGPT-բաժանորդագրության փոխադրումը առաջնակարգ են։
Գործիքներ
| Փոփոխական | Նպատակ |
|---|---|
SEARXNG_URL |
Միացնում է web_search գործիքը (SearXNG ինստանսի URL)։ |
CLOAKBROWSER_CDP_URL |
Միացնում է browser/computer գործիքները (Chrome DevTools Protocol URL)։ |
AIHUMMER_FS_ROOT |
Միացնում է filesystem_read-ը, sandbox-ված այս արմատի ներքո։ |
AIHUMMER_DB_QUERY_DSN |
Միացնում է db_query-ն (միայն-ընթերցում) այս DSN-ի դեմ։ |
AIHUMMER_CODE_EXEC |
Փոխանջատում է code_exec գործիքը (լռելյայն անջատված ընդհանուր host-երի վրա)։ |
Տես ամբողջական Գործիքների կատալոգը, թե յուրաքանչյուր գործիք ինչ է անում։
Ձայն և sidecar-ներ
| Փոփոխական | Նպատակ |
|---|---|
AIHUMMER_STT_URL |
Speech-to-text sidecar-ի URL (ինստալերի կողմից ավտոմատ-սահմանված)։ |
AIHUMMER_TTS_URL |
Text-to-speech sidecar-ի URL (ինստալերի կողմից ավտոմատ-սահմանված)։ |
AIHUMMER_DIARIZE_URL |
Խոսնակների դիարիզացիայի sidecar-ի URL։ |
AIHUMMER_VOICECLONE_URL |
Ձայնի կլոնավորման sidecar-ի URL։ |
AIHUMMER_VIDEO_URL |
Վիդեո-հասկացման sidecar-ի URL։ |
Sidecar-ները առանձին HTTP ծառայություններ են; gateway-ը հասնում է դրանց URL-ով։
Վեկտորներ և embeddings
| Փոփոխական | Նպատակ |
|---|---|
AIHUMMER_QDRANT_URL |
Իրական վեկտորային պահեստ (Qdrant)։ Բացակայության դեպքում → in-memory պահեստ։ |
AIHUMMER_EMBEDDER_URL |
Իրական embedder ծառայություն։ Բացակայության դեպքում → hash embedder։ |
Bus և դիտարկելիություն
| Փոփոխական | Նպատակ |
|---|---|
AIHUMMER_NATS_URL |
Ընտրովի NATS bus առաքման համար։ |
AIHUMMER_OTEL_ENDPOINT |
OTLP վերջնակետ trace-երի/մետրիկաների push-ի համար։ |
[!WARNING] Դիտարկելիությունը միայն OTLP push է։ AiHummer-ը չի բացում Prometheus
/metricsվերջնակետ կամ/debug/pprof։ Փոխարենը ուղղեքAIHUMMER_OTEL_ENDPOINT-ը ձեր collector-ին։
Թարմացումներ
| Փոփոխական | Նպատակ |
|---|---|
AIHUMMER_DOWNLOAD_BASE_URL |
Բազային URL թողարկման արտեֆակտների համար (ինքնա-թարմացման աղբյուր)։ |
AIHUMMER_UPDATE_CHANNEL |
Հետևվող թողարկման ալիք։ |
AIHUMMER_AUTO_UPDATE |
Թարմացման ռեժիմ՝ off, check կամ apply։ |
Բանալիով-փակված տեղադրման ալիքները (alfa/beta/dev) լրացուցիչ կարդում են
AIHUMMER_CHANNEL_KEY / AIHUMMER_RELEASE_TOKEN տեղադրման ժամանակ։
Marketplace և փլագիններ
| Փոփոխական | Նպատակ |
|---|---|
AIHUMMER_BLOB_DIR |
Blob-պահեստի գրացուցակ։ Բացի մեդիայից/ֆայլերից, այն պահում է մասնավոր (side-loaded) փլագինների արտեֆակտներ blob: ref-երի ներքո, որ deployer-ը լուծում է։ |
AIHUMMER_PLUGIN_PUBKEY |
Լրացուցիչ վստահված հանրային բանալի (base64 ed25519) փլագինի ստորագրությունները ստուգելու համար — բացի core-ում ամրացված ռեգիստրի բանալուց։ |
AIHUMMER_PLUGIN_DEV_UNSIGNED |
1-ը թույլ է տալիս տեղադրել չստորագրված փլագիններ։ Միայն տեղական մշակման համար — երբեք արտաքնապես հասանելի ինստանսի վրա։ |
Վստահության մոդելը (պաշտոնական → ամրացված բանալի, մասնավոր → trust store, չստորագրված → արգելափակված) նկարագրված է Տեղադրում և թարմացումներ-ում։
Արձանագրության մակերեսներ (opt-in)
| Փոփոխական | Նպատակ |
|---|---|
AIHUMMER_MCP_PUBLISH |
1-ը միացնում է արտաքին MCP սերվերը POST /v1/mcp-ում։ |
AIHUMMER_A2A_PUBLISH |
1-ը միացնում է A2A մակերեսը (/.well-known/agent.json, /a2a/message)։ |
Ուր հաջորդը
- Տես, թե որ գործիքներն է բացում յուրաքանչյուր փոփոխական՝ Գործիքների կատալոգ։
- Շահագործեք ինստանսն ամեն օր՝ CLI տեղեկատու։