პარამეტრების ცნობარი

აქ ჩამოთვლილია ყველა პარამეტრი, რომელიც ოპერატორს შეუძლია შეცვალოს AiHummer-ის სერვერზე. გვერდი თავად პროდუქტის კატალოგიდან იქმნება, ამიტომ ემთხვევა თქვენს სერვერს. მნიშვნელობა დგება ვებ-ინტერფეისში ან ბრძანებით `aihummer settings set KEY VALUE` ([ბრძანების სტრიქონი](/ka/v1.4/reference/cli/)). ნაგულისხმევი მნიშვნელობის სვეტი აჩვენებს იმას, რასაც სერვერი იყენებს თქვენი მნიშვნელობის მითითებამდე. > [!NOTE] > საიდუმლო მნიშვნელობები აქ არ იბეჭდება, მომწოდებლის სამსახურებრივი გასაღებები კი საერთოდ არ ჩამოითვლება — პროდუქტი მათ ყველა სიიდან მალავს. ტირე ნიშნავს ცარიელ მნიშვნელობას ან ახსნას, რომელიც მხოლოდ ვებ-ინტერფეისში ჩანს. ## API | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PERSONAL_API_KEYS` | პერსონალური API-გასაღებები OpenAI-თავსებადისთვის | `bool` | `1` | გადატვირთვის შემდეგ | «off» გამორთავს პერსონალური გასაღებებით ავთენტიფიკაციას OpenAI-თავსებად ენდპოინტზე. ნებისმიერი სხვა მნიშვნელობა = ჩართულია. მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | ## Agent | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_ANNOUNCE_SLOW_TOOLS` | აგენტი: ხანგრძლივ მოქმედებამდე გაფრთხილება | `bool` | `1` | დაუყოვნებლივ | ხანგრძლივ მოქმედებამდე (სურათი, ღრმა ძიება, ვიდეო, დავალება ქვეაგენტს) აგენტი მოკლედ წერს, რას აკეთებს, რომ ლოდინი ჩუმი არ იყოს. გამორთეთ, თუ ასეთი შეტყობინებები ხელს გიშლით. | | `AIHUMMER_AGENT_COMPACT_AT_PCT` | აგენტი: ისტორიის შეკუმშვა შევსებისას, მისი ბიუჯეტის % | `int 50…99` | `85` | დაუყოვნებლივ | როცა საუბრის ისტორია მოდელის ფანჯარაში თავისი ადგილის ამ ნაწილს შეავსებს, ძველი შეტყობინებები რეზიუმეში ერთიანდება — ფონურად, პასუხის შემდეგ; სვლა არ ელოდება. დაბალი — შეკუმშვა უფრო ხშირად, მაგრამ მოდელს სიტყვასიტყვით ნაკლები ახსოვს; მაღალი — უფრო იშვიათად, მაგრამ სვლები მძიმდება. 50–99; აგენტს შეუძლია საკუთარი მნიშვნელობის დაყენება. | | `AIHUMMER_AGENT_COMPACT_TO_PCT` | აგენტი: შეკუმშვის შემდეგ დატოვება, ისტორიის ბიუჯეტის % | `int 10…90` | `50` | დაუყოვნებლივ | შეკუმშვის შემდეგ ისტორიის ადგილის რა ნაწილი რჩება სიტყვასიტყვით; ყველაფერი უფრო ძველი რეზიუმეში გადადის. უნდა იყოს შეკუმშვის ზღვარზე ნაკლები: მათ შორის სხვაობა განსაზღვრავს, რამდენი სვლა გავა შემდეგ შეკუმშვამდე. 10–90; აგენტს შეუძლია საკუთარი მნიშვნელობის დაყენება. | | `AIHUMMER_AGENT_HISTORY_TURNS` | აგენტი: სიტყვასიტყვით შენახული საუბრის სვლები | `int 1…1000` | `30` | დაუყოვნებლივ | საუბრის რამდენ ბოლო სვლას ხედავს მოდელი სიტყვასიტყვით (შეკუმშვამდე კიდევ 10-მდე). ძველი შეტყობინებები ფონურად ჯამდება; თავად საუბარი არასოდეს იშლება. მოდელის კონტექსტის ფანჯარა ავტომატურად ითვალისწინება. 1–1000; აგენტს შეიძლება ჰქონდეს საკუთარი მნიშვნელობა. | | `AIHUMMER_AGENT_MAX_ITERATIONS` | აგენტი: ინსტრუმენტის ნაბიჯების მაქსიმუმი ერთ სვლაზე | `int 1…256` | `25` | დაუყოვნებლივ | რამდენჯერ შეუძლია აგენტს ერთ სვლაში ინსტრუმენტების გამოძახება პასუხამდე. ლიმიტზე სვლა არ ვარდება: აგენტი ამბობს, რა გაკეთდა და რა დარჩა, და შეგიძლიათ სთხოვოთ გაგრძელება. ერთნაირი შედეგით სამი იდენტური გამოძახება ზედიზედ სვლას ადრე აჩერებს. 1–256; აგენტს შეიძლება ჰქონდეს საკუთარი მნიშვნელობა. | | `AIHUMMER_AGENT_MEMORY_FLUSH` | აგენტი: შეკუმშვამდე მეხსიერებაში ჩანაწერის შენახვა | `bool` | `1` | დაუყოვნებლივ | სანამ ძველი შეტყობინებები რეზიუმედ შეიკუმშება, აგენტი მეხსიერებაში ინახავს მოკლე ჩანაწერს მიზნების, გადაწყვეტილებების და ღია საქმეების შესახებ. გამორთეთ მოდელის გამოძახების დასაზოგად. | | `AIHUMMER_AGENT_MEMORY_FLUSH_PROMPT` | აგენტი: რა ჩაიწეროს ჩანაწერში შეკუმშვამდე | `text` | — | დაუყოვნებლივ | თქვენი საკუთარი დავალება ჩანაწერისთვის შეკუმშვამდე: რა შეინახოს შეჯამებაში გადასული შეტყობინებებიდან (მაგალითად, „ჩაწერე მხოლოდ შენაძენები, ვადები და შეთანხმებები“). ცარიელი — ჩაშენებული: მიზნები, გადაწყვეტილებები, ღია საქმეები. დაცვა არ ითიშება: საუბრის ტექსტი რჩება მონაცემად და არა მითითებად, პაროლები და გასაღებები არ ინახება. 4000 სიმბოლომდე; აგენტს შეიძლება ჰქონდეს საკუთარი. | | `AIHUMMER_AGENT_NEW_REMINDERS_MEMORY` | ახალი აგენტები: შეხსენებები და მეხსიერებაში ჩაწერა | `bool` | `1` | დაუყოვნებლივ | ხელით შექმნილი ახალი აგენტი (პირველი გაშვების ოსტატი, «აგენტის შექმნა», API) პირველივე სვლიდან თავად აყენებს, ცვლის და აუქმებს საკუთარ შეხსენებებსა და განრიგებს და ფაქტებს საკუთარ მეხსიერებაში წერს — როგორც პირადი ასისტენტის შაბლონი. ცალკეული აგენტისთვის ეს მის ბარათში («შესაძლებლობები») ითიშება. ბიბლიოთეკის შაბლონები თავად წყვეტენ, აგენტის ასლი ინარჩუნებს ორიგინალის უფლებებს, სხვა აგენტის მიერ შექმნილი აგენტები მათ გარეშე იწყებენ; არსებული აგენტები არ იცვლება. მოქმედებს შემდეგ შექმნილ აგენტზე. | | `AIHUMMER_AGENT_PROMPT_PART_MAX_CHARS` | აგენტი: მაქსიმალური სიმბოლოები პრომპტის ერთ ნაწილზე | `int 1000…1000000` | `20000` | დაუყოვნებლივ | რამდენ სიმბოლოს იღებს მოდელი აგენტის პერსონის ერთი ნაწილიდან: პროფილის განყოფილებიდან, პრომპტის ნაწილიდან ან მთავარი პრომპტიდან. უფრო გრძელ ნაწილში რჩება დასაწყისი (3/4) და დასასრული (1/4) შენიშვნით, რამდენი მოიჭრა; ეს ჩანს საუბრის ბარათსა და აგენტის პრომპტის შემადგენლობაში. სახელი, მიმართვა და პერსონის შეზღუდვები არასოდეს იჭრება. 1000–1000000; აგენტს შეიძლება ჰქონდეს საკუთარი მნიშვნელობა. | | `AIHUMMER_AGENT_PROMPT_TOTAL_MAX_CHARS` | აგენტი: მთელი პერსონის მაქსიმალური სიმბოლოები | `int 1000…2000000` | `60000` | დაუყოვნებლივ | აგენტის პერსონის საერთო ზღვარი: ყველა ნაწილი ერთად. როცა ის გადაჭარბებულია, ადგილს ჯერ ყველაზე გრძელი ნაწილები თმობენ, მოკლეები კი მთლიანი რჩება. 1000–2000000; აგენტს შეიძლება ჰქონდეს საკუთარი მნიშვნელობა. | | `AIHUMMER_AGENT_SELF_INTRO` | აგენტი: თავის წარდგენა | `enum: first_contact \\\| each_dialog \\\| never` | `first_contact` | დაუყოვნებლივ | „ერთხელ, პირველი გაცნობისას“ — აგენტი ადამიანთან პირველივე საუბარში მოკლედ წარადგენს თავს, თუ ის მაშინვე საქმეზე გადასვლას არ ითხოვს; ნაცნობ ადამიანს ხელახლა არ ეცნობა და მისალმებას ბუნებრივად პასუხობს. „არ წარადგინოს თავი“ — აგენტი საკუთარ თავს არასდროს ასახელებს თავისით. „ყოველი ახალი საუბრის დასაწყისში“ — ყოველი ახალი საუბრის დასაწყისში და ხანგრძლივი პაუზის შემდეგ, მოკლედ და წარსული საქმეების შეჯამების გარეშე. აგენტს შეიძლება თავის ბარათში («კონტექსტი და ქცევა») სხვა არჩევანი ჰქონდეს. | | `AIHUMMER_AGENT_SESSION_IDLE_RESET_MINUTES` | აგენტი: სიჩუმის შემდეგ საუბრის თავიდან დაწყება (წუთი) | `int 0…525600` | `360` | დაუყოვნებლივ | „სიჩუმის შემდეგ“ და „ყოველდღე და სიჩუმის შემდეგ“ რეჟიმებისთვის: თუ ადამიანი წერს ამაზე ხანგრძლივი სიჩუმის შემდეგ, აგენტი საუბარს თავიდან იწყებს. ეხება აგენტებს, რომელთა ბარათზე საკუთარი მნიშვნელობა არ არის მითითებული. 0 — არა სიჩუმით. 0–525600; 360 = 6 საათი, 1440 = ერთი დღე-ღამე. | | `AIHUMMER_AGENT_SESSION_INDEX_MAX_ENTRIES` | აგენტი: სიაში შეინახე არაუმეტეს ამდენი სესია | `int 0…100000` | `0` | დაუყოვნებლივ | პირველად ყველაზე მშვიდები გადიან; არაფერი იშლება. 0 — ლიმიტის გარეშე. 0–100000. მოქმედებს აგენტებზე, რომელთა ბარათში საკუთარი მნიშვნელობა არ არის. | | `AIHUMMER_AGENT_SESSION_INDEX_PRUNE_DAYS` | აგენტი: სესიების სიიდან ამოღება ამდენი მშვიდი დღის შემდეგ | `int 0…3650` | `0` | დაუყოვნებლივ | არაფერი იშლება: საუბარი ტოვებს სიას და ბრუნდება ახალი შეტყობინებით. 0 — შენახვა. 0–3650. მოქმედებს აგენტებზე, რომელთა ბარათში საკუთარი მნიშვნელობა არ არის. | | `AIHUMMER_AGENT_SESSION_RESET_AT_HOUR` | აგენტი: ყოველდღიური თავიდან დაწყების საათი | `int 0…23` | `4` | დაუყოვნებლივ | „ყოველდღე“ რეჟიმებისთვის: ამ საათამდე დაწყებული საუბარი ადამიანის შემდეგი შეტყობინებიდან თავიდან იწყება. საათი სერვერის სასაათო სარტყლით არის („სისტემა და პარამეტრების“ „სასაათო სარტყელი“). 0–23; 4 — ღამით, როცა თითქმის არავინ წერს. | | `AIHUMMER_AGENT_SESSION_RESET_GROUP_IDLE_MINUTES` | აგენტი: სიჩუმის შემდეგ ჯგუფური ჩატის თავიდან დაწყება (წუთი) | `int 0…525600` | `0` | დაუყოვნებლივ | ჯგუფური ჩატებისთვის რეჟიმებში „სიჩუმის შემდეგ“ და „ყოველდღე და სიჩუმის შემდეგ“: სიჩუმის წუთები, რის შემდეგაც ჯგუფური ჩატი თავიდან იწყება. 0 ნიშნავს როგორც პირად ჩატებში. 0–525600. | | `AIHUMMER_AGENT_SESSION_RESET_GROUP_MODE` | აგენტი: როდის იწყება ჯგუფური ჩატი თავიდან | `enum: inherit \\\| daily \\\| idle \\\| both \\\| none` | `inherit` | დაუყოვნებლივ | ცალკე წესი ჯგუფური ჩატებისთვის (Telegram-ის ჯგუფები, VK-ის საუბრები, MAX-ის ჩატები და სხვა): როგორც პირადში, ყოველდღე გადატვირთვის საათზე, სიჩუმის შემდეგ, რომელიც ადრე დადგება, ან არასდროს. გადატვირთვის საათი საერთოა. მოქმედებს აგენტებზე, რომელთა ბარათში საკუთარი წესი არ არის. | | `AIHUMMER_AGENT_SESSION_RESET_MODE` | აგენტი: როდის იწყება საუბარი თავიდან | `enum: idle \\\| daily \\\| both \\\| none` | `idle` | დაუყოვნებლივ | როდის იწყებს აგენტი საუბარს თავიდან: ყოველდღე გადატვირთვის საათზე (პარამეტრების დროის სარტყლით), სიჩუმის შემდეგ, რაც ადრე მოხდება, ან არასოდეს. თავიდან დაწყებისას აგენტი თავის მეხსიერებაში წერს ჩანაწერს წინა საუბრის შესახებ, ხოლო მისი პირველი სვლა იღებს წინა შეჯამებას და ბოლო შეტყობინებებს; თავად შეტყობინებები რჩება არქივსა და ძიებაში. ეხება აგენტებს, რომელთა ბარათზე საკუთარი წესი არ არის; იქ საერთო ჩატებისთვის ცალკე წესის დაყენებაა შესაძლებელი. | | `AIHUMMER_AGENT_SESSION_SCOPE` | აგენტი: სად ხვდება პირადი საუბრები | `enum: chat \\\| per-channel-peer \\\| per-peer` | `chat` | დაუყოვნებლივ | «ერთი ადამიანზე» აერთიანებს ერთი ადამიანის Telegram-ს, აპს და სხვა პირად ჩატებს ერთ საუბრად. ჯგუფური ჩატები ყოველთვის საკუთარს ინარჩუნებენ. მოქმედებს შემდეგი შეტყობინებიდან. მოქმედებს აგენტებზე, რომელთა ბარათში საკუთარი მნიშვნელობა არ არის. | | `AIHUMMER_AGENT_SILENT_REPLY` | აგენტი: შეუძლია გაჩუმდეს | `enum: groups \\\| all \\\| off` | `groups` | დაუყოვნებლივ | ჯგუფურ ჩატებში აგენტს შეუძლია გაჩუმდეს, თუ შეტყობინება მას არ ეხება ან დასამატებელი არაფერი აქვს; პირად მიმოწერაში ყოველთვის პასუხობს. შეგიძლიათ დუმილი პირად მიმოწერაშიც დაუშვათ ან გამორთოთ. ჩუმი სვლა არაფერს აგზავნის, საუბრის ბარათში აღინიშნება „აგენტი გაჩუმდა“, და მოდელი მას ისტორიაში ვერ ხედავს. მოქმედებს შემდეგი სვლიდან. | | `AIHUMMER_AGENT_SKILLS_PROMPT_MAX_CHARS` | აგენტი: პრომპტში უნარების სიის მაქსიმალური სიმბოლოები | `int 1000…200000` | `18000` | დაუყოვნებლივ | ყოველ სვლაზე მოდელი ხედავს არა უნარების ტექსტებს, არამედ მათ სიას: იდენტიფიკატორს, სახელს და როდის გამოიყენოს; უნარის ინსტრუქციას აგენტი თავად ტვირთავს, როცა ამოცანა შეესაბამება. თუ სია უფრო გრძელია, ჯერ აღწერები მოიხსნება, შემდეგ სიის ბოლო — დანარჩენს აგენტი მოთხოვნით იპოვის. 1000–200000. | | `AIHUMMER_AGENT_STALE_GAP_HOURS` | აგენტი: პაუზა, რის შემდეგაც წინა საუბარი ისტორიაა (საათი) | `int 0…8760` | `12` | დაუყოვნებლივ | თუ ადამიანი ამაზე ხანგრძლივი პაუზის შემდეგ წერს, აგენტი იღებს შენიშვნას: ყველაფერი, რაც ადრე განიხილეს, ისტორიაა — თხოვნის გარეშე არ გადმოიცემა და ძველი ამოცანები არ გრძელდება. ყოველი შეტყობინება ისედაც შეიცავს თავის დროს და წინადან გასულ დროს. 0 = არ მოინიშნოს. 0–8760. | | `AIHUMMER_AGENT_TOOL_HISTORY_TURNS` | აგენტი: სვლები, რომლებშიც ხელსაწყოების შედეგები ინახება | `int 0…100` | `5` | დაუყოვნებლივ | რამდენ ბოლო სვლაში ხედავს მოდელი ხელსაწყოების გამოძახებებსა და მათ შედეგებს სრულად (შედეგი ინახება 16 KB-მდე). ძველ სვლებში რჩება გამოძახება და შედეგის დასაწყისი. ასე აგენტს ახსოვს, რა იპოვა და რა გააკეთა, და ხელსაწყოებს ხელახლა არ იძახებს. 0 = შედეგები შემდეგ სვლებში არ გადავიდეს. 0–100; აგენტს შეუძლია საკუთარი მნიშვნელობის მითითება. | | `AIHUMMER_APPROVAL_TOOLS` | დადასტურების საჭიროების მქონე ხელსაწყოები | `multiselect` | — | დაუყოვნებლივ | მძიმეებით გამოყოფილი ხელსაწყოების სია, რომელთა გამოძახებაც შესრულებამდე ოპერატორის ხელით დადასტურებას მოითხოვს. ცარიელი = დადასტურება არ არის საჭირო. მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_SUBAGENT_MAX_DEPTH` | ქვე-აგენტის მაქსიმალური სიღრმე | `int 0…10` | `2` | დაუყოვნებლივ | ქვე-აგენტების ჩალაგების მაქსიმალური სიღრმე (აგენტი, რომელიც უშვებს აგენტს). ნაგულისხმევად 2 — დაცვა უსასრულო რეკურსიისგან. | | `AIHUMMER_SUBAGENT_TIMEOUT_SEC` | ქვე-აგენტის ტაიმაუტი (წამები) | `int 0…86400` | `180` | დაუყოვნებლივ | ქვე-აგენტის ერთი გაშვების მაქსიმალური დრო, წამებში. | | `AIHUMMER_TOOL_SEARCH` | ხელსაწყოების ზარმაცი ჩატვირთვა | `bool` | `false` | დაუყოვნებლივ | ხელსაწყოების სამუშაო ბირთვი მოდელს პირდაპირ ეჩვენება, ხოლო დიდი კატალოგის დანარჩენი ნაწილი იმალება საძიებო ხელსაწყოს მიღმა, რომელიც ყველა დამალულ ხელსაწყოს ასახელებს. ღირს მხოლოდ დიდ კატალოგებში (ათობით პლაგინის, MCP-ის ან OpenAPI-ის ხელსაწყო): ზომის ზღვარს ქვემოთ ყველა ხელსაწყო პირდაპირ ჩანს, რადგან ხელსაწყოს მოსაძებნად მოდელის დამატებითი გამოძახება სქემებზე ძვირია. მოქმედებს შემდეგი სვლიდან. | | `AIHUMMER_TOOL_SEARCH_CORE` | ხელსაწყოების ზარმაცი ჩატვირთვა: მუდამ ჩართული ხელსაწყოები | `multiselect` | `web_search,web_fetch,memory_search,memory_get,memory_store,search_history,search_knowledge,code_exec,process,filesystem_read,message,schedule_list,schedule_create,schedule_delete,generate_pairing_code` | დაუყოვნებლივ | ხელსაწყოები, რომლებიც ზარმაც რეჟიმში ყოველთვის პირდაპირ ჩანს. ნაგულისხმევად — სამუშაო ბირთვი: ვებძიება, გვერდების წაკითხვა, მეხსიერება, მიმოწერის ისტორია, ცოდნის ბაზა, კოდი, ფაილები, შეტყობინებები, განრიგები და აპლიკაციის დაკავშირება. მეხსიერებასა და ცოდნის ბაზაში ძიება (memory_search, memory_get, search_knowledge) ყოველთვის ჩანს, რაც არ უნდა იყოს ამ სიაში. ცარიელი სია ამ ბირთვს აღადგენს. | | `AIHUMMER_TOOL_SEARCH_MIN_POOL_TOKENS` | ხელსაწყოების ზარმაცი ჩატვირთვა: დამალული ხელსაწყოების მინიმალური მოცულობა (ტოკენები) | `int 0…1000000` | `4000` | დაუყოვნებლივ | დამალეთ ხელსაწყოები მხოლოდ მაშინ, როცა ბირთვის გარეთ არსებული სქემები ჯამში სულ მცირე ამდენ ტოკენს იწონის (თითოეული დაახლოებით 4 სიმბოლო). ამაზე ნაკლებისას ყველა ხელსაწყო პირდაპირ ჩანს: ხელსაწყოს მოსაძებნად მოდელის დამატებითი გამოძახება სქემების ჩვენებაზე ძვირია. | | `AIHUMMER_TOOL_SEARCH_THRESHOLD` | ხელსაწყოების ზარმაცი ჩატვირთვა: გადადებისთვის მინიმალური ხელსაწყოები | `int 0…1000` | `12` | დაუყოვნებლივ | გადადოს ჩატვირთვა მხოლოდ მაშინ, თუ აგენტის პროფილის ფილტრის შემდეგ ამ რაოდენობაზე მეტი ინსტრუმენტი რჩება. | ## Agent · Reasoning | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AGENT_BEST_OF_N` | საუკეთესო N-დან: ვარიანტების რაოდენობა | `int 0…8` | `0` | დაუყოვნებლივ | აგენტი ამდენ პასუხის ვარიანტს ამზადებს და საუკეთესოს ტოვებს. 0 ან 1 — გამორთულია, 2-დან — ჩართულია. თითო ვარიანტი ცალკე პასუხად ღირს. | | `AIHUMMER_AGENT_DEBATE_JUDGE_PROMPT` | დებატები: მსაჯის მოთხოვნა (გადაფარვა) | `text` | — | დაუყოვნებლივ | გადაფარავს დებატების მსაჯის პრომპტს (ცარიელი = ჩაშენებული). | | `AIHUMMER_AGENT_DEBATE_N` | დებატი: პასუხის ვარიანტების რაოდენობა | `int 0…8` | `0` | დაუყოვნებლივ | აგენტი ამდენ პასუხის ვარიანტს ამზადებს, ადარებს მათ და საუკეთესოს იძლევა. 0 ან 1 — გამორთულია, 2-დან — ჩართულია. თითო ვარიანტი ცალკე პასუხად ღირს. | | `AIHUMMER_AGENT_DEBATE_PROMPT` | დებატები: კანდიდატის მოთხოვნა (გადაფარვა) | `text` | — | დაუყოვნებლივ | გადაფარავს დებატების კანდიდატის პრომპტს (ცარიელი = ჩაშენებული). | | `AIHUMMER_AGENT_DEBATE_ROUNDS` | დებატები: რაუნდები | `int 1…10` | `1` | დაუყოვნებლივ | კანდიდატების პანელისთვის დებატების რაუნდების რაოდენობა. | | `AIHUMMER_AGENT_JUDGE_PROMPT` | Best-of-N მსაჯის მოთხოვნა (გადაფარვა) | `text` | — | დაუყოვნებლივ | გადაფარავს best-of-N მსაჯის პრომპტს (ცარიელი = ჩაშენებული). | | `AIHUMMER_AGENT_PLAN_PROMPT` | დამგეგმავის მოთხოვნა (გადაფარვა) | `text` | — | დაუყოვნებლივ | გადაფარავს დამგეგმავის პრომპტს (ცარიელი = ჩაშენებული). | | `AIHUMMER_AGENT_PLAN_STEPS` | დამგეგმავ-შემსრულებელი: გეგმის მაქს. ნაბიჯები (0=გამორთ.) | `int 0…32` | `0` | დაუყოვნებლივ | ⟩0 უშვებს ცალკე გავლას დამგეგმავი→შემსრულებელი→სინთეზი (გამოსადეგია რთული, მრავალნაბიჯიანი ამოცანებისთვის). 0 გამორთავს. ჩვეულებრივ 4–8. | | `AIHUMMER_AGENT_PLAN_STEP_ITERS` | დამგეგმავი: ხელსაწყოს იტერაციები თითო ნაბიჯზე (0=ნაგულისხმევი) | `int 0…64` | `0` | დაუყოვნებლივ | ზღუდავს ინსტრუმენტების გამოძახების იტერაციებს გეგმის ერთ ნაბიჯზე. 0 = ჩაშენებული ნაგულისხმევი მნიშვნელობა (4). | | `AIHUMMER_AGENT_REFLECT` | თვით-კრიტიკის გავლა | `bool` | `0` | დაუყოვნებლივ | ამატებს რეფლექსიის/თვითკრიტიკის გავლას საბოლოო პასუხამდე. | | `AIHUMMER_AGENT_REFLECT_PROMPT` | რეფლექსიის მოთხოვნა (გადაფარვა) | `text` | — | დაუყოვნებლივ | გადაფარავს თვითკრიტიკის პრომპტს (ცარიელი = ჩაშენებული). | | `AIHUMMER_AGENT_SELF_HEAL` | თვით-აღდგენა: ხელსაწყოს შეცდომაზე ხელახლა ცდები (0=გამორთ.) | `int 0…10` | `0` | დაუყოვნებლივ | ⟩0 იმეორებს ჩავარდნილ ინსტრუმენტების გამოძახებებს მაკორექტირებელი მინიშნებით, ამ ზღვრამდე. | ## Agent · System prompt | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_LOCALE` | ნაგულისხმევი ლოკალი | `enum: ru-RU \\\| en-US \\\| az-AZ \\\| hy-AM \\\| be-BY \\\| kk-KZ \\\| ky-KG \\\| tg-TJ \\\| tk-TM \\\| uz-UZ \\\| ka-GE \\\| ro-RO \\\| es-ES \\\| zh-CN \\\| fr-FR \\\| de-DE \\\| hi-IN \\\| pl-PL \\\| lt-LT \\\| lv-LV \\\| et-EE \\\| fi-FI \\\| sv-SE \\\| no-NO \\\| da-DK \\\| tr-TR \\\| mn-MN` | `ru-RU` | დაუყოვნებლივ | პასუხის ნაგულისხმევი ენა/ლოკალი, მაგ. ru-RU. პერსონის/ოპერატორის ინსტრუქციები უფრო მაღალი პრიორიტეტისაა. | | `AIHUMMER_TIMEZONE` | დროის სარტყელი | `text` | `UTC` | დაუყოვნებლივ | IANA დროის სარტყელი აგენტის მიმდინარე თარიღისთვის და საკუთარი სარტყლის არმქონე განრიგებისთვის, მაგ. Europe/Moscow. ნაგულისხმევად UTC. | ## Channels | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_CHANNEL_FAILURE_NOTICE` | თანამოსაუბრის ინფორმირება პასუხის ჩავარდნისას | `enum: always \\\| once \\\| off` | `always` | დაუყოვნებლივ | რას იღებს არხში (Telegram და სხვ.) თანამოსაუბრე, როცა აგენტმა ვერ უპასუხა: „ყოველ ჯერზე“ — მოკლე შეტყობინება მის ენაზე; „არაუმეტეს 4 საათში ერთხელ“ — ერთი შეტყობინება საუბარზე 4 საათში; „არ შეატყობინოს“ — არაფერი. შეტყობინებაში არ არის შეცდომის კოდები და მომწოდებლების სახელები; დეტალებს ხედავთ „სესიებში“ და შეტყობინებებში. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BLOCKED` | შეტყობინება წარუმატებლობისას: ინსტანსი შეჩერებულია | `text` | — | დაუყოვნებლივ | დატოვეთ ცარიელი — გაიგზავნება ჩაშენებული შეტყობინება თანამოსაუბრის ენაზე. თქვენი ტექსტი იგზავნება ისე, როგორც დაწერილია, იმ ენაზე, რომელზეც დაწერეთ; {ref} ჩასვამს პასუხის კოდს, რომლითაც სვლას „სესიებში“ იპოვით. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BUDGET` | შეტყობინება წარუმატებლობისას: მფლობელის ბიუჯეტი ამოიწურა | `text` | — | დაუყოვნებლივ | დატოვეთ ცარიელი — გაიგზავნება ჩაშენებული შეტყობინება თანამოსაუბრის ენაზე. თქვენი ტექსტი იგზავნება ისე, როგორც დაწერილია, იმ ენაზე, რომელზეც დაწერეთ; {ref} ჩასვამს პასუხის კოდს, რომლითაც სვლას „სესიებში“ იპოვით. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_BUSY` | შეტყობინება წარუმატებლობისას: კარიბჭე გადატვირთულია | `text` | — | დაუყოვნებლივ | დატოვეთ ცარიელი — გაიგზავნება ჩაშენებული შეტყობინება თანამოსაუბრის ენაზე. თქვენი ტექსტი იგზავნება ისე, როგორც დაწერილია, იმ ენაზე, რომელზეც დაწერეთ; {ref} ჩასვამს პასუხის კოდს, რომლითაც სვლას „სესიებში“ იპოვით. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_CONFIG` | შეტყობინება წარუმატებლობისას: მოდელის კავშირს მფლობელი სჭირდება | `text` | — | დაუყოვნებლივ | დატოვეთ ცარიელი — გაიგზავნება ჩაშენებული შეტყობინება თანამოსაუბრის ენაზე. თქვენი ტექსტი იგზავნება ისე, როგორც დაწერილია, იმ ენაზე, რომელზეც დაწერეთ; {ref} ჩასვამს პასუხის კოდს, რომლითაც სვლას „სესიებში“ იპოვით. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_FAILED` | შეტყობინება წარუმატებლობისას: სხვა შეცდომა | `text` | — | დაუყოვნებლივ | დატოვეთ ცარიელი — გაიგზავნება ჩაშენებული შეტყობინება თანამოსაუბრის ენაზე. თქვენი ტექსტი იგზავნება ისე, როგორც დაწერილია, იმ ენაზე, რომელზეც დაწერეთ; {ref} ჩასვამს პასუხის კოდს, რომლითაც სვლას „სესიებში“ იპოვით. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_QUOTA` | შეტყობინება წარუმატებლობისას: მოდელის გამოყენების ლიმიტი ამოიწურა | `text` | — | დაუყოვნებლივ | დატოვეთ ცარიელი — გაიგზავნება ჩაშენებული შეტყობინება თანამოსაუბრის ენაზე. თქვენი ტექსტი იგზავნება ისე, როგორც დაწერილია, იმ ენაზე, რომელზეც დაწერეთ; {ref} ჩასვამს პასუხის კოდს, რომლითაც სვლას „სესიებში“ იპოვით. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_STEP_LIMIT` | შეტყობინება წარუმატებლობისას: დავალება ერთ პასუხში ვერ ჩაეტია | `text` | — | დაუყოვნებლივ | დატოვეთ ცარიელი — გაიგზავნება ჩაშენებული შეტყობინება თანამოსაუბრის ენაზე. თქვენი ტექსტი იგზავნება ისე, როგორც დაწერილია, იმ ენაზე, რომელზეც დაწერეთ; {ref} ჩასვამს პასუხის კოდს, რომლითაც სვლას „სესიებში“ იპოვით. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_TOO_LONG` | შეტყობინება წარუმატებლობისას: საუბარი ზედმეტად გრძელია მოდელისთვის | `text` | — | დაუყოვნებლივ | დატოვეთ ცარიელი — გაიგზავნება ჩაშენებული შეტყობინება თანამოსაუბრის ენაზე. თქვენი ტექსტი იგზავნება ისე, როგორც დაწერილია, იმ ენაზე, რომელზეც დაწერეთ; {ref} ჩასვამს პასუხის კოდს, რომლითაც სვლას „სესიებში“ იპოვით. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_CHANNEL_FAILURE_TEXT_UNAVAILABLE` | შეტყობინება წარუმატებლობისას: მოდელი დროებით მიუწვდომელია | `text` | — | დაუყოვნებლივ | დატოვეთ ცარიელი — გაიგზავნება ჩაშენებული შეტყობინება თანამოსაუბრის ენაზე. თქვენი ტექსტი იგზავნება ისე, როგორც დაწერილია, იმ ენაზე, რომელზეც დაწერეთ; {ref} ჩასვამს პასუხის კოდს, რომლითაც სვლას „სესიებში“ იპოვით. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_CONFIDENTIAL_PERSONA` | კონფიდენციალური ვებ-პერსონა | `bool` | `0` | დაუყოვნებლივ | როცა ჩართულია, ვებ-ჩატის აგენტი არ ამხელს და არ ინახავს თავისი პერსონის/იდენტობის დეტალებს და პასუხობს მკაცრად დავალების ფარგლებში — გამოიყენეთ ანონიმური ან კონფიდენციალურობისთვის მგრძნობიარე ვებ-განთავსებებისთვის. მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_INBOUND_COALESCE_MS` | შეტყობინებების გაერთიანების ფანჯარა (მწმ) | `int` | `500` | დაუყოვნებლივ | რამდენიმე შეტყობინება, რომელსაც ერთი ადამიანი ზედიზედ აგზავნის ერთსა და იმავე ჩატში (მოკლე შეტყობინებები, ფოტოალბომი, სწრაფი შესწორება), იღებს ერთ პასუხს, თუ მათ შორის პაუზა ამ ფანჯარაზე მოკლეა. პასუხის მომზადებისას მიღებულ შეტყობინებებს პასუხი ეცემა მის შემდეგ დაუყოვნებლივ, არასდროს პარალელურად. ნაგულისხმევი 500 მწმ; 0 = ლოდინის გარეშე ცალკეულ შეტყობინებებს შორის; ფოტოალბომი მაინც გროვდება (პაუზები 3 წმ-მდე, მაქსიმუმ 20 წმ), რომ ერთი პასუხი მიიღოს. გაერთიანება მუშაობს Telegram-ში; Slack, WhatsApp, VK, ელფოსტა და სხვა კონექტორები, რომლებიც ყოველ შეტყობინებაზე პასუხს ელიან (და ინტეგრაციები /v1/inbound/generic-ით), პასუხს იღებენ ყოველ შეტყობინებაზე — კვლავ სათითაოდ და რიგის მიხედვით. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_INBOUND_EDIT_MODE` | როცა ადამიანი არედაქტირებს უკვე პასუხგაცემულ შეტყობინებას | `enum: correct \\\| history` | `correct` | დაუყოვნებლივ | correct — ბოტი ხელახლა პასუხობს და იცის, რომ ეს შესწორებაა („იყო / არის“); history — რედაქტირება მხოლოდ საუბრის ისტორიას ასწორებს, ახალი პასუხი არ არის (მოსახერხებელია ბეჭდვითი შეცდომებისთვის). იმ შეტყობინების რედაქტირება, რომელსაც ბოტმა ჯერ არ უპასუხა, ყოველთვის უბრალოდ ცვლის მის ტექსტს. მუშაობს იქ, სადაც არხი რედაქტირებას იტყობინება (Telegram). მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_INBOUND_QUEUE_MODE` | შეტყობინებები, რომლებიც იწერება, როცა აგენტი მუშაობს | `enum: steer \\\| collect \\\| followup` | `steer` | დაუყოვნებლივ | რა ემართება შეტყობინებას, რომელსაც იგივე ადამიანი აგზავნის, სანამ აგენტი ჯერ კიდევ ამზადებს პასუხს (ეძებს, უშვებს ხელსაწყოებს): steer (ნაგულისხმევი) — აგენტი ხედავს მას შემდეგ ნაბიჯამდე და ითვალისწინებს იმავე პასუხში; collect — მას პასუხობს შემდეგი პასუხი. followup — ყოველი ასეთი შეტყობინება რიგრიგობით საკუთარ პასუხს იღებს. ფოტოები, ფაილები, პასუხები შეტყობინებაზე და გადაგზავნილები ყოველთვის ელოდება შემდეგ პასუხს. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_INBOUND_REQUIRE_BINDING` | პასუხის გაცემა მხოლოდ რეგისტრირებულ მომხმარებლებზე | `bool` | `true` | დაუყოვნებლივ | true = ბოტი უგულებელყოფს არხის ნებისმიერ გამომგზავნს, რომელიც არ არის AiHummer-ის რეგისტრირებული მომხმარებელი (მომხმარებელი როლის მიბმით) — ჩატის შემთხვევითი მონაწილეები და სტუმრების გამოძახებები პასუხს ვერ მიიღებენ. false (ნაგულისხმევად) = პასუხი ყველას. | ## Integrations | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_A2A_PUBLISH` | აგენტის გამოქვეყნება Agent2Agent-ის (A2A) მეშვეობით | `bool` | `0` | გადატვირთვის შემდეგ | აგენტის გამოქვეყნება A2A-სერვერად (Agent Card + POST /a2a/message). მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_MCP_EXPORT_TOOLS` | გარე ასისტენტებისთვის გახსნილი ხელსაწყოები | `multiselect` | — | გადატვირთვის შემდეგ | გარე MCP კლიენტებისთვის დაშვებული ხელსაწყოების სახელების აშკარა სია, გამოყოფილი მძიმეებით. ცარიელი = არ გამოაქვეყნოთ რაიმე ინსტრუმენტი. სახიფათო ჰოსტის დონის კლასები დამატებით აკრძალულია ჩაშენებული პოლიტიკით, თუნდაც ჩამოთვლილი იყოს. ვრცელდება დაწყებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_MCP_PUBLISH` | ხელსაწყოების გამოქვეყნება MCP-ის მეშვეობით | `bool` | `0` | გადატვირთვის შემდეგ | გარე ასისტენტებს (მაგ. Claude Desktop) თქვენი აგენტების ხელსაწყოებით სარგებლობის საშუალებას აძლევს. რომელი ხელსაწყოები გაიხსნას, მეზობელ პარამეტრში ირჩევა: სანამ სია ცარიელია, არცერთი არ იხსნება. | | `AIHUMMER_MODULE_CPU_QUOTA` | პლაგინის პროცესორის ლიმიტი (თითოეულზე) | `text` | `75%` | დაუყოვნებლივ | პროცესორის რა წილი შეუძლია დაიკავოს თითოეულ პლაგინს (systemd CPUQuota): 75% — ერთი ბირთვის სამი მეოთხედი, 150% — ერთნახევარი ბირთვი. ახალ მნიშვნელობას პლაგინი მიიღებს შემდეგი დაყენების, განახლების ან მისი პარამეტრების შენახვისას; მანამდე მომუშავე პლაგინები ძველი ლიმიტით მუშაობენ. | | `AIHUMMER_MODULE_MEMORY_MAX` | პლაგინის მეხსიერების ლიმიტი (თითოეულზე) | `text` | `512M` | დაუყოვნებლივ | რამდენი მეხსიერება შეუძლია დაიკავოს თითოეულ პლაგინს (systemd MemoryMax): ზომა, მაგალითად 512M, 1G ან 2048M (არანაკლებ 64M), ან infinity — ლიმიტის გარეშე. ლიმიტის გადამჭარბებელ პლაგინს სისტემა გააჩერებს. ახალ მნიშვნელობას პლაგინი მიიღებს შემდეგი დაყენების, განახლების ან მისი პარამეტრების შენახვისას; მანამდე მომუშავე პლაგინები ძველი ლიმიტით მუშაობენ. | ## Knowledge connectors | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_KB_SYNC_INTERVAL` | რამდენად ხშირად განახლდეს ცოდნის ბაზა წყაროებიდან | `text` | — | დაუყოვნებლივ | რამდენად ხშირად იღებს სერვერი თავად ცვლილებებს ცოდნის ბაზის დაკავშირებული წყაროებიდან. მაგალითად: 30m — ყოველ 30 წუთში, 6h — ყოველ 6 საათში. ცარიელი ან 0 — მხოლოდ ხელით. ხელახალი ჩატვირთვა დუბლიკატებს არ ქმნის. Slack-ის ექსპორტი ხელით იტვირთება. | ## LLM | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AUX_FALLBACK_MODELS` | სერვისული ამოცანები: სარეზერვო მოდელები | `list` | — | დაუყოვნებლივ | მძიმით გამოყოფილი მოდელები, რომლებიც რიგრიგობით იცდება, თუ სერვისული მოდელი ვერ შესრულდა (კვოტა, გაუმართაობა). ბოლოს ყოველთვის იცდება ძირითადი მოდელი, რომ რეზიუმე არ დაიკარგოს. ყოველი გადართვა ჟურნალში იწერება. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_AUX_MODEL` | სერვისული ამოცანების მოდელი (რეზიუმეები, ჩანაწერები, სათაურები) | `text` | — | დაუყოვნებლივ | ფონური სერვისული ამოცანების მოდელი: ძველი ისტორიის რეზიუმედ შეკუმშვა, მეხსიერების ჩანაწერი შეკუმშვამდე, საუბრების სათაურები, ფაქტების ამოღება, საძიებო მოთხოვნების პერიფრაზირება და თარგმანი. ცარიელი = ავტომატურად: იმავე მომწოდებლის უფრო იაფი მოდელი (Claude → claude-haiku-4-5, Codex → gpt-…-luna/mini); თუ ასეთი არ არის — ძირითადი მოდელი. „main“ — ყოველთვის ძირითადი მოდელი. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_CASCADE_MIN_CHARS` | კასკადი: ესკალაციისთვის მინიმალური სიმბოლოები | `int` | `0` | დაუყოვნებლივ | მოთხოვნის სიგრძის ზღვარი (სიმბოლოებში), რომლიდანაც კასკადის უფრო ძლიერი მოდელი ერთვება. 0 = ნაგულისხმევი. | | `AIHUMMER_CASCADE_STRONG_MODEL` | კასკადი: უფრო ძლიერი სარეზერვო მოდელი | `text` | — | დაუყოვნებლივ | მოდელი, რომელზეც კასკადურად ხდება გადართვა გრძელი/რთული მოთხოვნებისთვის (ცარიელი = გამორთულია). | | `AIHUMMER_CLAUDE_AUTH_URL` | Claude-ის გამოწერა: შესვლის გვერდის მისამართი | `text` | — | დაუყოვნებლივ | გვერდი, სადაც Claude-ის გამოწერის დაკავშირების ნებას რთავთ. ცარიელი — სტანდარტული მისამართი; შეცვალეთ მხოლოდ მხარდაჭერის თხოვნით. | | `AIHUMMER_CLAUDE_CLIENT_ID` | Claude გამოწერა: OAuth კლიენტის ID | `text` | — | დაუყოვნებლივ | Claude-ის გამოწერით შესასვლელი აპის იდენტიფიკატორი. ცარიელი — სტანდარტული; შეცვალეთ მხოლოდ მხარდაჭერის თხოვნით. | | `AIHUMMER_CLAUDE_EFFORT` | Claude: ფიქრის სიღრმე | `enum: low \\\| medium \\\| high \\\| xhigh \\\| max` | `medium` | დაუყოვნებლივ | რამდენად ღრმად ფიქრობენ Claude-ის მოდელები პასუხამდე, როცა აგენტი ამას არ ადგენს. მაღალი უფრო ზუსტია რთულ ამოცანებზე, მაგრამ უფრო ნელია და მეტ კვოტას ხარჯავს; დაბალი უფრო სწრაფი და იაფია. მოდელი, რომელმაც არჩეული დონე არ იცის, უახლოეს დაბალ დონეს იღებს; Haiku 4.5 და უფრო ძველი მოდელები ფიქრს არ უჭერენ მხარს. აგენტზე დაყენებული სიღრმე უპირატესია. მოქმედებს მომდევნო სვლიდან. | | `AIHUMMER_CLAUDE_MAX_TOKENS` | Claude: პასუხის მაქსიმალური სიგრძე (ტოკენი) | `int` | `16000` | დაუყოვნებლივ | რამდენი ტოკენი შეიძლება დაიკავოს Claude-ის ერთმა პასუხმა — გამოწერითაც და გასაღებითაც. მოდელის ფიქრი იმავე ლიმიტში ითვლება: ძალიან მცირე მნიშვნელობა პასუხს შუა წინადადებაში წყვეტს ან ცარიელ პასუხს იძლევა. თუ აგენტს საკუთარი პასუხის სიგრძე აქვს, ის მოქმედებს. | | `AIHUMMER_CLAUDE_REDIRECT_URI` | Claude გამოწერა: გადამისამართება URI | `text` | — | დაუყოვნებლივ | მომწოდებელთან რეგისტრირებული დაბრუნების მისამართი. უნდა ემთხვეოდეს იმას, რაც კონფიგურებულია მის მხარეს, წინააღმდეგ შემთხვევაში კოდის გაცვლა უარყოფილია. | | `AIHUMMER_CLAUDE_TOKEN_URL` | Claude-ის გამოწერა: წვდომის მიღების მისამართი | `text` | — | დაუყოვნებლივ | მისამართი, საიდანაც სერვერი იღებს და აგრძელებს Claude-ის გამოწერაზე წვდომას. ცარიელი — სტანდარტული მისამართი; შეცვალეთ მხოლოდ მხარდაჭერის თხოვნით. | | `AIHUMMER_CODEX_BASE_URL` | Codex-ის ბაზისური URL | `text` | — | ნაწილობრივ გადატვირთვის შემდეგ | Codex-ის (ChatGPT-ის გამოწერა) ტრანსპორტის ბაზა. მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_CODEX_MAX_OUTPUT_TOKENS` | მაქს. გამომავალი ტოკენები (0 = ლიმიტის გარეშე) | `int` | `0` | დაუყოვნებლივ | max_output_tokens-ის ზღვარი ჩატის ერთი სვლისთვის. 0 = ზღვრის გარეშე. reasoning-მოდელებთან მსჯელობის ტოკენებიც ამ ბიუჯეტში ითვლება, ამიტომ ძალიან მცირე მნიშვნელობა ცარიელ პასუხს იძლევა — „incomplete: max_output_tokens“. მოქმედებს მაშინვე (გადატვირთვის გარეშე). | | `AIHUMMER_CODEX_MODEL` | მოდელის id (Codex / gpt-5.5 ტრანსპორტი) | `text` | `gpt-5.5` | ნაწილობრივ გადატვირთვის შემდეგ | ძირითადი Codex/ChatGPT ტრანსპორტის მოდელის იდენტიფიკატორი (მაგ. gpt-5.5, gpt-5.5-codex). მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_CODEX_REASONING_EFFORT` | მსჯელობის ინტენსივობა | `enum: none \\\| low \\\| medium \\\| high \\\| xhigh` | `medium` | დაუყოვნებლივ | რამდენად ღრმად ფიქრობს ChatGPT (Codex) მოდელი პასუხამდე, თუ აგენტს ეს არ აქვს მითითებული. ნაგულისხმევად — „საშუალო“. მაღალი — უფრო ზუსტი, მაგრამ ნელი და ძვირი. | | `AIHUMMER_LLM_CALL_TIMEOUT_S` | ერთი გამოძახების ტაიმაუტი (წამები) | `int` | `120` | დაუყოვნებლივ | რამდენი წამი დაველოდოთ მოდელის პასუხს ერთ მოთხოვნაზე. თუ მოდელი მეტხანს დუმს, მოთხოვნა წყდება და პასუხი სიის შემდეგ მოდელზე გადადის. Claude-სთვის ითვლება პაუზა პასუხის ნაკადში და არა მთელი პასუხი: გრძელი, მაგრამ მიმდინარე პასუხი არ წყდება. 0 — შეზღუდვის გარეშე. | | `AIHUMMER_LLM_FALLBACK_MODELS` | სარეზერვო მოდელები (ყველა აგენტისთვის) | `text` | `auto` | დაუყოვნებლივ | ვინ პასუხობს, როცა მთავარი მოდელი და დანარჩენი მომწოდებლები უარს ამბობენ (გამოყენების ლიმიტი ამოიწურა, გაუმართაობა, ზედმეტად ბევრი მოთხოვნა). auto — თითოეული მომწოდებლის უფრო იაფი მოდელი, როგორც ბოლო რეზერვი (Claude: claude-haiku-4-5, Codex: gpt-…-luna/mini); მძიმით გამოყოფილი სია — თქვენი საკუთარი რიგი, თითოეული მოდელი მიდის თავისი მწარმოებლის მომწოდებლებთან; off — სარეზერვო მოდელების გარეშე. აგენტის საკუთარ სარეზერვო მოდელს უპირატესობა აქვს. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_LLM_GATEWAY_URL` | LLM-კარიბჭის URL | `text` | — | ნაწილობრივ გადატვირთვის შემდეგ | OpenAI-თავსებადი მოდელის ენდპოინტის საბაზისო URL, რომელსაც აგენტი მიმართავს (თქვენი ლოკალური llama.cpp/vLLM/Ollama სერვერი ან განთავსებული გეითვეი). დატოვეთ ცარიელი, რომ პროვაიდერის ნაგულისხმევი ენდპოინტი გამოიყენოთ. | | `AIHUMMER_LLM_MODEL` | LLM მოდელი | `text` | — | ნაწილობრივ გადატვირთვის შემდეგ | მოდელის სახელი/იდენტიფიკატორი, რომელიც პროვაიდერს ეგზავნება ყოველ სვლაზე (მოდელი, რომელსაც თქვენი ენდპოინტი გასცემს). უნდა ემთხვეოდეს მოდელს, რომელსაც ენდპოინტი რეალურად სთავაზობს. | | `AIHUMMER_LLM_PAUSE_AUTH_MIN` | პაუზა ანგარიშის მონაცემების უარყოფის შემდეგ, წთ | `int` | `10` | დაუყოვნებლივ | რამდენი წუთი არ მივმართოთ მიმწოდებელს, რომელმაც ანგარიშის მონაცემები უარყო. გამეორება პაუზას აორმაგებს, მაგრამ არა უმეტეს ექვსმაგისა. კავშირის წარმატებული შემოწმება და ღილაკი „ახლავე გაგრძელება“ მიმწოდებელს მაშინვე აბრუნებს. მოქმედებს შემდეგი უარიდან. | | `AIHUMMER_LLM_PAUSE_MODEL_MIN` | მიმწოდებლის მიერ მიუწოდებელი მოდელის პაუზა, წთ | `int` | `60` | დაუყოვნებლივ | რამდენი წუთი არ შევთავაზოთ მიმწოდებელს მოდელი, რომელსაც, მისივე თქმით, არ ემსახურება; მის სხვა მოდელებს ჩვეულებრივ მივმართავთ. მოქმედებს შემდეგი უარიდან. | | `AIHUMMER_LLM_PAUSE_QUOTA_MIN` | პაუზა ლიმიტის ამოწურვის შემდეგ, წთ | `int` | `300` | დაუყოვნებლივ | რამდენი წუთი არ მივმართოთ მოდელს (ან მთელ ანგარიშს, თუ ანგარიშის ლიმიტია ამოწურული — Codex, OpenAI-ის გასაღები, გადახდა), როცა გამოყენების ლიმიტი ამოიწურა და მიმწოდებელმა განახლების ვადა არ დაასახელა. გამეორება პაუზას აორმაგებს, მაგრამ არა უმეტეს ერთი დღე-ღამისა. მიმწოდებლის დასახელებული ვადა უპირატესია. მოქმედებს შემდეგი უარიდან. | | `AIHUMMER_LLM_PAUSE_SHORT_S` | მიმწოდებლის პაუზა გაუმართაობის შემდეგ, წმ | `int` | `30` | დაუყოვნებლივ | რამდენი წამი არ მივმართოთ მიმწოდებელს გაუმართაობის, კავშირის გაწყვეტის ან „ზედმეტად ხშირი“ პასუხის შემდეგ. ზედიზედ მეორე უარი პაუზას აორმაგებს, მესამე და შემდეგი — ათმაგებს. თუ მიმწოდებელმა ვადა თავად დაასახელა, მას ველოდებით. მოქმედებს შემდეგი უარიდან. | | `AIHUMMER_LLM_PROVIDER` | LLM პროვაიდერი | `text` | — | ნაწილობრივ გადატვირთვის შემდეგ | რომელი მოდელის ბექენდი გამოვიყენოთ (OpenAI-თავსებადი ენდპოინტი თუ Codex/ChatGPT-ის გამოწერის ტრანსპორტი). განსაზღვრავს, როგორ იგზავნება და ავტორიზდება მოთხოვნები. | | `AIHUMMER_LLM_RETRIES` | LLM-ის ხელახლა ცდები დროებით შეცდომაზე | `int` | `3` | დაუყოვნებლივ | LLM-ის მოთხოვნის გამეორებების რაოდენობა დროებითი შეცდომისას. | | `AIHUMMER_LLM_TEMPERATURE` | ტემპერატურა | `text` | — | დაუყოვნებლივ | რამდენად მრავალფეროვნად პასუხობს მოდელი (0–2), თუ აგენტს ეს არ აქვს მითითებული: ნაკლები — უფრო ზუსტი და პროგნოზირებადი, მეტი — უფრო ცოცხალი. ცარიელი — მოდელი თავად წყვეტს. მოაზროვნე მოდელები (ChatGPT/Codex, Claude მე-5 თაობა) მას არ იღებენ — მათთვის ველი ცარიელი დატოვეთ. | | `AIHUMMER_LLM_TOP_P` | Top-p (ბირთვის ნიმუშის აღება) | `text` | — | დაუყოვნებლივ | პასუხების მრავალფეროვნების კიდევ ერთი გზა (0–1), თუ აგენტს ეს არ აქვს მითითებული. ცარიელი — მოდელი თავად წყვეტს. ჩვეულებრივ ერთს უთითებენ: ან ტემპერატურას, ან ამას; მოაზროვნე მოდელები მას არ იღებენ. | | `AIHUMMER_MODEL_GUARD_INTERVAL_MIN` | აგენტის მოდელის შემოწმება: ინტერვალი, წთ | `int` | `60` | დაუყოვნებლივ | რამდენად ხშირად შემოწმდეს, რომ ყოველი აგენტის მოდელს გვთავაზობს ჩართული მომწოდებელი. აგენტის მოდელი არასოდეს იცვლება: სანამ მას არავინ გვთავაზობს, პასუხობს პასუხის რიგის პირველი მოდელი, რომელიც პაუზაზე არ არის, შეტყობინება ასახელებს აგენტებს — და კიდევ ერთი, როცა მათი მოდელი დაბრუნდება. შემოწმება ყოველთვის ხდება კარიბჭის გაშვებისას, ხოლო 0 თიშავს მხოლოდ გამეორებას. ახალი პერიოდი ერთი წუთის განმავლობაში ამოქმედდება. | | `AIHUMMER_OPENAI_API` | OpenAI API-ის სტილი (chat \| responses) | `enum: \\\| chat \\\| responses` | — | ნაწილობრივ გადატვირთვის შემდეგ | chat = /chat/completions, responses = /responses. ცარიელი = ავტომატური/ნაგულისხმევი. მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_OPENAI_API_KEY` | მშობლიური OpenAI API-გასაღები (ინსტალაციის ნაგულისხმევი) | `text` | — | ნაწილობრივ გადატვირთვის შემდეგ | თქვენი OpenAI-ანგარიშის გასაღები ნატიური OpenAI-ციკლისთვის (თუ OpenAI-ს ნაგულისხმევ პროვაიდერად იყენებთ). არ აგერიოთ სამუშაო სივრცის BYOK-თან გვერდზე „მოდელები“. მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_OPENAI_BASE_URL` | მშობლიური OpenAI-ის ბაზისური URL | `text` | — | გადატვირთვის შემდეგ | OpenAI-თავსებადი API-ის ბაზა (მაგ. https://api.openai.com/v1). მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_OPENAI_MODEL` | მშობლიური OpenAI მოდელი | `text` | — | გადატვირთვის შემდეგ | მოდელი ნატიური OpenAI-ციკლისთვის (როცა AIHUMMER_OPENAI_API_KEY მითითებულია). მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_ROUTER_COMPLEX_MODEL` | როუტერი: მოდელი რთული მიმართვებისთვის | `text` | — | დაუყოვნებლივ | მოდელი საკუთარი მოდელის არმქონე აგენტის რთული მოთხოვნებისთვის (ცარიელი = დონე გამორთულია). მოქმედებს შემდეგი სვლიდან. | | `AIHUMMER_ROUTER_SIMPLE_MODEL` | როუტერი: მოდელი მარტივი მიმართვებისთვის | `text` | — | დაუყოვნებლივ | მოდელი საკუთარი მოდელის არმქონე აგენტის მარტივი მოთხოვნებისთვის (ცარიელი = დონე გამორთულია). მოქმედებს შემდეგი სვლიდან. | | `AIHUMMER_ROUTER_STANDARD_MODEL` | როუტერი: მოდელი სტანდარტული მიმართვებისთვის | `text` | — | დაუყოვნებლივ | მოდელი საკუთარი მოდელის არმქონე აგენტის ჩვეულებრივი მოთხოვნებისთვის (ცარიელი = დონე გამორთულია). მოქმედებს შემდეგი სვლიდან. | | `AIHUMMER_SUBSCRIPTION_QUOTA_REFRESH_MIN` | გამოწერების კვოტები: გამოკითხვის პერიოდი, წთ | `int` | `15` | დაუყოვნებლივ | რამდენად ხშირად ეკითხება პანელი ChatGPT-ს (Codex) გამოწერის კვოტის ფანჯრებს: პერიოდში მაქსიმუმ ერთხელ, 5 წუთზე უფრო ხშირად არა და მხოლოდ მაშინ, როცა კვოტები გახსნილია; შუალედში ნაჩვენებია შენახული ასლი. Claude-ს არასოდეს ვეკითხებით: მისი ლიმიტები ჩვენი შეფასებაა. მოქმედებს კვოტების შემდეგი გახსნიდან. | ## Media | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_DEEPGRAM_API_KEY` | Deepgram API-გასაღები | `text` | — | დაუყოვნებლივ | Deepgram-ის სერვისის გასაღები — საჭიროა, თუ ხმოვან შეტყობინებებს Deepgram ამოიცნობს. ცარიელის შემთხვევაში გამოიყენება მეზობელი პარამეტრის საერთო გასაღები. მოქმედებს მაშინვე. | | `AIHUMMER_DEEPGRAM_DETECT_LANGUAGE` | Deepgram ენის ამოცნობა | `bool` | `0` | დაუყოვნებლივ | ენის ამოცნობა ფიქსირებული ენის გაგზავნის ნაცვლად. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_DEEPGRAM_MODEL` | Deepgram მოდელი | `text` | `nova-2` | დაუყოვნებლივ | Deepgram-ის მოდელი (მაგ. nova-2, nova-3, base). დამოკიდებულია იმაზე, რა წვდომა აქვს პროექტს ამ გასაღებით. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_DEEPGRAM_PUNCTUATE` | Deepgram პუნქტუაცია | `bool` | `1` | დაუყოვნებლივ | პუნქტუაციისა და დიდი ასოების დამატება. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_DEEPGRAM_SMART_FORMAT` | Deepgram ჭკვიანი ფორმატირება | `bool` | `1` | დაუყოვნებლივ | ამოცნობილი რიცხვებისა და თარიღების ფორმატირება. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_DEEPGRAM_URL` | Deepgram-ის ბაზისური URL | `text` | — | დაუყოვნებლივ | Deepgram API-ის ბაზა. ცარიელი = https://api.deepgram.com. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_IMAGE_BASE_URL` | სურათის API-ის ბაზისური URL (სარეზერვო OpenAI) | `text` | — | დაუყოვნებლივ | /images API-ის ბაზა, როცა მუშაობა OpenAI-ის გასაღებით მიმდინარეობს (ცარიელი = https://api.openai.com/v1). | | `AIHUMMER_IMAGE_MODEL` | სურათის გენერაციის მოდელი | `text` | — | დაუყოვნებლივ | მოდელი image_generate-ისთვის (ნაგულისხმევად gpt-image-2). | | `AIHUMMER_MEDIA_MAX_UPLOAD_MB` | მედიის ატვირთვის მაქს. ზომა (MB) | `int` | `256` | დაუყოვნებლივ | ყველაზე დიდი ფაილი (ფოტო, ხმოვანი, ვიდეო), რომლის ერთბაშად ატვირთვაც შეიძლება, მეგაბაიტებში. იცავს სერვერის დისკს გადავსებისგან. ნაგულისხმევად 256. მოქმედებს მაშინვე. | | `AIHUMMER_SIDECAR_STT` | მეტყველების ამოცნობა ამ სერვერზე (faster-whisper) | `bool` | `0` | დაუყოვნებლივ | ლოკალური მეტყველების ამოცნობა (faster-whisper). არ შედის პაკეტში: ჩართეთ ხელმოწერილი დანამატის ჩამოტვირთვა (~620 MiB Python-ის ყველა ვერსიისთვის) და დააინსტალირეთ სერვისი ჰოსტზე. 🔴 დანამატი გამოქვეყნებულია ცალკე გამყიდველის გადაწყვეტილებით (მისი პაკეტები შეიცავს ffmpeg GPL-ის ქვეშ); თუ ის არ არის გამოქვეყნებული თქვენი გამოსვლისთვის, მათ შორის ის იქნება გულწრფელი და არ დაარღვევს არაფერს. ღრუბლოვანი გეგმა: ამოცნობა კონფიგურებულია პროვაიდერის მიერ. | | `AIHUMMER_SIDECAR_TTS` | პასუხების გახმოვანება (edge-tts) | `bool` | `0` | დაუყოვნებლივ | მეტყველების სინთეზი (edge-tts, ხმები Microsoft Edge). არ შედის პაკეტში: ჩართვა ჩამოტვირთავს ხელმოწერილ დანამატს (~26 MiB) და დააინსტალირებს სერვისს ჰოსტზე. თავად სინთეზი მიდის ონლაინ ხმებისთვის - „ოფლაინ“ აქ გულისხმობს პაკეტის დაყენებას, არ მუშაობს. | | `AIHUMMER_STT_API_KEY` | STT API-გასაღები (არასავალდებულო) | `text` | — | დაუყოვნებლივ | მეტყველების ამოცნობის სერვისის წვდომის გასაღები, თუ ის მოითხოვს. ამ სერვერის სერვისისთვის მას ინსტალატორი აყენებს — შეცვლა არ არის საჭირო. მოქმედებს მაშინვე. | | `AIHUMMER_STT_ENGINE` | STT ძრავა | `enum: auto \\\| faster-whisper \\\| deepgram \\\| codex \\\| off` | `auto` | დაუყოვნებლივ | რით გადაიყვანოს ხმოვანი შეტყობინებები ტექსტად. ავტო (ნაგულისხმევი): Deepgram, თუ მისი გასაღები მითითებულია, თორემ ადგილობრივი სერვისი, თუ დაყენებულია (ზემოთ მოცემული გადამრთველი), თორემ არაფრით — და ბოტი გამგზავნს გულწრფელად ეტყვის, რომ ჯერ ვერ უსმენს. faster-whisper: ადგილობრივი სერვისი ან თავსებადი გარე /v1/audio/transcriptions. deepgram: ღრუბლოვანი Deepgram საკუთარი გასაღებით. codex: დაკავშირებული ChatGPT გამოწერა (მოდელები → ChatGPT-ის დაკავშირება), ხარჯავს მის ლიმიტს. off: არ გადაიყვანოს. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_STT_LANGUAGE` | STT ენა | `text` | — | დაუყოვნებლივ | ამოცნობის ენა (BCP-47, მაგ. ru/en). იყენებს deepgram ძრავა (მოდელი nova-2). ცარიელი = ავტომატური ამოცნობა / ძრავის ნაგულისხმევი. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_STT_MODEL` | STT მოდელი | `text` | `Systran/faster-whisper-small` | დაუყოვნებლივ | faster-whisper-ის მოდელი (მაგ. small/medium/large-v3 ან Systran/faster-whisper-⟨size⟩). მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_TTS_API_KEY` | TTS API-გასაღები (edge-tts) | `text` | — | ნაწილობრივ გადატვირთვის შემდეგ | გახმოვანების სერვისის წვდომის გასაღები. ინსტალაციისას ავტომატურად დგინდება — შეცვლა არ არის საჭირო. | | `AIHUMMER_TTS_ENABLED` | ტექსტის მეტყველებად გადაქცევა ჩართულია | `bool` | `1` | ნაწილობრივ გადატვირთვის შემდეგ | აგენტს ხმით პასუხის საშუალებას აძლევს. ამისთვის საჭიროა გახმოვანების სერვისი — მას ზემოთ, „დამატებით სერვისებში“ აყენებენ. | | `AIHUMMER_TTS_MODEL` | TTS მოდელი | `text` | — | ნაწილობრივ გადატვირთვის შემდეგ | მოდელის სახელი edge-tts სერვისისთვის. მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_TTS_VOICE` | TTS ხმა | `enum: de-DE-FlorianMultilingualNeural \\\| de-DE-SeraphinaMultilingualNeural \\\| en-US-AndrewMultilingualNeural \\\| en-US-AvaMultilingualNeural \\\| en-US-BrianMultilingualNeural \\\| en-US-EmmaMultilingualNeural \\\| fr-FR-RemyMultilingualNeural \\\| fr-FR-VivienneMultilingualNeural \\\| ru-RU-SvetlanaNeural \\\| ru-RU-DmitryNeural \\\| en-US-JennyNeural \\\| en-US-GuyNeural \\\| en-GB-SoniaNeural \\\| de-DE-KatjaNeural \\\| fr-FR-DeniseNeural \\\| es-ES-ElviraNeural \\\| tr-TR-EmelNeural \\\| pl-PL-ZofiaNeural \\\| zh-CN-XiaoxiaoNeural` | `de-DE-FlorianMultilingualNeural` | ნაწილობრივ გადატვირთვის შემდეგ | edge-tts-ის ნაგულისხმევი ხმა (მრავალენოვანი, მათ შორის რუსული). მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_VIDEO_API_KEY` | ვიდეოს ანალიზის API-გასაღები | `text` | — | დაუყოვნებლივ | ვიდეოს ანალიზის სერვისის წვდომის გასაღები, თუ ის მოითხოვს. ცარიელი — სერვისი გასაღების გარეშე გამოიყენება. | ## Media · Voice | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_TTS_AUTO_REPLY` | ავტომატური ხმოვანი პასუხები | `enum: off \\\| always \\\| inbound \\\| tagged` | `inbound` | დაუყოვნებლივ | გამორთული, ყოველთვის, აუდიოს მიღებისას ან მკაფიო მონიშვნით. შესაძლებელია შეცვლა ცალკეული საუბრისთვის. | | `AIHUMMER_TTS_MAX_CHARS` | წასაკითხი ტექსტის სიმბოლოების ზღვარი | `int` | `0` | დაუყოვნებლივ | 0: სრული ტექსტი; 100–10000: წასაკითხი ტექსტის ზღვარი. სრული პასუხი რჩება ისტორიაში. | | `AIHUMMER_TTS_SUMMARIZE` | გრძელი ხმოვანი პასუხების შეჯამება | `bool` | `1` | დაუყოვნებლივ | გრძელი პასუხების შეჯამება წასაკითხად. შეცდომისას იკითხება დასაწყისი დადგენილი ზღვრის ფარგლებში. | | `AIHUMMER_VOICE_AEC` | ექოს ჩახშობა (AEC) | `bool` | `1` | დაუყოვნებლივ | აშორებს ექოს: აგენტის საკუთარი ხმა დინამიკიდან მიკროფონში არ ბრუნდება და საუბარს არ აწყვეტინებს. გამორთეთ მხოლოდ მაშინ, თუ ყურსასმენში ხმა დამახინჯებულად ჟღერს. | | `AIHUMMER_VOICE_AGC` | ავტომატური გაძლიერების კონტროლი | `bool` | `1` | დაუყოვნებლივ | ხმოვან რეჟიმში მოითხოვოს მიკროფონის გაძლიერების ავტომატური კონტროლი (WebRTC autoGainControl). | | `AIHUMMER_VOICE_BARGEIN_FRAMES` | აგენტის შეწყვეტინება: რამდენ ხანს უნდა ილაპარაკოთ | `int` | `5` | დაუყოვნებლივ | რამდენ ხანს უნდა ილაპარაკოთ (20 მწ-იან კადრებში), რომ აგენტი გაჩუმდეს და მოგისმინოთ. ნაგულისხმევად 5 — დაახლოებით 0,1 წამი. | | `AIHUMMER_VOICE_DUPLEX` | ცოცხალი სრულ-დუპლექსური ხმა | `bool` | `0` | დაუყოვნებლივ | რთავს ცოცხალ სრულ დუპლექს რეჟიმს (სტრიმინგი + VAD + barge-in). მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_VOICE_NOISE_SUPPRESSION` | ხმაურის ჩახშობა | `bool` | `1` | დაუყოვნებლივ | ხმოვან რეჟიმში მოითხოვოს ხმაურის ჩახშობა მიკროფონიდან ჩაწერისას (WebRTC noiseSuppression). | | `AIHUMMER_VOICE_VAD_THRESHOLD` | ხმისადმი მგრძნობელობა (0–1) | `text` | `0.02` | დაუყოვნებლივ | რა ხმამაღლობიდან ითვლება ხმა მეტყველებად. ნაკლები — უფრო მგრძნობიარე: აგენტი გაიგონებს ჩუმ მეტყველებას, მაგრამ ფონურ ხმაურსაც. ნაგულისხმევად 0.02. | ## Memory | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_EMBEDDER_DIM` | მნიშვნელობით ძიების მოდელის განზომილება | `int` | `768` | გადატვირთვის შემდეგ | ვექტორის განზომილება — უნდა ემთხვეოდეს მოდელს (multilingual-e5-base=768, bge-m3=1024). | | `AIHUMMER_EMBEDDER_KEEPALIVE` | ემბედერის keep-alive | `text` | `5m` | გადატვირთვის შემდეგ | რამდენ ხანს რჩება მნიშვნელობით ძიების მოდელი ჩატვირთული ბოლო მოთხოვნის შემდეგ (მხოლოდ რეჟიმში „მნიშვნელობით“). ნაგულისხმევად 5m — 5 წუთი: შემდეგ მოდელი იტვირთება გარეთ და ათავისუფლებს მეხსიერებასა და პროცესორს. მუდმივად შენახვა (-1) არ არის რეკომენდებული: გაჭედილმა მოდელმა შეიძლება დღეებით დაიკავოს პროცესორის ბირთვი. ფორმატი: 30s, 5m, 1h. | | `AIHUMMER_EMBEDDER_MODEL` | მნიშვნელობით ძიების მოდელი | `text` | `yxchia/multilingual-e5-base` | გადატვირთვის შემდეგ | მოდელი, რომელიც მეხსიერებაში მნიშვნელობით ძიებაში გეხმარებათ. ნაგულისხმევი multilingual-e5-base ესმის რუსული, მსუბუქია და ჩვეულებრივ პროცესორზე სწრაფად მუშაობს. ვიდეობარათზე უკეთესი ხარისხისთვის bge-m3 გამოდგება, მაგრამ მაშინ მეზობელ განზომილების პარამეტრში მიუთითეთ 1024: რიცხვი მოდელს უნდა ემთხვეოდეს. | | `AIHUMMER_EMBEDDER_PASSAGE_PREFIX` | ემბედერის დოკუმენტის პრეფიქსი | `text` | — | გადატვირთვის შემდეგ | გადაფარეთ შესანახი დოკუმენტის პრეფიქსი (e5 მოდელები ავტომატურად იყენებენ „passage: “-ს). დატოვეთ ცარიელი, რომ ავტომატურად განისაზღვროს მოდელის სახელით. | | `AIHUMMER_EMBEDDER_QUERY_PREFIX` | ემბედერის მოთხოვნის პრეფიქსი | `text` | — | გადატვირთვის შემდეგ | გადაფარეთ საძიებო მოთხოვნის პრეფიქსი (e5 მოდელები ავტომატურად იყენებენ „query: “-ს). დატოვეთ ცარიელი, რომ ავტომატურად განისაზღვროს მოდელის სახელით. | | `AIHUMMER_EMBEDDER_THREADS` | ემბედერის პროცესორის ნაკადები | `int 0…256` | `0` | გადატვირთვის შემდეგ | რამდენ პროცესორის ნაკადს იყენებს აზრით ძიების მოდელი ერთ მოთხოვნაზე. 0 — ავტომატურად: სერვერის ნაკადების ნახევარი, მაგრამ არანაკლებ 2-ისა. ზღვრის გარეშე ცოდნის ბაზის ვექტორების ხელახალი გამოთვლა სუსტ სერვერზე საათობით იკავებდა მთელ პროცესორს და აფერხებდა აგენტების პასუხებს. მეტი — ხელახალი გამოთვლა სწრაფია, მაგრამ დატვირთვა მძიმე. | | `AIHUMMER_MEMORY_AGENT_WRITES` | აგენტის მიერ თავად შენახული ფაქტები | `enum: strangers \\\| immediate \\\| review` | `strangers` | დაუყოვნებლივ | რა ემართება იმას, რასაც აგენტი თავად იმახსოვრებს — მაგალითად, თხოვნით „დაიმახსოვრე“. „პირდაპირ მეხსიერებაში; უცხოებისგან — შესამოწმებლად“ (ნაგულისხმევი) — პირდაპირ მეხსიერებაში, თუ ეს თქვა მფლობელმა ან აგენტის სანდო წრემ; ყველა სხვისგან — შესამოწმებლად. „პირდაპირ მეხსიერებაში“ — აგენტი მაშინვე იპოვის. „შესამოწმებლად“ — ჯერ რიგში „მეხსიერება → შესამოწმებლად“, პასუხებში მხოლოდ თქვენი დამტკიცების შემდეგ ხვდება. აგენტის ბარათზე (მეხსიერება → პარამეტრები) შეიძლება საკუთარი რეჟიმის არჩევა. | | `AIHUMMER_MEMORY_AUTOREPAIR` | მეხსიერების ავტომატური გასწორება | `bool` | `1` | დაუყოვნებლივ | თვითშემოწმების შემდეგ მეხსიერება სწორდება: დუბლიკატები ერთიანდება, აშკარა გამარჯვებულის მქონე წინააღმდეგობები იხურება (ადამიანის დადასტურება, მოვლენის უფრო გვიანდელი თარიღი, უფრო წონიანი წყარო), დადასტურებულად მონიშნული ფაქტები, რომლებიც არცერთ ადამიანს არ დაუდასტურებია, ხელახლა მოწმდება წყაროებით (დაუდასტურებლები გადაეცემა შესამოწმებლად, არაფერი იშლება). სადავო მხოლოდ რიგში ხვდება. ყოველი გასწორება ჟურნალში იწერება გაუქმების ღილაკით; თუ გავლის შემდეგ მეხსიერება უარესად პოულობს, გავლა თავად აუქმებს თავს და თქვენ მიიღებთ შეტყობინებას. მოქმედებს მაშინვე, გადატვირთვა საჭირო არ არის. | | `AIHUMMER_MEMORY_CAPTURE` | მეხსიერების ჩაწერის რეჟიმი | `enum: auto \\\| review \\\| off` | `review` | დაუყოვნებლივ | რა ვუყოთ ფაქტებს, რომლებსაც აგენტი ყოველი პასუხის შემდეგ მიმოწერაში თავად ამჩნევს. „შესამოწმებლად“ — რიგში „მეხსიერება → შესამოწმებლად“: პასუხებში მხოლოდ თქვენი დამტკიცების შემდეგ ხვდება. „პირდაპირ მეხსიერებაში“ — შემოწმების გარეშე: უფრო სწრაფია, მაგრამ მეტი ზედმეტია. „არ შეინახოს“ — მიმოწერიდან ფაქტებს არ იღებს. რასაც აგენტი თხოვნით იმახსოვრებს, ცალკე რეგულირდება. | | `AIHUMMER_MEMORY_CONTEXT_TIMEOUT` | მეხსიერების ჩატვირთვის ტაიმაუტი | `text` | `3s` | დაუყოვნებლივ | რამდენ ხანს ელოდება აგენტი შესაბამისი მოგონებების პოვნას პასუხის დაწყებამდე. თუ ძიება ვერ ასწრებს, აგენტი მათ გარეშე პასუხობს და არ იჭედება. მაგალითად: 2s — 2 წამი, 1500ms — 1,5 წამი. 0 — ლოდინი რამდენიც საჭიროა. | | `AIHUMMER_MEMORY_DIARY_BOOT` | აგენტის დღიური სესიის დასაწყისში | `bool` | `1` | დაუყოვნებლივ | ნებისმიერ არხზე სესიის ყოველ სვლაზე აგენტის თვალწინ იყოს მისი დღევანდელი და გუშინდელი დღიური: წინა სესიების შენიშვნები, ღამის შეჯამება და აგენტის საკუთარი ჩანაწერები. ნაჩვენებია მხოლოდ მიმდინარე თანამოსაუბრის შესახებ და საერთო (თქვენი, ატვირთული) ჩანაწერები — ერთი კლიენტი ვერასოდეს ხედავს მეორისას. მაქსიმუმ ~6000 სიმბოლო; დანარჩენს აგენტი თავად კითხულობს (memory_get). მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_MEMORY_DIARY_HOUR` | ღამის შეჯამების საათი | `int` | `3` | დაუყოვნებლივ | რომელი საათის შემდეგ (0–23, ინსტანსის სასაათო სარტყლით) ჩაიწეროს გასული დღის შეჯამება. ნაგულისხმევი 3 — ღამით, როცა დღის საუბრები დასრულებულია. მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_MEMORY_DIARY_NIGHTLY` | დღის ღამის შეჯამება აგენტის დღიურში | `bool` | `1` | დაუყოვნებლივ | დღეში ერთხელ აგენტის დღიურში ჩაიწეროს გასული დღის შეჯამება — ცალ-ცალკე თითოეული თანამოსაუბრისთვის (მისი ყველა არხი ერთად): რა ითხოვეს და რა გაკეთდა, შეთანხმებები, თარიღიანი საქმეები. სერვისული ამოცანების მოდელის ერთი გამოძახება თითო აგენტსა და თანამოსაუბრეზე, მაქსიმუმ 3 ერთ გავლაზე ყოველ 10 წუთში; გამოტოვებული დღეები ივსება ერთ კვირამდე უკან. საუბრები თხოვნით „ნუ დაიმახსოვრებ“ არ აიღება. არ იწერება, როცა მეხსიერების შეგროვება გამორთულია. ბოლო გავლის შედეგი ჩანს აგენტის ბარათში → მეხსიერება → დღიური. მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_MEMORY_DREAM_INTERVAL` | „სიზმრის“ გავლის ინტერვალი | `string` | `1h` | დაუყოვნებლივ | რა სიხშირით ამოწმებს თვითმომსახურე dream-გავლა შემოწმებულ მტკიცებებს წინააღმდეგობებზე ყველა არეალში (Go-ს duration, მაგ. 30m/1h/6h). 0 = გამორთვა. მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_MEMORY_EXTRACT` | ფაქტების ამოღება LLM-ის მეშვეობით | `bool` | `1` | დაუყოვნებლივ | ნორმალიზებული ფაქტების სუბიექტი/პრედიკატი/ობიექტი ამოღება LLM-ით (ნაგულისხმევად ჩართული) წინადადებების ნედლი ფრაგმენტების შენახვის ნაცვლად — აუცილებელია გრაფის/წინააღმდეგობების/dream-ის მექანიზმების ასამუშავებლად. ამატებს LLM-ის ერთ გამოძახებას ყოველ დაფიქსირებულ შეტყობინებაზე; გამორთეთ, რომ ეს გამოძახება დაზოგოთ. მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_MEMORY_MEANING_TIMEOUT` | მნიშვნელობით ძიების დროის ლიმიტი | `text` | `4s` | დაუყოვნებლივ | რამდენ ხანს ელოდება მეხსიერებასა და ცოდნის ბაზაში ძიება მნიშვნელობით ძიებას. თუ მნიშვნელობის მოდელი დაკავებულია (მაგალითად, იმპორტის შემდეგ ვექტორებს ითვლის) და დროულად არ პასუხობს, აგენტი ათობით წამის ლოდინის ნაცვლად მაშინვე იღებს სიტყვებით ნაპოვნს შენიშვნით. მაგალითად: 4s — 4 წამი, 1500ms — 1,5 წამი. 0 — ლოდინი რამდენიც საჭიროა. მოქმედებს მაშინვე, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_MEMORY_QUALITY_CHECK` | მეხსიერების ყოველდღიური თვითშემოწმება | `bool` | `1` | დაუყოვნებლივ | დღეში ერთხელ მეხსიერება თავის თავს უსვამს საკონტროლო კითხვებს თავისი დადასტურებული ფაქტების შესახებ (60 ფაქტამდე, ყოველდღე ერთი და იგივე კითხვები) და კითხვებს, რომლებსაც პასუხი არ აქვს, ატარებს მათ მეხსიერების ძიებასა და ავტომატურ შეხსენებაში და ზომავს პოვნის წილს, სიზუსტეს, MRR-ს და ცრუ შეხსენებებს. შედეგი და დღიური გრაფიკი: მეხსიერება → მეხსიერების ხარისხი. ახალი ფაქტების კითხვებს ერთხელ წერს სამსახურებრივი მოდელი (იგივე, რომელიც საუბრებიდან ფაქტებს იღებს; მის გარეშე — შაბლონით); შედეგები რჩება ინსტანციაზე. მოქმედებს მაშინვე, გადატვირთვა საჭირო არ არის. | | `AIHUMMER_MEMORY_RECALL` | მეხსიერების ავტომატური გახსენება | `enum: strong \\\| always \\\| off` | `strong` | დაუყოვნებლივ | დაემატოს თუ არა მეხსიერებაში ნაპოვნი პასუხს ავტომატურად. „მხოლოდ ზუსტი დამთხვევები“ — ფაქტი უნდა დაემთხვეს შეტყობინებას მინიმუმ ორი მნიშვნელოვანი სიტყვით; მისალმება და „ok“ მეხსიერებას არ იზიდავს. „ყველაფერი მსგავსი“ — ყველაფერი, რაც რამენაირად დაემთხვა, და დაკავშირებული ჩანაწერები: მეტი ზედმეტი. „არ დაემატოს“ — აგენტი მეხსიერებაში თავად ეძებს, როცა საჭიროდ ჩათვლის. | | `AIHUMMER_MEMORY_RECALL_MAX` | ფაქტები ერთ პასუხზე | `int` | `5` | დაუყოვნებლივ | ერთ პასუხში დამატებული მეხსიერების ფაქტების მაქსიმალური რაოდენობა (ნაგულისხმევი 5). ერთი და იმავე ფაქტის პერიფრაზები ერთად ითვლება. მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_MEMORY_RECALL_MIN_SCORE` | ავტომატური გახსენების მინიმალური დამთხვევა, % | `int` | `10` | დაუყოვნებლივ | შეტყობინების მნიშვნელოვანი სიტყვების (იშვიათობის მიხედვით აწონილი) რა წილი უნდა მოიცვას ფაქტმა, რომ ავტომატურად დაემატოს, პროცენტებში. ნაგულისხმევი 10 — მორგებულია რეალურ მიმოწერაზე. მეტი = უფრო იშვიათად და ზუსტად, ნაკლები = უფრო ხშირად და მეტი ხმაურით. არ მოქმედებს memory_search-ის ცხად ძიებაზე. 0 — ზღვრის გარეშე: საკმარისია ორი დამთხვეული მნიშვნელოვანი სიტყვა. მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_MEMORY_RECALL_MIN_SIMILARITY` | მნიშვნელობის მინიმალური მსგავსება ავტომატური დამატებისთვის, % | `int` | `86` | დაუყოვნებლივ | მხოლოდ მეხსიერების მნიშვნელობით ძიებისთვის (embedder): რამდენად ახლოს უნდა იყოს ფაქტი შეტყობინებასთან მნიშვნელობით, რომ ავტომატურად დაემატოს, მსგავსების პროცენტში. ნაგულისხმევი 86 — შერჩეულია multilingual-e5-base მოდელისთვის რეალურ მეხსიერებაზე: ამაზე დაბლა თითქმის ყველა შეტყობინებას უცხო ფაქტები ემატება. სხვა მოდელები (მაგ., bge-m3) მსგავსებას სხვაგვარად ითვლიან — შეარჩიეთ მნიშვნელობა აგენტის ბარათში „მეხსიერების კითხვით“. 0 — ზღვრის გარეშე. არ მოქმედებს memory_search-ის ცხად ძიებაზე. მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_MEMORY_RETRIEVAL` | მეხსიერების ამოღების რეჟიმი | `enum: fulltext \\\| embedding` | `fulltext` | გადატვირთვის შემდეგ | როგორ ეძებს აგენტი მეხსიერებაში. „სიტყვებით“ — ჩვეულებრივი ტექსტური ძიება: მაშინვე მუშაობს და სერვერს არ ტვირთავს. „მნიშვნელობით“ — პოულობს მნიშვნელობით ახლოს მყოფს, სხვა სიტყვებით ნათქვამსაც, მაგრამ სჭირდება მნიშვნელობით ძიების მოდელი (განყოფილება „დამატებითი სერვისები“) და პროცესორის შესამჩნევი დატვირთვა. | | `AIHUMMER_QDRANT_API_KEY` | Qdrant API-გასაღები | `text` | — | გადატვირთვის შემდეგ | Qdrant-ის API გასაღები, თუ ვექტორული საცავი ავტორიზაციას მოითხოვს. საჭიროა მხოლოდ მაშინ, როცა მითითებულია Qdrant-ის მისამართი. მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_QDRANT_URL` | Qdrant URL (მუდმივი ვექტორული საცავი) | `text` | — | გადატვირთვის შემდეგ | მნიშვნელობით ძიებისთვის Qdrant-ის საცავის მისამართი. ცარიელი — ძიების მონაცემები მეხსიერებაში ინახება და სერვერის გადატვირთვისას იკარგება; მუდმივი მუშაობისთვის მიუთითეთ მისამართი. | | `AIHUMMER_RAG_QUERY_EXPANSION` | ცოდნის ბაზის მოთხოვნების გადაფორმულირება მოდელით | `bool` | `0` | დაუყოვნებლივ | ცოდნის ბაზაში ძიებამდე სერვისული ამოცანების მოდელს სთხოვს მოთხოვნის 3 გადაფორმულირებას და ეძებს ყველათი. ზოგჯერ მეტს პოულობს, მაგრამ ეს არის მოდელის დამატებითი გამოძახება ყოველ ძიებაზე (კვოტა და დაყოვნება); თუ მოდელი ვერ უპასუხებს, იძებნება მხოლოდ საწყისი ფორმულირებით, შეცდომა კი ჩანს ჟურნალში და ძიების შედეგში. ნაგულისხმევად გამორთულია: სიტყვები ისედაც სრულტექსტური ძიებით იძებნება. მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_RERANKER_URL` | RAG რერანკერის საიდქარის URL | `text` | — | გადატვირთვის შემდეგ | კროს-ენკოდერის თანმხლები სერვისის HTTP-URL ჰიბრიდული ძებნის შედეგების გადალაგებისთვის. ცარიელი = გადალაგება გამორთულია. მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | ## Moderation | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_MODERATION` | შემომავალის მოდერაცია | `bool` | `1` | დაუყოვნებლივ | "off" თიშავს ჩაშენებულ დაცვას jailbreak/prompt-injection-ისგან. ნებისმიერი სხვა მნიშვნელობა = ჩართულია. მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | | `AIHUMMER_MODERATION_REFUSAL` | მოდერაციის უარის შეტყობინება | `text` | — | დაუყოვნებლივ | უარის ტექსტი, რომელიც ბრუნდება, როცა მოდერატორი მოთხოვნას ბლოკავს (ცარიელი = ჩაშენებული). მოქმედებს დაუყოვნებლივ, გადატვირთვა არ არის საჭირო. | ## Network | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OUTBOUND_PROXY_CUSTOM_URL` | გამავალი პროქსი: საკუთარი მისამართი | `text` | — | დაუყოვნებლივ | HTTPS პროქსის URL; HTTP ნებადართულია მხოლოდ loopback-ზე, გზის, მოთხოვნისა და ფრაგმენტის გარეშე. ჯერ შეინახეთ მისამართი, შემდეგ აირჩიეთ custom. API-ში დაფარულია და ინახება პროგრამის პარამეტრებში. | | `AIHUMMER_OUTBOUND_PROXY_MODE` | გამავალი პროქსი უცხოური მოდელების მომწოდებლებისთვის | `enum: auto \\\| off \\\| custom` | `auto` | დაუყოვნებლივ | როგორ მიდის სერვერი უცხოელ მოდელების მომწოდებლებთან. „როგორც მომწოდებელთან“ — როგორც მომწოდებლის კაბინეტშია დაყენებული; „პირდაპირ, პროქსის გარეშე“ — შუამავლების გარეშე; „საკუთარი პროქსით“ — ქვემოთ შენახული მისამართით. მუშაობს თუ არა, კონკრეტული მომწოდებლის წესებზეა დამოკიდებული. | | `AIHUMMER_RUSSIAN_TRUSTED_EXTRA_HOSTS` | .ru-ს გარეთ არსებული ჰოსტები რუსეთის ციფრული განვითარების სამინისტროს ფესვებისთვის | `list` | — | გადატვირთვის შემდეგ | ჰოსტების სია, გამოყოფილი მძიმეებით, რომელთა შემოწმებაც დასაშვებია რუსეთის ციფრული განვითარების სამინისტროს რუსული დომენების ფესვებით (.ru/.su/.рф - უკვე შედის). საჭიროა, თუ თქვენი კვანძი რუსეთის ციფრული განვითარების სამინისტროს სერტიფიკატით ცხოვრობს სხვა დომენზე. დაემთხვევა სახელის ან ქვედომენის საზღვრის მიხედვით: example.com მოიცავს api.example.com. ცარიელი = მხოლოდ რუსული დომენები. ვრცელდება დაწყებისას/გადატვირთვის შემდეგ. | ## Performance | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_CHANNEL_TURN_QUEUE_WAIT_SEC` | რიგში ლოდინი: არხის შეტყობინება (წამი) | `int 10…1200` | `600` | დაუყოვნებლივ | რამდენ ხანს ელოდება არხის შეტყობინება (Telegram და სხვები) თავისუფალ ადგილს, როცა სვლების ყველა ადგილი დაკავებულია. თუ დროულად ვერ მიიღებს, ადამიანს ეცნობება, რომ სერვერი დაკავებულია და შეუძლია ხელახლა დაწეროს. ლოდინი სვლის 30-წუთიან ლიმიტში ითვლება. 10–1200. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_MAX_ACTIVE_TURNS` | ერთდროულად მიმდინარე აგენტის სვლები (მთელი სერვერი) | `int 1…512` | `32` | დაუყოვნებლივ | რამდენ აგენტის სვლას (პასუხები არხებსა და ვებ-ჩატში, განრიგები) ასრულებს სერვერი ერთდროულად. დანარჩენები რიგში იმდენ ხანს ელოდებიან, რამდენსაც ქვემოთ „რიგში ლოდინის“ პარამეტრები უშვებს, და ადამიანი ხედავს „სერვერი დაკავებულია, რიგშია“. მეტი მნიშვნელობა ამცირებს ლოდინს, მაგრამ ზრდის მეხსიერებას, მონაცემთა ბაზის კავშირებს და მოდელთან ერთდროულ მოთხოვნებს. ამ რიცხვის ნახევარი ზღუდავს მოდელის ერთდროულ დამხმარე გამოძახებებს (მეხსიერების ამოღება, შეჯამებები). 1–512. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_SYNC_INBOUND_QUEUE_WAIT_SEC` | რიგში ლოდინი: ინტეგრაციის სინქრონული გამოძახება (წამი) | `int 1…120` | `10` | დაუყოვნებლივ | რამდენ ხანს ელოდება თავისუფალ ადგილს იმ ინტეგრაციის გამოძახება, რომელიც პასუხს იმავე მოთხოვნაში ელოდება, როცა სვლების ყველა ადგილი დაკავებულია. თუ ვერ მიიღებს, ინტეგრაცია იღებს „სერვერი დაკავებულია“ იმავე რაოდენობის წამის შემდეგ გამეორების რჩევით; იმავე შეტყობინების ნომრით გამეორება მას ორჯერ არ ინახავს. 1–120. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_WEB_TURN_QUEUE_WAIT_SEC` | რიგში ლოდინი: ვებ-ჩატის შეტყობინება (წამი) | `int 10…1200` | `180` | დაუყოვნებლივ | რამდენ ხანს ელოდება ვებ-ჩატის შეტყობინება თავისუფალ ადგილს, როცა სვლების ყველა ადგილი დაკავებულია. ამ დროს ჩატში ჩანს „სერვერი დაკავებულია, რიგშია“; თუ დროულად ვერ მიიღებს, პასუხი უარყოფილია ღილაკით „ხელახლა ცდა“, რომელიც ისტორიაში რჩება გვერდის ხელახლა გახსნის შემდეგაც. 10–1200. მოქმედებს დაუყოვნებლივ. | ## Public access | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_PUBLIC_URL` | სერვერის საჯარო მისამართი | `text` | — | ნაწილობრივ გადატვირთვის შემდეგ | მისამართი, რომლითაც პანელი და აპები ინტერნეტიდან იხსნება, მაგ. https://ai.example.com. გადაამისამართეთ თქვენი პროქსით (nginx, Caddy) სერვერის პორტზე — ნაგულისხმევად 8780. | | `AIHUMMER_WIDGET_ALLOWED_ORIGINS` | ვებ-ვიჯეტი: საიტების ნებადართული origin-ები | `list` | — | დაუყოვნებლივ | ვებ-ჩატის ვიჯეტის ჩასმის უფლების მქონე browser origin-ების მძიმით გამოყოფილი სია, მაგალითად https://example.com,https://www.example.com. სქემა და პორტი ზუსტად უნდა ემთხვეოდეს. ცარიელი = გარე საიტი ვიჯეტს ვერ გამოიყენებს. `*` ჩანაწერი განზრახ იგნორირდება, რადგან სხვაგვარად ინტერნეტის ნებისმიერ გვერდს შეეძლებოდა ამ ინსტანსის ბიუჯეტის ხარჯვა. | | `POCKET_AGENT_GATEWAY_BASE_URL` | Pocket-agent კარიბჭის საჯარო URL | `text` | — | დაუყოვნებლივ | დააპროქსირეთ → pocket-agent-ის გეითვეის პორტზე (POCKET_AGENT_PORT, ნაგულისხმევად 8080). დისტანციური აგენტი აქ ერთჯერადი ტიკეტით უკავშირდება. | | `TELEGRAM_PUBLIC_URL` | Telegram ვებჰუკის საჯარო URL | `text` | — | დაუყოვნებლივ | მხოლოდ webhook-რეჟიმისთვის — დააპროქსირეთ → telegram-connector-ის პორტზე (ნაგულისხმევად 8091). დატოვეთ ცარიელი polling-რეჟიმისთვის (საჯარო URL საჭირო არაა). | ## SSO (LDAP/AD) | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_LDAP_BASE_DN` | მომხმარებლის ძიების ბაზისური DN | `text` | — | გადატვირთვის შემდეგ | ძიება root, მაგ. OU=მომხმარებლები,DC=corp,DC=მაგალითი. | | `AIHUMMER_LDAP_BIND_DN` | სამსახურებრივი bind DN | `text` | — | გადატვირთვის შემდეგ | ანგარიში საწყისი საძიებო bind-ისთვის, მაგ. CN=svc-aihummer,OU=Service,DC=corp,DC=example. ცარიელი = ანონიმური ძებნა. | | `AIHUMMER_LDAP_DEFAULT_ROLE` | LDAP: ნაგულისხმევი როლი (ჯგუფის დამთხვევის გარეშე) | `text` | — | გადატვირთვის შემდეგ | როლი, რომელიც გაიცემა, როცა ვერცერთი ჯგუფი ვერ ემთხვევა შესაბამისობის წესებს. ცარიელი = როლის გარეშე. | | `AIHUMMER_LDAP_ENABLED` | LDAP/AD შესვლის ჩართვა | `bool` | `0` | გადატვირთვის შემდეგ | როცა ჩართულია, ადმინისტრატორების შესვლა კატალოგზე გადადის. bind-ის პაროლი ინახება Secrets-ში (scope ldap, name bind_password). | | `AIHUMMER_LDAP_GROUP_ATTR` | ჯგუფის ატრიბუტი (ნაგულისხმევი memberOf) | `text` | — | გადატვირთვის შემდეგ | მომხმარებლის ჩანაწერის ატრიბუტი, რომელიც ჯგუფების DN-ებს ჩამოთვლის. ცარიელი გამორთავს შესაბამისობას ჯგუფი→როლი. | | `AIHUMMER_LDAP_ROLE_MAPPINGS` | LDAP: ჯგუფი→როლი შესაბამისობები (JSON) | `text` | — | გადატვირთვის შემდეგ | JSON-ობიექტი ჯგუფის DN (ან უბრალო CN) → როლი, მაგ. {\\"CN=Admins,OU=Groups,DC=corp,DC=example\\":\\"admin\\",\\"Operators\\":\\"operator\\"}. | | `AIHUMMER_LDAP_SKIP_TLS_VERIFY` | TLS შემოწმების გამოტოვება (მხოლოდ ლაბორატორიისთვის, 1/0) | `bool` | `0` | გადატვირთვის შემდეგ | გამორთავს კატალოგის სერტიფიკატის შემოწმებას. არასდროს ჩართოთ პროდაქშენში. | | `AIHUMMER_LDAP_URL` | დირექტორიის URL | `text` | — | გადატვირთვის შემდეგ | მაგ. ldaps://ad.corp.example:636 (TLS) ან ldap://dc1.corp.example:389. | | `AIHUMMER_LDAP_USER_ATTR` | შესვლის ატრიბუტი (ნაგულისხმევი sAMAccountName) | `text` | — | გადატვირთვის შემდეგ | LDAP/Active Directory-ის ატრიბუტი, რომელიც ედრება მომხმარებლის აკრეფილ ლოგინს (ნაგულისხმევად sAMAccountName; uid — OpenLDAP-ისთვის, userPrincipalName — UPN-ტიპის ლოგინებისთვის). | | `AIHUMMER_LDAP_USER_FILTER` | მომხმარებლის ძიების ფილტრი | `text` | — | გადატვირთვის შემდეგ | უნდა შეიცავდეს %s-ს ლოგინისთვის. AD: (sAMAccountName=%s); OpenLDAP: (uid=%s). | ## SSO (OIDC) | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_OIDC_AUDIENCE` | OIDC აუდიტორია | `text` | — | გადატვირთვის შემდეგ | მოსალოდნელი `aud` claim — მიუთითეთ ამ რესურსის audience, რომ სხვა მხარისთვის გამოშვებული ტოკენები უარყოთ. `aud` claim ახლა ნაგულისხმევად სავალდებულოა ყოველ ტოკენში (aud-ის გარეშე ტოკენი უარიყოფა); როცა ეს მითითებულია, aud მასაც უნდა შეიცავდეს. პროდაქშენში მკაცრად რეკომენდებულია. | | `AIHUMMER_OIDC_ISSUER` | OIDC გამომცემის URL | `text` | — | გადატვირთვის შემდეგ | IdP-ის გამომშვები (მაგ. https://login.example.com). მითითებისას რთავს ავთენტიფიკაციას OIDC JWT-ით. | | `AIHUMMER_OIDC_JWKS_URL` | OIDC-ის JWKS URL | `text` | — | გადატვირთვის შემდეგ | JSON Web Key Set-ის ენდპოინტი ტოკენების ხელმოწერების შესამოწმებლად. | | `AIHUMMER_OIDC_TENANT_CLAIM` | სამუშაო სივრცის claim OIDC-ში | `text` | — | გადატვირთვის შემდეგ | JWT-ის claim, რომელიც სამუშაო სივრცის იდენტიფიკატორს ატარებს (მაგ. tenant_id / org). | ## SSO (SAML) | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_SAML_DEFAULT_ROLE` | SAML: ნაგულისხმევი როლი (ჯგუფის დამთხვევის გარეშე) | `text` | — | გადატვირთვის შემდეგ | როლი, რომელიც გაიცემა, როცა ვერცერთი მიწოდებული მნიშვნელობა ვერ ემთხვევა შესაბამისობას. ცარიელი = როლის გარეშე. | | `AIHUMMER_SAML_ENABLED` | SAML 2.0 SSO-ს ჩართვა | `bool` | `0` | გადატვირთვის შემდეგ | ხსნის /saml/metadata, /saml/acs, /saml/login მისამართებს. SP-ის პრივატული გასაღები ინახება Secrets-ში (scope saml, name sp_key). | | `AIHUMMER_SAML_ENTITY_ID` | SP-ის entity ID | `text` | — | გადატვირთვის შემდეგ | სერვის-პროვაიდერის entity ID (ცარიელის შემთხვევაში ნაგულისხმევად ⟨root⟩/saml/metadata). | | `AIHUMMER_SAML_IDP_METADATA` | IdP მეტამონაცემების XML | `text` | — | გადატვირთვის შემდეგ | ჩასვით თქვენი IdP-ის SAML-მეტამონაცემების დოკუმენტი (Okta/Azure AD/ADFS). | | `AIHUMMER_SAML_ROLE_ATTRIBUTE` | როლის/ჯგუფის ატრიბუტი (ნაგულისხმევი groups) | `text` | — | გადატვირთვის შემდეგ | assertion-ის ატრიბუტი, რომელიც ჯგუფის/როლის მნიშვნელობებს ატარებს. | | `AIHUMMER_SAML_ROLE_MAPPINGS` | SAML: ჯგუფი→როლი შესაბამისობები (JSON) | `text` | — | გადატვირთვის შემდეგ | JSON-ობიექტი მიწოდებული მნიშვნელობა → როლი, მაგ. {\\"AdminGroup\\":\\"admin\\",\\"Ops\\":\\"operator\\"}. | | `AIHUMMER_SAML_ROOT_URL` | SP ძირეული URL | `text` | — | გადატვირთვის შემდეგ | ამ გეითვეის გარედან ხელმისაწვდომი საბაზისო URL, მაგ. https://app.example.com. ACS = ⟨root⟩/saml/acs. | | `AIHUMMER_SAML_SP_CERT` | SP სერტიფიკატი (PEM) | `text` | — | გადატვირთვის შემდეგ | SP-ის ხელმოწერის საჯარო სერტიფიკატი (PEM). შესაბამისი პრივატული გასაღები ინახება Secrets-ში (scope saml, name sp_key). | ## Schedules | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_SCHEDULE_AGENT_MAX_ACTIVE` | აგენტი: აქტიური განრიგების ლიმიტი | `int` | `20` | დაუყოვნებლივ | რამდენი აქტიური განრიგი შეიძლება ჰქონდეს ერთ აგენტს, როცა ის თავად ქმნის ან რთავს განრიგს (თავისი განრიგის ხელსაწყოებით). პანელში შექმნილი განრიგებიც ითვლება, მაგრამ პანელს უარი არასოდეს ეთქმება. ლიმიტზე აგენტს სთხოვენ, ჯერ ერთი შეაჩეროს ან წაშალოს. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_SCHEDULE_AGENT_MAX_FIRES_PER_DAY` | აგენტი: განრიგის გაშვებები დღეში | `int` | `288` | დაუყოვნებლივ | რამდენჯერ შეიძლება დღეში (UTC) ჯამში გაეშვას ერთი აგენტის ყველა განრიგი, პანელში შექმნილი განრიგებისა და ხელით გაშვებების ჩათვლით. ლიმიტს ზემოთ გაშვებები გამოტოვებულია და ჩანს გაშვებების ჟურნალში. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_SCHEDULE_AGENT_MIN_INTERVAL_MINUTES` | აგენტი: განრიგის მინიმალური ინტერვალი, წუთი | `int` | `5` | დაუყოვნებლივ | უმოკლესი შუალედი განმეორებადი განრიგის ორ გაშვებას შორის, რომელსაც აგენტი თავად ქმნის ან ცვლის. უფრო ხშირი განრიგი უარყოფილია. პანელში შექმნილ განრიგებს ეს არ ზღუდავს. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_SCHEDULE_COMMANDS` | სერვერის ბრძანებები განრიგებში | `bool` | `0` | დაუყოვნებლივ | განრიგს აძლევს საშუალებას ამ სერვერზე გაუშვას პროგრამა — შემგროვებელი, ანგარიში, სარეზერვო ასლის შემოწმება. ნაგულისხმევად გამორთულია. ეშვება მხოლოდ «ნებადართული ბრძანებების» ბრძანებები, ზუსტად ისე, როგორც ჩაწერილია; shell არ არის. გამოტანა მიდის აგენტთან ან პირდაპირ ჩატში, და ყოველი გაშვება ჩანს განრიგის გაშვებების ჟურნალში. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_SCHEDULE_COMMANDS_ALLOWLIST` | ნებადართული ბრძანებები | `argvlist` | — | დაუყოვნებლივ | ზუსტი ბრძანებები, რომელთა გაშვებაც განრიგს შეუძლია: პროგრამა (df-ის მსგავსი სახელი ან სრული გზა) და მისი არგუმენტები. განრიგი უშვებს მხოლოდ იმ ბრძანებას, რომელიც არგუმენტებიანად ზუსტად ემთხვევა ჩანაწერს. წაშლილი ბრძანება აჩერებს მის გამომყენებელ განრიგებს, და მათი გაშვებები მიზეზს ასახელებს. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_SCHEDULE_COMMANDS_MAX_OUTPUT_KB` | განრიგის ბრძანების გამოტანის ლიმიტი, KB | `int 1…1024` | `64` | დაუყოვნებლივ | ბრძანების გამოტანის რა ნაწილი (1–1024 KB) ინახება გაშვებების ჟურნალში და გადაეცემა აგენტს ან ჩატს; დანარჩენი იჭრება და ჟურნალი ამას აღნიშნავს. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_SCHEDULE_COMMANDS_SANDBOX` | განრიგის ბრძანებების გაშვება ოს-ის ქვიშის ყუთში | `bool` | `1` | დაუყოვნებლივ | ჩართული: ბრძანება ეშვება ოს-ის ქვიშის ყუთში, როგორც კოდის შესრულება — ინსტალაციის საიდუმლოებები და SSH გასაღებები დამალულია, ჩაწერა კი შესაძლებელია მხოლოდ საკუთარ დროებით საქაღალდეში. თუ სერვერზე ქვიშის ყუთი (bubblewrap) არ არის, ბრძანება არ ეშვება და ჟურნალი მიზეზს ასახელებს. გამორთული: ეშვება კარიბჭის უფლებებით. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_SCHEDULE_FAILURE_ADMIN` | წარუმატებელი დავალებების შესახებ ადმინისტრატორის ინფორმირება | `bool` | `1` | დაუყოვნებლივ | როცა დაგეგმილი დავალება ვერ სრულდება ან ვერ იწყება, პანელის შეტყობინებების ზარში ჩნდება შეტყობინება მისი სახელით, მიზეზით და იმით, სად გასწორდეს, და იგივე იგზავნება მფლობელების პირად არხულ ჩატებში (დავალებაზე არაუმეტეს ერთხელ 6 საათში). ეს დამატებითია დავალების მიმღებისთვის გაგზავნილ შეტყობინებაზე. გამორთულია: ადმინისტრატორი შეფერხებების შესახებ მხოლოდ გაშვებების ჟურნალიდან იგებს. მოქმედებს მაშინვე. | | `AIHUMMER_SCHEDULE_FAILURE_NOTIFY` | დავალების შეცდომის შესახებ მიმღების შეტყობინება | `bool` | `1` | დაუყოვნებლივ | როცა განრიგით დავალება ვერ სრულდება, იმავე მიმღებს ეგზავნება მოკლე შეტყობინება (პირველი შეცდომის შემდეგ, 6 საათში არაუმეტეს ერთხელ). გამორთული — შეცდომები ჩანს მხოლოდ გაშვებების ჟურნალში. ცალკეული დავალებისთვის ეს შეიძლება გამოირთოს მის ფორმაში. მოქმედებს მაშინვე. | ## Security | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_AIRGAPPED` | იზოლირებული რეჟიმი (ინტერნეტის გარეშე) | `bool` | `0` | დაუყოვნებლივ | აგენტებს ინტერნეტში გასვლას უკრძალავს: ვებძიება, გვერდების გახსნა და მოთხოვნები მხოლოდ შიდა მისამართებსა და ნებადართულ სიებში არსებულ მისამართებს აღწევს. ჩართეთ დახურული ქსელებისთვის გარე წვდომის გარეშე. | | `AIHUMMER_AUDIT_RETENTION_DAYS` | რამდენ დღეს შეინახოს ქმედებების ჟურნალი | `int` | `0` | გადატვირთვის შემდეგ | აუდიტის ჟურნალისა და პარამეტრების ცვლილებების ისტორიის ამ ვადაზე ძველი ჩანაწერები დღეში ერთხელ იშლება. 0 ან ცარიელი — შენახვა სამუდამოდ. | | `AIHUMMER_CORS_ORIGINS` | ნებადართული CORS Origin-ები | `list` | — | გადატვირთვის შემდეგ | ნებადართული Origin-ების სია მძიმით გამოყოფილი. ცარიელი = CORS აკრძალულია (მხოლოდ same-origin). მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_CSP` | Content-Security-Policy ჰედერი (გადაფარვა) | `text` | — | გადატვირთვის შემდეგ | გადაფარავს CSP-სათაურს. ცარიელი = უსაფრთხო ნაგულისხმევი. მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_INBOUND_SECRET` | არხების პლაგინების სერვერთან კავშირის გასაღები | `text` | — | გადატვირთვის შემდეგ | დაკავშირებული არხები (Telegram, VK და სხვ.) ამით ადასტურებენ, რომ შეტყობინებები ნამდვილად მათგან მოდის. ინსტალაციისას ავტომატურად დგინდება — შეცვლა არ არის საჭირო. თუ ცარიელია, სერვერი უარყოფს ყველა არხს, სანამ გასაღები არ მიეთითება. | | `AIHUMMER_OPENAI_COMPAT_KEY` | OpenAI-თავსებადი შემომავალი: სტატიკური API-გასაღები | `text` | — | გადატვირთვის შემდეგ | საერთო გასაღები პროგრამებისთვის, რომლებიც სერვერს OpenAI-თავსებადი სერვისივით უკავშირდებიან. ცარიელი — საერთო გასაღები გამორთულია; დაკავშირება შეიძლება პირადი გასაღებებით „API გასაღებების“ გვერდიდან. | | `AIHUMMER_OPENAI_COMPAT_WORKSPACE` | OpenAI-თავსებადი შემომავალი: სამუშაო სივრცის ID | `text` | — | გადატვირთვის შემდეგ | სამუშაო სივრცის ID, რომელზეც აისახება სტატიკური OpenAI-თავსებადი ავთენტიფიკაცია. ცარიელი = AIHUMMER_DEFAULT_WORKSPACE_ID. მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_REQUIRE_2FA` | ოპერატორებისთვის 2FA-ს მოთხოვნა | `bool` | `0` | დაუყოვნებლივ | მოითხოვს მეორე ფაქტორს (TOTP/passkey) ოპერატორებისთვის. ჩართვისას 2FA-ს გარეშე ოპერატორებს შესვლისას მაშინვე სთავაზობს მის გამართვას (დაბლოკვის გარეშე, რომ მფლობელი არ ჩაიკეტოს). მოქმედებს მაშინვე. | | `AIHUMMER_REQUIRE_SECURE` | მხოლოდ დაცული (HTTPS/WSS) კავშირების მიღება | `bool` | `0` | გადატვირთვის შემდეგ | როცა ჩართულია, ჩვეულებრივი HTTP-მოთხოვნები გადამისამართდება HTTPS-ზე (GET/HEAD-ისთვის) ან უარიყოფა (403); localhost-იდან წვდომა ყოველთვის დაშვებულია, რომ ოპერატორი არ დაიბლოკოს. ითვალისწინებს X-Forwarded-Proto-ს TLS-ის დამამთავრებელი რევერს-პროქსიდან. მოქმედებს გაშვებისას/გადატვირთვის შემდეგ. | | `AIHUMMER_TRUSTED_PROXIES` | სანდო პროქსები | `list` | — | დაუყოვნებლივ | თუ სერვერის წინ პროქსია (nginx, Caddy, დამბალანსებელი), მძიმით ჩაწერეთ მისი მისამართი ან ქსელი, მაგ. 10.0.0.0/8. მაშინ ქმედებების ჟურნალში, ნებადართული IP-ების სიაში და პაროლის გამოცნობისგან დაცვაში ვიზიტორის ნამდვილი მისამართი გამოჩნდება. ცარიელი — ითვლება მხოლოდ პირდაპირი კავშირის მისამართი და მისი გაყალბება შეუძლებელია. | ## Tools | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_BROWSER_ALLOWED_HOSTNAMES` | ბრაუზერი: კერძო ჰოსტების გამონაკლისები | `list` | — | დაუყოვნებლივ | მძიმით გამოყოფილი ზუსტი სახელები, შაბლონების, URL-ებისა და პორტების გარეშე. დამატებითი კერძო გამონაკლისები საკუთარი სერვერის ადგილობრივი CDP-სთვის, web_fetch-ისგან ცალკე. | | `AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK` | ბრაუზერი: კერძო ქსელის დაშვება | `bool` | — | დაუყოვნებლივ | ცარიელი მნიშვნელობა ინარჩუნებს წინა წესს; true ან false რთავს შემოწმებად ადგილობრივ CDP-ს. კერძო წვდომა მხოლოდ საკუთარ სერვერზეა. Loopback, link-local და metadata იბლოკება. | | `AIHUMMER_BROWSER_PROFILE_SOCKET` | ბრაუზერის პროფილების მართვის სოკეტი | `text` | — | დაუყოვნებლივ | არასავალდებულო. დატოვეთ ცარიელი — კარიბჭე თავად პოულობს ბრაუზერის სერვისის managed-profiles.sock მართვის სოკეტს ინსტალაციის სტანდარტულ ადგილას. საიტებზე შესული პროფილები იქმნება გვერდზე «კავშირები» → «ბრაუზერის პროფილები». ეს არ არის URL და არც საწყისი პროფილის გზა. | | `AIHUMMER_CODE_EXEC` | აგენტის მიერ კოდის შესრულება | `enum: off \\\| host \\\| sandbox` | `off` | დაუყოვნებლივ | აგენტის კოდის შესრულების ხელსაწყო (code_exec). ნაგულისხმევად — «გამორთული». «ამ სერვერზე»: ბრძანებები სრულდება კარიბჭის სერვერზე; ოპერაციული სისტემის ქვიშის ყუთი (bubblewrap) მალავს ინსტალაციის საიდუმლოებებს, მაგრამ «შეზღუდვების გარეშე» რეჟიმში აგენტი ხედავს SSH გასაღებებს და შეუძლია ჩაწეროს თავისი საქაღალდის გარეთ — მხოლოდ სანდო სერვერისთვის. «მხოლოდ ქვიშის ყუთში»: ყოველთვის ოპერაციული სისტემის ქვიშის ყუთში — საიდუმლოებები და გასაღებები დამალულია, ჩაწერა მხოლოდ აგენტის საქაღალდეში; bubblewrap-ის (ან კონტეინერის იმიჯის) გარეშე ეს რეჟიმი არ ინახება. რისი გაშვება შეუძლია თითოეულ აგენტს, ეს აგენტთან განისაზღვრება: აგენტები → პროფილი → ხელსაწყოები. | | `AIHUMMER_CODE_EXEC_INTERPRETERS` | Code-exec ინტერპრეტატორები (JSON) | `text` | — | დაუყოვნებლივ | JSON-ობიექტი {language: path_to_binary}, მაგ. {\\"python\\":\\"/usr/bin/python3\\"}. ცარიელი = ავტომატური ამოცნობა. | | `AIHUMMER_CODE_EXEC_NET_PORTS` | აგენტის კოდისთვის გახსნილი ქსელის პორტები | `list` | `53,80,443` | დაუყოვნებლივ | TCP პორტები, რომლებთანაც აგენტის კოდს ოს-ის ქვიშის ყუთში (კოდის შესრულება და განრიგის ბრძანებები) შეუძლია დაკავშირება, მძიმით გამოყოფილი. ნაგულისხმევად 53, 80 და 443: DNS და ვებსაიტები. ამ სერვერისა და მისი ლოკალური ქსელის სხვა სერვისები (მონაცემთა ბაზა, მართვის პანელი, ბრაუზერი, adb, ლოკალური მოდელები, Home Assistant) აგენტის კოდისთვის დახურულია. სიის პორტი ღიაა ნებისმიერ მისამართზე, მათ შორის ამ სერვერზე, ამიტომ დაამატეთ მხოლოდ ის, რაც კოდს სჭირდება, მაგალითად 22 SSH-ისთვის. შეზღუდვის მოსახსნელად ჩაწერეთ any. «შეზღუდვების გარეშე» რეჟიმის აგენტებზე ის არ ვრცელდება. საჭიროა Linux 6.7 ან უფრო ახალი; მის გარეშე შეზღუდვა არ მოქმედებს და ამას აღნიშნავს აგენტები → ხელსაწყოები. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_CODE_EXEC_READ_DIRS` | აგენტის კოდისთვის წასაკითხად გახსნილი საქაღალდეები | `list` | — | დაუყოვნებლივ | ამ სერვერის საქაღალდეები, რომლებსაც აგენტის კოდი კითხულობს: კოდის შესრულება და განრიგის ბრძანებები ოს-ის ქვიშის ყუთში. მძიმით გამოყოფილი ან თითო სტრიქონზე, მაგალითად ~/reports. შეგიძლიათ მიუთითოთ ცალკე ფაილიც, მაგალითად ~/scripts/report.py. აქ გახსნილი ყველა აგენტის კოდისთვის ჩანს, ამიტომ გახსენით მხოლოდ ის, რაც კოდს სჭირდება. ნაგულისხმევად ცარიელია: ქვიშის ყუთში კოდი ხედავს მხოლოდ თავისი აგენტის საქაღალდეს და სისტემურ საქაღალდეებს; კარიბჭის მომხმარებლის საშინაო საქაღალდე, ინსტალაციის მონაცემები, სხვა აგენტების საქაღალდეები, გასაღებები და ბრძანებების ისტორია დამალულია. ძირი, მთელი საშინაო საქაღალდე, ინსტალაციის მონაცემები და გასაღებიანი ადგილები ვერ გაიხსნება. კოდს ამ საქაღალდეებში ჩაწერა არ შეუძლია. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_CODE_EXEC_SANDBOX_IMAGE` | Code-exec-ის ქვიშის ყუთის იმიჯი | `text` | — | დაუყოვნებლივ | არასავალდებულო, მხოლოდ «მხოლოდ ქვიშის ყუთში» რეჟიმისთვის: Docker კონტეინერის იმიჯი ოპერაციული სისტემის ქვიშის ყუთის ნაცვლად (ქსელის გარეშე, მხოლოდ წასაკითხი ძირი, ლიმიტები); სერვერზე საჭიროა Docker. ცარიელი = ოპერაციული სისტემის ქვიშის ყუთი (bubblewrap). | | `AIHUMMER_CODE_EXEC_TIMEOUT_SECONDS` | კოდის შესრულების დროის ლიმიტი (წამი) | `int` | `1800` | დაუყოვნებლივ | რამდენ ხანს შეიძლება იმუშაოს აგენტის ერთმა ბრძანებამ, ფონურის ჩათვლით: 10 წამიდან 24 საათამდე. ბრძანება, რომელიც 30 წამში არ პასუხობს, არ წყდება, არამედ ფონზე გადადის, სადაც აგენტი მას process ხელსაწყოთი ამოწმებს. აგენტს შეუძლია უფრო მოკლე ვადა მოითხოვოს, უფრო გრძელი — არა. | | `AIHUMMER_DB_QUERY_DSN` | მონაცემთა ბაზის კავშირი ინსტრუმენტისთვის „მოთხოვნა ბაზაში“ | `text` | — | დაუყოვნებლივ | მონაცემთა ბაზის კავშირის სტრიქონი, რომლის წაკითხვაც აგენტს შეუძლია (მხოლოდ წაკითხვა), მაგ. postgres://reader:password@host/db. მიუთითეთ მინიმალური უფლებების მქონე მომხმარებელი — არა ბაზის მფლობელი. ცარიელი — ინსტრუმენტი გამორთულია. | | `AIHUMMER_FS_ROOT` | ფაილური სისტემის ხელსაწყოს ძირი | `text` | — | დაუყოვნებლივ | საქაღალდე, რომლის ფარგლებშიც აგენტი კითხულობს სერვერის ფაილებს (filesystem_read; აგენტებს ფაილების ჩაწერა არ შეუძლიათ). ცარიელი = მთელი სერვერი შლუზის მომხმარებლის უფლებებით, საიდუმლოებების გარდა: ინსტალაციის პარამეტრები (gateway.env), SSH/GPG გასაღებები და პროცესების გარემო. წვდომის შესაზღუდად მიუთითეთ საქაღალდე. | | `AIHUMMER_HTTP_ALLOWLIST` | მისამართები აგენტის HTTP მოთხოვნებისთვის | `list` | — | დაუყოვნებლივ | მძიმეებით გამოყოფილი ჰოსტების სია, რომლებსაც შეუძლია მიმართოს ხელსაწყო http_request. ცარიელი = ნებადართულია ყველა, გარდა შიდა და კერძო მისამართებისა. | | `AIHUMMER_HTTP_AUTH_JSON` | http_request ავტორიზაცია (JSON) | `text` | — | დაუყოვნებლივ | ხელსაწყო http_request-ისთვის ჰოსტისა და ავტორიზაციის სათაურების შესაბამისობის JSON რუკა, რომ ტოკენები არ ინახებოდეს მოთხოვნის ტექსტში. ცარიელი = ავტორიზაციის გარეშე. | | `AIHUMMER_MCP_SERVERS` | MCP სერვერები (JSON) | `text` | — | დაუყოვნებლივ | გარე MCP სერვერების JSON აღწერა, რომელთა ხელსაწყოებიც უერთდება აგენტს. ცარიელი = გარე MCP არ არის. | | `AIHUMMER_PROJECT_STUDIOS_PUBLIC_NETWORK` | პროექტების სტუდიები: საჯარო ქსელი | `bool` | `false` | დაუყოვნებლივ | დაუშვით საჯარო HTTP(S) არჩეული მომწოდებლებისა და პირდაპირ მოთხოვნილი მოდელების ჩამოტვირთვისთვის. პირადი, ლოკალური და მეტამონაცემების მისამართები დაბლოკილი რჩება. ოფლაინ რეჟიმს უპირატესობა აქვს. ძალაში შედის დაუყოვნებლივ. | | `AIHUMMER_SIDECAR_CLOAKBROWSER` | ბრაუზერი აგენტისთვის (CloakBrowser) | `bool` | `0` | დაუყოვნებლივ | ანტი-გამოვლენის ბრაუზერი (CloakBrowser, browser/computer ინსტრუმენტები). რა არ შედის მიწოდების პაკეტში: ჩართვა ჩამოტვირთავს ხელმოწერილ დანამატს (~477 MiB, აქედან Chromium ~207 MiB) და აყენებს სერვისს ჰოსტზე. ყველაზე მძიმე გვერდითი კარები - ჩართეთ მხოლოდ იმ შემთხვევაში, თუ აგენტს სჭირდება ვებსაიტების გახსნა. | | `AIHUMMER_SIDECAR_SEARXNG` | ვებძიება (SearXNG) | `bool` | `0` | დაუყოვნებლივ | ვებ ძიება (SearXNG, web_search ინსტრუმენტი). არ შედის პაკეტში: ჩართვა ჩამოტვირთავს ხელმოწერილ დანამატს (~154 MiB) და დაინსტალირებს სერვისს ჰოსტზე, გამორთვა აჩერებს მას და ათავისუფლებს ადგილს. ინსტალაცია ხდება ფონზე და იღებს რამდენიმე წუთს; მდგომარეობა აქ აჩვენებს რა არის რეალურად სერვერზე. | | `AIHUMMER_WEBFETCH_ALLOWLIST` | საიტები, რომელთა გახსნაც აგენტს შეუძლია | `list` | — | დაუყოვნებლივ | მძიმეებით გამოყოფილი დომენების სია, რომლებსაც შეუძლია მიმართოს ხელსაწყო web_fetch. ცარიელი = ნებადართულია ყველა, გარდა შიდა და კერძო მისამართებისა. | | `AIHUMMER_WEB_SEARCH_LANGUAGE` | ვებ-ძიება: შედეგების ნაგულისხმევი ენა | `text` | `auto` | დაუყოვნებლივ | შედეგების ენა, როცა აგენტი მას არ მიუთითებს: კოდი, მაგალითად ru, en ან de, ან auto — მოთხოვნიდან განსაზღვრისთვის (თითქმის ყოველთვის გამოდგება). აგენტს შეუძლია კონკრეტული ძიებისთვის სხვა ენა აირჩიოს. | | `AIHUMMER_WEB_SEARCH_RESULTS` | ვებ-ძიება: შედეგები ერთ ძიებაზე | `int` | `5` | დაუყოვნებლივ | რამდენ შედეგს აბრუნებს ძიება, როცა აგენტი რაოდენობას არ ითხოვს: 1-დან 10-მდე. მეტი შედეგი უფრო სრულ პასუხს იძლევა, მაგრამ კონტექსტს აგრძელებს. | | `AIHUMMER_WEB_SEARCH_SOURCE` | ვებ-ძიების წყარო | `enum: auto \\\| searxng \\\| provider` | `auto` | დაუყოვნებლივ | სად ეძებს აგენტი ინტერნეტში (web_search ხელსაწყო). auto — SearXNG, თუ დაყენებულია, წინააღმდეგ შემთხვევაში მოდელის მომწოდებლის ჩაშენებული ძიება. searxng — მხოლოდ SearXNG: მის გარეშე ძიება არ არის. provider — მომწოდებლის ჩაშენებული ძიება, სადაც ის არის, ხოლო SearXNG — სხვა მოდელებისთვის. ჩაშენებული ძიება აქვს Codex-ს (ChatGPT გამოწერა) და OpenAI-ს (api.openai.com); GigaChat-ს, YandexGPT-ს და სხვა OpenAI-თავსებად მოდელებს ის არ აქვთ — SearXNG-ის გარეშე ამ მოდელებზე აგენტები არ ეძებენ. Claude (api.anthropic.com და Claude-ის გამოწერა) იყენებს Anthropic-ის ჩაშენებულ ძიებას; თუ ანგარიში მას უარყოფს, შლუზი ამას ჟურნალში წერს და შემდეგ აგენტს მხოლოდ SearXNG-ს სთავაზობს. რომელ აგენტებს შეუძლიათ ძიება, ისევ აგენტის ბარათში განისაზღვრება. მოქმედებს შემდეგი სვლიდან. | | `AIHUMMER_WEB_SEARCH_TIMEOUT_SECONDS` | ვებძიების ვადა (წამი) | `int` | `30` | დაუყოვნებლივ | თითო ძიებაზე1–600 წამი. დავალების უფრო მოკლე ვადა ძალაში რჩება. | ## Updates | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_RESTART_APPLY` | გადატვირთვის საჭიროების მქონე პარამეტრების გამოყენება | `enum: quiet \\\| manual` | `quiet` | დაუყოვნებლივ | quiet (ნაგულისხმევი) — შენახული პარამეტრები, რომლებიც ძალაში შედის მხოლოდ კარიბჭის ახალი გაშვებით, თავისით გამოიყენება: კარიბჭე გადაიტვირთება უახლოეს მშვიდ მომენტში, როცა აგენტები არაფერს აკეთებენ და ადამიანები სიჩუმის ფანჯარაზე ნაკლებს არ დუმან. manual — მხოლოდ ნიშანი „ელოდება გადატვირთვას“ და ღილაკი. გადატვირთვა რამდენიმე წამს გრძელდება; საუბრები და ამოცანები არ იკარგება. მოქმედებს დაუყოვნებლივ. | | `AIHUMMER_RESTART_QUIET_MINUTES` | მშვიდი მომენტი: სიჩუმის წუთები ავტომატურ გადატვირთვამდე | `int 0…1440` | `10` | დაუყოვნებლივ | რამდენი წუთი უნდა დუმდნენ ადამიანები (და იყვნენ აგენტები უსაქმოდ), რომ კარიბჭე თავად გადაიტვირთოს და შენახული პარამეტრები გამოიყენოს. 0 — როგორც კი აგენტები მიმდინარე სამუშაოს დაასრულებენ. 0–1440. მოქმედებს დაუყოვნებლივ. | ## Web UI (separate port) | გასაღები | სახელი | ტიპი | ნაგულისხმევი | ძალაში შედის | რას აკეთებს | | --- | --- | --- | --- | --- | --- | | `AIHUMMER_WEBUI_API_BASE` | სერვერის მისამართი ცალკე განთავსებული პანელისთვის | `text` | — | გადატვირთვის შემდეგ | საჭიროა მხოლოდ მაშინ, თუ პანელი სერვერისგან განსხვავებული მისამართიდან იხსნება. მიუთითეთ მისამართი, რომლითაც ბრაუზერი სერვერს მიწვდება, მაგ. https://api.example.com. ცარიელი — გამოიყენება სერვერის საჯარო მისამართი, ხოლო თუ ის არ არის — ლოკალური. | | `AIHUMMER_WEBUI_ENABLED` | პანელი ცალკე პორტზე | `bool` | `1` | გადატვირთვის შემდეგ | ჩართული — პანელი იხსნება ცალკე შიდა პორტზე, რომლის ინტერნეტისგან დახურვაც შეიძლება, საჯარო პორტი კი მხოლოდ აპებსა და არხებს ემსახურება. გამორთეთ, რომ პანელი საერთოდ მიუწვდომელი იყოს. | | `AIHUMMER_WEBUI_ORIGIN` | მისამართი, რომლითაც პანელი იხსნება | `text` | — | გადატვირთვის შემდეგ | შეავსეთ, თუ პანელს ხსნიან პროქსით ან სახელით, რომელიც მისი პორტის მისამართისგან განსხვავდება, მაგ. https://admin.example.com. სერვერი ამ მისამართიდან ბრაუზერს მასთან დაკავშირების ნებას მისცემს. ცარიელი — აიღება პანელის პორტის მისამართი. | ოპერატორისთვის ხელმისაწვდომი პარამეტრები: 237.