ვებ ძიება

web_search_tool ინსტრუმენტი PRX აგენტებს ვებში მიმდინარე ინფორმაციის ძიების საშუალებას აძლევს. იგი ორ საძიებო პროვაიდერს უჭერს მხარს -- DuckDuckGo (უფასო, API გასაღები არ სჭირდება) და Brave Search (API გასაღები სავალდებულოა) -- და სტრუქტურირებულ საძიებო შედეგებს აბრუნებს.

ვებ ძიება ფუნქციით გეითირებულია და მოითხოვს web_search.enabled = true კონფიგურაციაში. ჩართვისას PRX ასევე სურვილისამებრ web_fetch ინსტრუმენტს არეგისტრირებს საძიებო შედეგებში ნაპოვნი URL-ებიდან გვერდის სრული კონტენტის ამოღებისთვის.

web_search_tool და web_fetch კომბინაცია აგენტებს ვებ კვლევის სრულ პაიპლაინს აძლევს: შესაბამისი გვერდების ძიება, შემდეგ ყველაზე პერსპექტიული შედეგებიდან კონტენტის ამოღება.

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

[web_search]
enabled = true
provider = "duckduckgo"      # "duckduckgo" (უფასო) ან "brave" (API გასაღები სავალდებულოა)
max_results = 5              # მაქსიმალური შედეგები ძიებაზე (1-10)
timeout_secs = 10            # მოთხოვნის დროის ამოწურვა წამებში

# Brave Search (API გასაღები სავალდებულოა)
# provider = "brave"
# brave_api_key = "BSA-xxxxxxxxxxxx"

# ვებ ამოღება (გვერდის კონტენტის ექსტრაქცია)
fetch_enabled = true         # web_fetch ინსტრუმენტის ჩართვა
fetch_max_chars = 50000      # web_fetch-ის მიერ დაბრუნებული მაქსიმალური სიმბოლოები

პროვაიდერების შედარება

ფუნქცია	DuckDuckGo	Brave Search
ღირებულება	უფასო	უფასო დონე (2000 მოთხოვნა/თვე), ფასიანი გეგმები ხელმისაწვდომია
API გასაღები	არ სჭირდება	სავალდებულოა (brave_api_key)
შედეგების ხარისხი	კარგია ზოგადი მოთხოვნებისთვის	უფრო მაღალი ხარისხი, უკეთ სტრუქტურირებული
ლიმიტები	იმპლიციტური (შეიძლება შეანელოს)	ექსპლიციტური (გეგმის მიხედვით)
კონფიდენციალურობა	კონფიდენციალურობაზე ორიენტირებული	კონფიდენციალურობაზე ორიენტირებული

გამოყენება

web_search_tool

საძიებო ინსტრუმენტი შედეგების სიას აბრუნებს სათაურებით, URL-ებითა და ფრაგმენტებით:

{
  "name": "web_search_tool",
  "arguments": {
    "query": "Rust async runtime comparison tokio vs async-std 2026",
    "max_results": 5
  }
}

web_fetch

საძიებო შედეგებში რელევანტური URL-ების პოვნის შემდეგ, აგენტს შეუძლია კონტენტის ამოღება:

{
  "name": "web_fetch",
  "arguments": {
    "url": "https://blog.example.com/rust-async"
  }
}

web_fetch ინსტრუმენტი:

1. URL-ის დომენს browser.allowed_domains-თან ამოწმებს
2. გვერდის კონტენტს იღებს
3. წაკითხვად ტექსტს ამოიღებს (HTML, სკრიპტები, სტილები ამოშლილია)
4. fetch_max_chars-მდე მოჭრის
5. ამოღებულ კონტენტს აბრუნებს

პარამეტრები

web_search_tool პარამეტრები

პარამეტრი	ტიპი	სავალდებულო	ნაგულისხმევი	აღწერა
query	string	დიახ	--	საძიებო მოთხოვნის სტრიქონი
max_results	integer	არა	კონფიგურაციის მნიშვნელობა (5)	დასაბრუნებელი შედეგების მაქსიმუმი (1-10)

web_fetch პარამეტრები

პარამეტრი	ტიპი	სავალდებულო	ნაგულისხმევი	აღწერა
url	string	დიახ	--	URL, საიდანაც კონტენტის ამოღება და ექსტრაქცია ხდება

ტიპიური კვლევის სამუშაო ნაკადი

სრული ვებ კვლევის სამუშაო ნაკადი ჩვეულებრივ ამ შაბლონს მიჰყვება:

1. ძიება: აგენტი web_search_tool-ს იყენებს რელევანტური გვერდების მოსაძებნად
2. შეფასება: აგენტი საძიებო ფრაგმენტებს განიხილავს ყველაზე რელევანტური შედეგების დასადგენად
3. ამოღება: აგენტი web_fetch-ს იყენებს შერჩეული გვერდებიდან სრული კონტენტის ამოსაღებად
4. სინთეზი: აგენტი მრავალი წყაროდან ინფორმაციას პასუხში აერთიანებს

უსაფრთხოება

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

• DuckDuckGo: ავტორიზაციის მონაცემები არ სჭირდება.
• Brave Search: brave_api_key კონფიგურაციის ფაილში ინახება. გამოიყენეთ PRX-ის დაშიფრული საიდუმლოებების საცავი მის დასაცავად.

დომენის შეზღუდვები web_fetch-ისთვის

web_fetch ინსტრუმენტი browser.allowed_domains სიას იცავს. ეს აგენტს ნებისმიერი URL-დან კონტენტის ამოღებას უშლის.

პოლიტიკის ძრავი

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

[security.tool_policy.tools]
web_search_tool = "allow"
web_fetch = "supervised"     # ამოღებამდე თანხმობის მოთხოვნა

დაკავშირებული გვერდები

• HTTP Request -- API-ებზე პროგრამული HTTP მოთხოვნები
• ბრაუზერის ინსტრუმენტი -- სრული ბრაუზერის ავტომატიზაცია JavaScript-ით მძიმე საიტებისთვის
• კონფიგურაციის მითითება -- [web_search] და [browser] ველები
• საიდუმლოებების მართვა -- API გასაღებების დაშიფრული შენახვა
• ინსტრუმენტების მიმოხილვა -- ყველა ინსტრუმენტი და რეესტრის სისტემა