HTTP მოთხოვნა

http_request ინსტრუმენტი PRX აგენტებს გარე API-ებზე პირდაპირი HTTP მოთხოვნების გაგზავნის საშუალებას აძლევს. იგი სტრუქტურირებული API ინტერაქციებისთვისაა შექმნილი -- JSON მონაცემების მიღება, REST ენდფოინთების გამოძახება, ვებჰუკების გაგზავნა. ინსტრუმენტი ნაგულისხმევად-უარყოფის დომენის პოლიტიკას აღასრულებს: მხოლოდ allowed_domains-ში ექსპლიციტურად ჩამოთვლილი დომენები მისაწვდომია.

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

[http_request]
enabled = true
allowed_domains = [
  "api.github.com",
  "api.openai.com",
  "api.anthropic.com",
  "httpbin.org"
]
max_response_size = 1000000   # პასუხის ტანის მაქსიმალური ზომა ბაიტებში (1 MB)
timeout_secs = 30             # მოთხოვნის დროის ამოწურვა წამებში

გამოყენება

ინსტრუმენტი ყველა სტანდარტულ HTTP მეთოდს უჭერს მხარს (GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS), მორგებული ჰედერებით, მოთხოვნის ტანითა და კონფიგურირებადი დროის ამოწურვით.

{
  "name": "http_request",
  "arguments": {
    "method": "GET",
    "url": "https://api.github.com/repos/openprx/prx/releases/latest",
    "headers": {
      "Accept": "application/vnd.github+json"
    }
  }
}

პარამეტრები

პარამეტრი	ტიპი	სავალდებულო	ნაგულისხმევი	აღწერა
method	string	არა	"GET"	HTTP მეთოდი
url	string	დიახ	--	მოსათხოვნი სრული URL. დომენი allowed_domains-ში უნდა იყოს.
headers	object	არა	{}	HTTP ჰედერების გასაღები-მნიშვნელობის რუკა
body	string	არა	--	მოთხოვნის ტანი (POST, PUT, PATCH მეთოდებისთვის)
timeout_secs	integer	არა	კონფიგურაციის მნიშვნელობა (30)	დროის ამოწურვა წამებში

უსაფრთხოება

ნაგულისხმევად-უარყოფა

HTTP მოთხოვნის ინსტრუმენტი ნაგულისხმევად-უარყოფის უსაფრთხოების მოდელს იყენებს. თუ დომენი allowed_domains-ში ექსპლიციტურად არ არის, მოთხოვნა ბლოკდება. ეს SSRF-ს, მონაცემთა ექსფილტრაციასა და DNS-ის ხელახალ ბაინდინგს თავიდან იცილებს.

პასუხის ზომის ლიმიტები

max_response_size პარამეტრი (ნაგულისხმევი: 1 MB) მეხსიერების ამოწურვას მოულოდნელად დიდი პასუხებისგან თავიდან იცილებს.

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

• ვებ ძიება -- ვებში ძიება და გვერდის კონტენტის ამოღება
• ბრაუზერის ინსტრუმენტი -- სრული ბრაუზერის ავტომატიზაცია
• MCP ინტეგრაცია -- გარე ინსტრუმენტებთან დაკავშირება MCP პროტოკოლით
• ინსტრუმენტების მიმოხილვა -- ყველა ინსტრუმენტი და რეესტრის სისტემა