კონფიგურაცია

PRX იყენებს TOML-ზე დაფუძნებულ კონფიგურაციის სისტემას ცხელი გადატვირთვის მხარდაჭერით. ყველა პარამეტრი ერთ ფაილშია (არასავალდებულო გაყოფილი ფრაგმენტებით) და ცვლილებების უმეტესობა ძალაში შედის დემონის გადატვირთვის გარეშე.

კონფიგურაციის ფაილის მდებარეობა

ძირითადი კონფიგურაციის ფაილი არის:

~/.openprx/config.toml

PRX კონფიგურაციის დირექტორიას განსაზღვრავს შემდეგი თანმიმდევრობით:

1. OPENPRX_CONFIG_DIR გარემოს ცვლადი (თუ დაყენებულია)
2. OPENPRX_WORKSPACE გარემოს ცვლადი (თუ დაყენებულია)
3. აქტიური სამუშაო სივრცის მარკერი (~/.openprx/active_workspace.toml)
4. ~/.openprx/ (ნაგულისხმევი)

სამუშაო სივრცის დირექტორია (სადაც ინახება მეხსიერება, სესიები და მონაცემები) ნაგულისხმევად არის ~/.openprx/workspace/.

TOML ფორმატი

PRX კონფიგურაცია იყენებს TOML ფორმატს -- მინიმალური, ადამიანისთვის წაკითხვადი ფორმატი. აქ არის მინიმალური მოქმედი კონფიგურაცია:

# პროვაიდერისა და მოდელის არჩევა
default_provider = "anthropic"
default_model = "anthropic/claude-sonnet-4-6"
default_temperature = 0.7

# API გასაღები (ან გამოიყენეთ ANTHROPIC_API_KEY გარემოს ცვლადი)
api_key = "sk-ant-..."

# მეხსიერების ბექენდი
[memory]
backend = "sqlite"
auto_save = true

# გეითვეი სერვერი
[gateway]
port = 16830
host = "127.0.0.1"

კონფიგურაციის სექციები

კონფიგურაცია ორგანიზებულია შემდეგ ზედა დონის სექციებად:

სექცია	დანიშნულება
(ზედა დონე)	ნაგულისხმევი პროვაიდერი, მოდელი, ტემპერატურა, API გასაღები
[gateway]	HTTP გეითვეი: ჰოსტი, პორტი, დაწყვილება, რეიტ ლიმიტები
[channels_config]	შეტყობინებების არხები: Telegram, Discord, Slack და ა.შ.
[channels_config.telegram]	Telegram ბოტის კონფიგურაცია
[channels_config.discord]	Discord ბოტის კონფიგურაცია
[memory]	მეხსიერების ბექენდი და ემბედინგის პარამეტრები
[router]	ევრისტიკული LLM მარშრუტიზატორი და Automix
[security]	სენდბოქსი, რესურსის ლიმიტები, აუდიტის ლოგირება
[autonomy]	ავტონომიის დონეები და ინსტრუმენტების მოქმედების სფეროს წესები
[observability]	მეტრიკებისა და ტრეისინგის ბექენდი
[mcp]	Model Context Protocol სერვერის ინტეგრაცია
[browser]	ბრაუზერის ავტომატიზაციის ინსტრუმენტის პარამეტრები
[web_search]	ვებ ძიებისა და მოხელთების ინსტრუმენტის პარამეტრები
[xin]	Xin ავტონომიური ამოცანების ძრავა
[reliability]	ხელახალი მცდელობისა და სარეზერვო პროვაიდერის ჯაჭვები
[cost]	ხარჯვის ლიმიტები და მოდელის ფასი
[cron]	დაგეგმილი ამოცანების განსაზღვრებები
[self_system]	თვითევოლუციის ძრავის კონტროლი
[proxy]	HTTP/HTTPS/SOCKS5 პროქსის პარამეტრები
[secrets]	დაშიფრული რწმუნებათა სიგელების საცავი
[auth]	გარე რწმუნებათა სიგელების იმპორტი (Codex CLI და ა.შ.)
[storage]	მუდმივი შენახვის პროვაიდერი
[tunnel]	საჯარო გვირაბის გამოქვეყნება
[nodes]	დისტანციური კვანძის პროქსის კონფიგურაცია

იხილეთ კონფიგურაციის მითითება ველ-ველზე სრული დოკუმენტაციისთვის.

კონფიგურაციის გაყოფილი ფაილები

რთული განთავსებებისთვის PRX მხარს უჭერს კონფიგურაციის გაყოფას ფრაგმენტულ ფაილებად config.d/ დირექტორიაში config.toml-ის გვერდით:

~/.openprx/
  config.toml          # მთავარი კონფიგურაცია (ზედა დონე + ჩანაცვლებები)
  config.d/
    channels.toml      # [channels_config] სექცია
    memory.toml        # [memory] და [storage] სექციები
    security.toml      # [security] და [autonomy] სექციები
    agents.toml        # [agents] და [sessions_spawn] სექციები
    identity.toml      # [identity] და [identity_bindings] სექციები
    network.toml       # [gateway], [tunnel] და [proxy] სექციები
    scheduler.toml     # [scheduler], [cron] და [heartbeat] სექციები

ფრაგმენტული ფაილები ერწყმის config.toml-ს (ფრაგმენტებს აქვთ უპირატესობა). ფაილები ჩაიტვირთება ანბანური თანმიმდევრობით.

როგორ შეცვალოთ

ინტერაქტიული ოსტატი

ონბორდინგის ოსტატი გაგატარებთ პროვაიდერის არჩევაში, არხების დაყენებასა და მეხსიერების კონფიგურაციაში:

prx onboard

CLI კონფიგურაციის ბრძანებები

კონფიგურაციის ნახვა და შეცვლა ბრძანების ხაზიდან:

# მიმდინარე კონფიგურაციის ჩვენება
prx config show

# კონკრეტული მნიშვნელობის შეცვლა
prx config set default_provider anthropic
prx config set default_model "anthropic/claude-sonnet-4-6"

# ხელით გადატვირთვის გაშვება
prx config reload

პირდაპირი რედაქტირება

გახსენით ~/.openprx/config.toml ნებისმიერ ტექსტურ რედაქტორში. ცვლილებები ავტომატურად აღმოჩნდება ფაილის მეთვალყურის მიერ და გამოყენდება 1 წამის განმავლობაში (იხილეთ ცხელი გადატვირთვა).

სქემის ექსპორტი

ექსპორტირეთ სრული კონფიგურაციის სქემა JSON Schema სახით რედაქტორის ავტოდასრულებისა და ვალიდაციისთვის:

prx config schema

ეს გამოიტანს JSON Schema დოკუმენტს, რომელიც შეიძლება გამოყენებულ იქნას VS Code-თან, IntelliJ-თან ან ნებისმიერ რედაქტორთან, რომელიც მხარს უჭერს TOML სქემის ვალიდაციას.

ცხელი გადატვირთვა

კონფიგურაციის ცვლილებების უმეტესობა გამოიყენება დაუყოვნებლივ, PRX-ის გადატვირთვის გარეშე. ფაილის მეთვალყურე იყენებს 1-წამიან დებაუნს ფანჯარას და ატომურად ცვლის ცოცხალ კონფიგურაციას წარმატებული პარსინგისას. თუ ახალ ფაილს აქვს სინტაქსის შეცდომები, წინა კონფიგურაცია შენარჩუნდება და გაფრთხილება ჩაიწერება ლოგში.

იხილეთ ცხელი გადატვირთვა დეტალებისთვის იმის შესახებ, თუ რა მოითხოვს გადატვირთვას.

შემდეგი ნაბიჯები

• კონფიგურაციის მითითება -- ველ-ველზე სრული დოკუმენტაცია
• ცხელი გადატვირთვა -- რა ცვლილებები მოქმედებს ცოცხლად და რა მოითხოვს გადატვირთვას
• გარემოს ცვლადები -- გარემოს ცვლადები, API გასაღებები და .env მხარდაჭერა
• LLM პროვაიდერები -- პროვაიდერის სპეციფიკური კონფიგურაცია