Շրջակա միջավայրի փոփոխականներ

AiHummer-ի կոնֆիգուրացիան բաժանվում է երկու խստորեն տարբեր խմբեր:

Bootstrap (gateway.env) — ինչ պետք է գիտեն դարպասը առաջ այս կարող է կարդալ տվյալների զանգվածը՝ տվյալների զանգման DSN, լսելու հասցեներ, ստատիկ գրացուցակներ, հիմնական բանալի։ Միայն այս բանալիներն են կարդացվում միջավայրից։
Կարգավորումների կատալոգ (կարգավիճակների տվյալների բազա) — ամեն երկրորդ շրջադարձում։ Դրանք պահվում են համակարգիչների բազա և տեղադրել վեբ ադմին UI-ում (Կառավարում → Ներմուծումներ) կամ հետ 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`	Անձնական ադմինիստրատորի Web UI լսման հասցե (նմանակարող) `: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`	LLM-ին OpenAI-ով համապատասխանող ցանցային/քարտուղարային վերջնspuntի հիմնական URL `AIHUMMER_LLM_*` ճանապարհ՝ տարբերվող հայրենիքից `AIHUMMER_OPENAI_BASE_URL`). Դիտել BYOK-ն և մատակարարները.
`AIHUMMER_OPENAI_API_KEY`	API բանալի OpenAI-պետելի համատեղելի մատակարարի համար։
`AIHUMMER_SUBAGENT_MAX_DEPTH`	Ստեղծվող ենթագործակալների առավելագույն խորությունը:

[!NOTE] Եթե ոչ մի մոդել չի միացված, անցակետը վերադառնում է դեպի որոշված դասավորվածություն այդքանով համակարգը դեռ աշխատում է։ Վճարովի մոդելի 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] Բեռների թողարկված զանգվածներում պլագինի վստահության արմատը հանդիսանում է պատկերված բինար ֆայլում և կարող չէ փոփոխվել միջավայրի կամ կարգաբերումների միջոցով — սա պաշտպանություն է միջամտությունից երաշխիք.

Յուրիմի մոդել (առևտրային → հաստատվող բանալի, մասնավոր → վստահության պահոց, չստորագրված → փակված) նկարագրված է Տեղադրում և թարմացումներ.

Որտեղից հետո

Դիտեք, թե որ գործիքները բացում է յուրաքանչյուր բանալին։ Պահարան գործիքների.
Օգտագործեք օրինակ.daily CLI-ի ուղեցույց.