Շրջակա միջավայրի փոփոխականներ
AIHUMMER_PUBLIC_TLS_CERT_FILE + AIHUMMER_PUBLIC_TLS_KEY_FILE: HTTPS-ը կարող է սպասարկել դարպասը՝ վկայականի/մասնավոր բանալու զույգով, կամ ձեր հակադարձ պրոքսին։ Անվավեր զույգը չի փոխարինվում սովորական HTTP-ով։ Հավելվածում մասնավոր վկայականը հաստատելուց առաջ SHA-256 մատնահետքը համեմատեք տեղադրման վստահելի տերմինալի հետ։
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 |
Վեբ վահանակը, հավելվածները և ալիքներն օգտագործում են սերվերի նույն հանրային հասցեն։ Բացեք տեղադրիչի ցուցադրած հանրային հասցեն․ տեղային լռելյայն հասցեն http://localhost:8780/ է։ Տեղադրման ժամանակ ընտրված պորտը կարող է տարբերվել։ |
AIHUMMER_WEBUI_ADDR |
AIHUMMER_WEBUI_ADDR-ը սկզբնական կարգավորման համատեղելիության օժանդակ օպերատորային լսիչ է միայն loopback-ում՝ լռելյայն 127.0.0.1:8781։ Այն վահանակի առանձին արտաքին հասցե չէ, իսկ 0-ն անվավեր է։ AIHUMMER_WEBUI_ENABLED=false-ը վահանակն անջատում է երկու լսիչներում։ |
AIHUMMER_DEFAULT_WORKSPACE_ID |
Ընտրում է աշխատական տարածման նախնական կարգը կարգավորված նշված մուտքագրման ինտեգրացիաների համար։ |
AIHUMMER_HOME_ROOT |
Տեղադրեք արմատը (սովորաբար որոշվում է ըստ բինար ֆայլի ուղու); ամրացնում է admin-ui/blob/installer թղթապանակները և հիմնական ֆայլերը։ |
AIHUMMER_BLOB_DIR |
Անցկացնում է մեդիա/ֆայլերի ծառայություն (բլոկային պահոցի եկանակետ): Այն նույնպես պահում է կարգը զանգվածային (ձեռքով սահմանված) հավելվածի արհեստանքներ ցած blob: հղումներ, որոնք թույլատրվում են տեղաբաշխողի կողմից։ |
AIHUMMER_ADMIN_UI_DIR |
Վեբ վահանակը, հավելվածները և ալիքներն օգտագործում են սերվերի նույն հանրային հասցեն։ / |
Գաղտնիքներ և ենթակառուցվածքներ
| Փոփոխական | Նպատակ |
|---|---|
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 բանալին պարտադիր չէ․ կարող եք օգտագործել տեղային OpenAI-համատեղելի մոդել, աջակցվող բաժանորդագրություն կամ ձեր API բանալին։ Եթե մատակարար կարգավորված չէ, ցուցադրվում է սխալը՝
AI մոդելի պրովայդեր դեռ կարգավորված չէ — ավելացրեք այն «Մոդելներ» բաժնում
Գործիքներ
| Բանալ | Նպատակ |
|---|---|
AIHUMMER_FS_ROOT |
Լրացուցիչ նեղացնում է թույլատրված ֆայլային արմատը․ դատարկ արժեքը հոսթին հասանելիություն չի տալիս։ |
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 թույլ է տալիս տեղադրել աննշան պլագիններ. Ուղղված է միայն ծրագրավորողի բաղադրություններին — անտեսվում է թողարկման բաղադրություններում։ Միտումնավոր ոչ մի դեպքում հասանելի զանգվածում։ |
[!WARNING] Բեռների թողարկված զանգվածներում պլագինի վստահության արմատը հանդիսանում է պատկերված բինար ֆայլում և կարող չէ փոփոխվել միջավայրի կամ կարգաբերումների միջոցով — սա պաշտպանություն է միջամտությունից երաշխիք.
Յուրիմի մոդել (առևտրային → հաստատվող բանալի, մասնավոր → վստահության պահոց, չստորագրված → փակված) նկարագրված է Տեղադրում և թարմացումներ.
Որտեղից հետո
- Դիտեք, թե որ գործիքները բացում է յուրաքանչյուր բանալին։ Պահարան գործիքների.
- Օգտագործեք օրինակ.daily CLI-ի ուղեցույց.