ონბორდინგის ოსტატი

prx onboard ბრძანება ქმნის თქვენს საწყის კონფიგურაციის ფაილს, გაგატარებთ პროვაიდერის არჩევაში, API გასაღების შეყვანაში, მოდელის არჩევაში და მეხსიერების ბექენდის დაყენებაში. ეს არის PRX-ის პირველად დაკონფიგურირების რეკომენდებული გზა.

რას აკეთებს ონბორდინგი

როდესაც გაუშვებთ prx onboard-ს, ოსტატი ასრულებს შემდეგ ნაბიჯებს:

1. ირჩევს LLM პროვაიდერს -- მოგთხოვთ აირჩიოთ 9 მხარდაჭერილი პროვაიდერიდან (Anthropic, OpenAI, Google Gemini, Ollama, OpenRouter და ა.შ.)
2. ინახავს თქვენს API გასაღებს -- უსაფრთხოდ ჩაწერს თქვენს პროვაიდერის რწმუნებათა სიგელს კონფიგურაციის ფაილში
3. იღებს ხელმისაწვდომ მოდელებს -- მიმართავს პროვაიდერის API-ს იმ მოდელების ჩამოთვლით, რომლებზეც გაქვთ წვდომა
4. აყენებს ნაგულისხმევ მოდელს -- საშუალებას გაძლევთ აირჩიოთ ნაგულისხმევად გამოსაყენებელი მოდელი
5. აკონფიგურირებს მეხსიერების ბექენდს -- ირჩევს Markdown-ს (ფაილზე დაფუძნებული), SQLite-ს ან PostgreSQL-ს შორის
6. წერს კონფიგურაციის ფაილს -- ქმნის ~/.config/openprx/openprx.toml-ს თქვენი პარამეტრებით

ონბორდინგის შემდეგ PRX მზადაა გასაშვებად prx daemon ან prx chat ბრძანებით.

ინტერაქტიული რეჟიმი

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

prx onboard --interactive

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

• გეითვეის ჰოსტისა და პორტის პარამეტრები
• არხების წინასწარი კონფიგურაცია (Telegram, Discord და ა.შ.)
• უსაფრთხოება და ავტონომიის დონე
• სამუშაო სივრცის დირექტორია
• დაკვირვებადობის პარამეტრები

სწრაფი დაყენება (ნაგულისხმევი)

ნაგულისხმევი prx onboard აწარმოებს გამარტივებულ სწრაფ დაყენებას:

prx onboard

ეს ითხოვს თქვენს პროვაიდერს, API გასაღებს და მოდელს -- მეტს არაფერს. ყველა დანარჩენი პარამეტრი იყენებს გონივრულ ნაგულისხმევ მნიშვნელობებს.

სწრაფი დაყენება ფლაგებით

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

prx onboard \
  --provider anthropic \
  --api-key sk-ant-api03-xxxxxxxxxxxx \
  --model claude-sonnet-4-20250514

ხელმისაწვდომი ფლაგები:

ფლაგი	აღწერა	მაგალითი
--provider	LLM პროვაიდერის სახელი	anthropic, openai, ollama, openrouter
--api-key	პროვაიდერის API გასაღები ან რწმუნებათა სიგელი	sk-ant-..., sk-...
--model	ნაგულისხმევი მოდელის იდენტიფიკატორი	claude-sonnet-4-20250514, gpt-4o
--memory	მეხსიერების ბექენდი	markdown, sqlite, postgres
--interactive	სრული ინტერაქტიული ოსტატის გაშვება	(მნიშვნელობა არ არის)
--channels-only	მხოლოდ არხების შეკეთების ოსტატის ხელახლა გაშვება	(მნიშვნელობა არ არის)

მაგალითები

Anthropic Claude ნაგულისხმევი პარამეტრებით:

prx onboard --provider anthropic --api-key "$ANTHROPIC_API_KEY"

ლოკალური Ollama (API გასაღები არ არის საჭირო):

prx onboard --provider ollama --model llama3.2

OpenRouter კონკრეტული მოდელით:

prx onboard --provider openrouter --api-key "$OPENROUTER_API_KEY" --model anthropic/claude-sonnet-4-20250514

OpenAI SQLite მეხსიერებით:

prx onboard --provider openai --api-key "$OPENAI_API_KEY" --model gpt-4o --memory sqlite

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

ონბორდინგის ოსტატი წერს კონფიგურაციას:

~/.config/openprx/openprx.toml

Linux-ზე ეს მიჰყვება XDG Base Directory სპეციფიკაციას. macOS-ზე იყენებს ~/Library/Application Support/openprx/openprx.toml-ს, თუ XDG_CONFIG_HOME არ არის დაყენებული.

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

prx onboard --provider anthropic --model claude-sonnet-4-20250514-ის გაშვების შემდეგ, გენერირებული კონფიგურაცია ასე გამოიყურება:

# OpenPRX Configuration
# Generated by: prx onboard

# ── Provider ──────────────────────────────────────────────
default_provider = "anthropic"
default_model = "claude-sonnet-4-20250514"
default_temperature = 0.7
api_key = "sk-ant-api03-xxxxxxxxxxxx"

# ── Workspace ─────────────────────────────────────────────
workspace_dir = "~/.local/share/openprx"

# ── Memory ────────────────────────────────────────────────
[memory]
backend = "markdown"
# path defaults to workspace_dir/memory

# ── Gateway ───────────────────────────────────────────────
[gateway]
host = "127.0.0.1"
port = 3120

# ── Channels ──────────────────────────────────────────────
[channels]
cli = true

# ── Security ──────────────────────────────────────────────
[security]
autonomy = "supervised"

ამ ფაილის რედაქტირება ნებისმიერ დროს შეგიძლიათ. PRX მხარს უჭერს ცხელ გადატვირთვას -- ცვლილებების უმეტესობა ძალაში შედის დემონის გადატვირთვის გარეშე.

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

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

სექცია	დანიშნულება
default_provider	ნაგულისხმევად გამოსაყენებელი LLM პროვაიდერი
default_model	ნაგულისხმევად გამოსაყენებელი მოდელი
api_key	პროვაიდერის API რწმუნებათა სიგელი
[memory]	მეხსიერების ბექენდი და შენახვის პარამეტრები
[gateway]	HTTP/WebSocket გეითვეის კონფიგურაცია
[channels]	შეტყობინებების არხების კონფიგურაცია
[channels.telegram]	Telegram ბოტის პარამეტრები
[channels.discord]	Discord ბოტის პარამეტრები
[security]	ავტონომიის დონე, სენდბოქსი, პოლიტიკები
[router]	LLM მარშრუტიზაციის სტრატეგია
[self_system]	თვითევოლუციის პაიპლაინის პარამეტრები
[observability]	მეტრიკები, ტრეისინგი, ლოგირება
[cron]	დაგეგმილი ამოცანების კონფიგურაცია
[plugins]	WASM დანამატების გზები და პარამეტრები

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

ონბორდინგის შემდგომი შემოწმება

ონბორდინგის შემდეგ გაუშვით დიაგნოსტიკის ბრძანება, რომ დარწმუნდეთ ყველაფერი სწორადაა დაკონფიგურირებული:

prx doctor

ექიმი ამოწმებს:

• კონფიგურაციის ფაილს -- ამოწმებს TOML სინტაქსს და აუცილებელ ველებს
• პროვაიდერთან კავშირს -- ტესტავს API გასაღებს პროვაიდერის გამოკითხვით
• მოდელის ხელმისაწვდომობას -- ადასტურებს, რომ არჩეული მოდელი ხელმისაწვდომია
• მეხსიერების ბექენდს -- ამოწმებს, რომ შენახვის ბექენდი ჩაწერადია
• სისტემის დამოკიდებულებებს -- ამოწმებს არასავალდებულო ინსტრუმენტებს (git, docker და ა.შ.)
• ქსელს -- ტესტავს კავშირს დაკონფიგურირებულ სერვისებთან

გამოსავლის მაგალითი:

PRX Doctor

  Config file .............. OK  (~/.config/openprx/openprx.toml)
  Provider (anthropic) ..... OK  (authenticated)
  Model .................... OK  (claude-sonnet-4-20250514)
  Memory (markdown) ........ OK  (writable)
  Gateway port (3120) ...... OK  (available)
  Git ...................... OK  (2.43.0)
  Docker ................... WARN (not installed -- sandbox features limited)

All critical checks passed.

ექიმის ქვებრძანებები

ექიმს ასევე აქვს ქვებრძანებები მიზნობრივი დიაგნოსტიკისთვის:

# მოდელების კატალოგების გამოკვლევა ყველა პროვაიდერისთვის
prx doctor models

# მოდელების გამოკვლევა კონკრეტული პროვაიდერისთვის
prx doctor models --provider anthropic

არხების შეკეთების ოსტატი

თუ უკვე დაასრულეთ ონბორდინგი და გსურთ არხების კონფიგურაციის დამატება ან შეკეთება, გამოიყენეთ --channels-only ფლაგი:

prx onboard --channels-only

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

ონბორდინგის ხელახლა გაშვება

prx onboard ნებისმიერ დროს შეგიძლიათ ხელახლა გაუშვათ. ოსტატი აღმოაჩენს თქვენს არსებულ კონფიგურაციას და შემოგთავაზებთ მის განახლებას, ნულიდან გადაწერის ნაცვლად. თქვენი არსებული არხების კონფიგურაცია, მეხსიერების მონაცემები და მორგებული პარამეტრები შენარჩუნდება.

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

• სწრაფი დაწყება -- გაუშვით დემონი და დაიწყეთ ჩატი
• არხები -- დააკავშირეთ შეტყობინებების პლატფორმები
• კონფიგურაციის მითითება -- ყველა კონფიგურაციის ვარიანტის სრული სია