srezai.ru

srezai.ru — веб-доступ для агентов: поиск, чтение страниц, скриншоты, извлечение данных по схеме. / srezai.ru — web access for agents: search, page reading, screenshots, schema-based extraction. Как выбрать инструмент / choosing a tool: - Нужны ссылки и факты по теме → web_search. Нужны картинки → image_search. / Links and facts on a topic → web_search. Images → image_search. - Нужен текст известной страницы → read_url (1 кредит), несколько страниц сразу → read_urls. / The text of a known page → read_url (1 credit), several pages at once → read_urls. - Нужны 2–5 конкретных значений со страницы → extract (4 кредита): в контекст придут только они, а не вся страница. / A handful of specific values from a page → extract (4 credits): only those values reach your context, not the whole page. - Нужно УВИДЕТЬ вёрстку и дизайн → fetch_page (3 кредита). Для текста он избыточен. / You need to SEE the layout and design → fetch_page (3 credits). It is overkill for text. - Нужно проверить конкретный факт → verify_claim (8 кредитов): сам найдёт источники, прочитает их и вернёт вердикт с цитатами. / You need to check a specific fact → verify_claim (8 credits): it finds the sources, reads them and returns a verdict with quotes. - Нужен разбор темы по многим источникам с готовым ответом → deep_research (20 кредитов + 3 за 1000 output-токенов, 10 с – 2 мин). / A researched answer across many sources → deep_research (20 credits + 3 per 1000 output tokens, 10 s – 2 min). - Баланс, квота и цены → get_usage (бесплатно, лимит не расходует). / Balance, quota and prices → get_usage (free, does not consume the limit). Длинные страницы / long pages: read_url отдаёт страницу окнами по maxChars. Не влезло — в конце ответа указан offset, с которым надо вызвать read_url повторно; берите это число как есть, не считайте сами. Так статья или документация любого объёма читается по частям под ваш контекст, и уже прочитанное второй раз не приходит. / read_url returns a page in windows of maxChars. If it did not fit, the end of the response states the offset to call read_url with again; use that number as given, do not compute it yourself. This way an article or documentation of any size is read in parts sized to your context, and you never receive the same text twice. Небольшой контекст / small context: если ваше окно 32–64k, не набивайте его сырыми страницами. read_url с offset даёт страницу порциями под ваш размер; extract возвращает только нужные поля вместо всего текста; verify_claim переваривает 4–5 источников на нашей стороне и отдаёт вердикт с цитатами. Во всех трёх случаях черновая работа идёт вне вашего контекста. / If your window is 32–64k, do not stuff it with raw pages. read_url with offset serves a page in portions sized to you; extract returns only the fields you asked for instead of the whole text; verify_claim digests 4–5 sources on our side and returns a verdict with quotes. In all three cases the legwork happens outside your context. Ошибка в цитате дороже её отсутствия / a wrong quote costs more than a missing one: verify_claim сверяет каждую цитату с текстом страницы и отбрасывает не найденную. Вердикты unverified и mixed — честный результат, а не сбой: значит, источники утверждение не подтверждают. / verify_claim checks every quote against the page text and drops the ones it cannot find. The unverified and mixed verdicts are honest results, not failures: they mean the sources do not confirm the claim. Лимиты / limits: до 10 запросов за 10 с и 200 запросов в сутки на ключ; батчи read_urls и extract — до 5 ссылок за вызов, каждая ссылка тарифицируется отдельно. / Up to 10 requests per 10 s and 200 requests per day per key; read_urls and extract batches take up to 5 links per call, each link billed separately. Ошибки приходят текстом с кодом в квадратных скобках: [rate_limited], [read_failed] и т. д. Повторять имеет смысл на [rate_limited] (через указанное число секунд), [upstream_timeout], [search_unavailable] и [service_unavailable] — это временные сбои, а не отсутствие информации. На [bad_request], [schema_invalid], [ssrf_blocked] и [unauthorized] нужно исправить запрос: повтор тем же вызовом ничего не изменит. / Errors arrive as text with a code in square brackets: [rate_limited], [read_failed] and so on. Retrying makes sense for [rate_limited] (after the stated number of seconds), [upstream_timeout], [search_unavailable] and [service_unavailable] — those are temporary outages, not a lack of information. For [bad_request], [schema_invalid], [ssrf_blocked] and [unauthorized] fix the request instead: repeating the same call changes nothing.