{ "@context": "https://schema.org", "@type": "Article", "schema_version": "1.1", "content_item_id": "perplexity-agent-effort-pinning.ru", "translation_group_id": "perplexity-agent-effort-pinning", "locale": "ru", "type": "guide", "section": "knowledge", "slug": "perplexity-agent-effort-pinning", "title": "Как закрепить effort в Perplexity Agent API для повторных оценок", "description": "Выбор между автоматическими обновлениями, версией effort и явной конфигурацией: порядок проверки, чек-лист и границы воспроизводимости.", "direct_answer": "Выбирайте динамический effort, если хотите автоматически получать обновления конфигурации Perplexity Agent API. Для серии оценок с закреплённой конфигурацией передавайте версию из поля effort полученного ответа. Если нужны явные настройки, скопируйте модель, инструменты, инструкции и параметры и уберите effort. Такое закрепление ограничивает изменение конфигурации, но не замораживает веб-источники и не гарантирует одинаковые ответы.", "sections": [ { "heading": "Сначала определите, что должно оставаться постоянным", "paragraphs": [ "Этот порядок предназначен для разработчика или исследователя, который готовит повторные оценки Agent API. До запуска нужны точный набор запросов, выбранный уровень effort и решение о допустимости автоматических обновлений. Результатом подготовки должна стать сохранённая запись конфигурации, по которой можно проверить условия следующего запуска.", "Документация перечисляет fast, low, medium, high и xhigh. Это наборы настроек, объединяющие модель, поиск, шаги рассуждения, системную инструкцию и доступные инструменты. Параметр reasoning.effort относится отдельно к рассуждению выбранной модели. Поэтому запись только reasoning.effort не описывает всю конфигурацию агента. Основание: [Perplexity — Effort](https://docs.perplexity.ai/docs/agent-api/effort)." ], "source_ids": [ "public-80630b7b677edc1c" ] }, { "heading": "Выберите способ обновления конфигурации", "paragraphs": [ "При динамическом вызове, например effort=\"low\", приложение следует за активной конфигурацией уровня. Perplexity описывает обновления как направленные на повышение качества с сохранением близких диапазонов стоимости и задержки. Это заявленная цель обновлений, а не подтверждённый здесь результат или гарантия одинаковой стоимости каждого запроса.", "Закреплённая версия сохраняет выбранную выпущенную конфигурацию после смены активной версии. Явная замороженная конфигурация переносит опубликованные настройки в сам запрос. Наш редакционный критерий выбора: используйте динамический вариант для оценки текущего предложения сервиса, версию — для закреплённой базовой серии, явные поля — для проверки и изменения конкретных настроек." ], "bullets": [ "Динамический effort: обновления принимаются автоматически.", "Версия effort: переход к другой выпущенной конфигурации становится явным решением.", "Явная конфигурация: модель, инструменты, инструкции и параметры сохраняются в запросе." ], "source_ids": [ "public-80630b7b677edc1c" ] }, { "heading": "Закрепляйте возвращённую версию, а не слово latest", "paragraphs": [ "Выполните исходный запрос с выбранным effort и сохраните поле effort ответа. Затем передавайте это значение в следующих запросах серии. В документации fast@2026-10-16.0 служит примером формата, а не доказательством того, что именно эта версия активна на дату вашей проверки.", "Формы fast и fast@latest обозначают активную версию. Добавление @latest не закрепляет конфигурацию. Проверка перехода состоит в сопоставлении отправленного значения с версией, указанной в ответе; рядом нужно сохранить все явные переопределения.", "Документация предупреждает, что потоки, возобновлённые через starting_after, не включают поле effort. Поэтому сохраняйте сведения о версии из исходного ответа. Не восстанавливайте отсутствующее значение по имени модели или стилю текста." ], "source_ids": [ "public-80630b7b677edc1c" ] }, { "heading": "Соберите явную конфигурацию и отметьте непереносимые настройки", "paragraphs": [ "Для замороженного варианта откройте раздел Current effort level values и возьмите полный блок выбранного уровня. Перенесите модель, инструменты, системные инструкции и параметры; удалите effort. Сверьте вкладки: источник прямо предупреждает, что cURL может показывать параметры, ещё не представленные в SDK. Одного скопированного имени модели недостаточно.", "Есть важная граница полноты. Для medium и high источник описывает отключённый grep и извлечение содержимого fetch_url с medium effort как настройки уровня, недоступные через поля запроса. Не придумывайте для них параметры. Если оценке нужна именно выпущенная конфигурация уровня, закреплённая версия — более прямой выбор; эквивалентность явного запроса по этим настройкам остаётся непроверенной.", "Отдельно подготовьте инструкции с датой. Шаблон {{current_date}} подставляется только в стандартных инструкциях effort. В переданных пользователем instructions он останется буквальным текстом. Примеры замороженной конфигурации вычисляют дату UTC перед отправкой; в записи оценки сохраняйте фактически отправленную строку." ], "source_ids": [ "public-80630b7b677edc1c" ] }, { "heading": "Диагностируйте ошибки закрепления", "paragraphs": [ "Неизвестное имя уровня, неизвестная версия и некорректная форма значения приводят к HTTP 400. Сначала проверьте сохранённое значение и формат запроса. Для закреплённой серии не заменяйте ошибочную версию на latest без отдельной записи: это изменит выбранную политику обновления.", "Переопределение tools требует другой проверки. В сочетании с effort инструменты объединяются по отдельным инструментам, а не заменяют весь набор. Настройка одного web_search оставляет остальные инструменты уровня включёнными. Поэтому наличие короткого массива tools само по себе не доказывает, что агенту доступен только этот инструмент.", "Если ожидалась полностью явная конфигурация, проверьте отсутствие effort и полноту переданных полей. Если сохраняется effort, называйте запрос конфигурацией уровня с переопределениями и перечисляйте их. Это позволяет обнаружить ошибку постановки теста до интерпретации ответа." ], "source_ids": [ "public-80630b7b677edc1c" ] }, { "heading": "Чек-лист готовности серии оценок", "paragraphs": [ "Следующий чек-лист — редакционный рабочий артефакт, выведенный из документированных различий. Он проверяет полноту записи условий; его эффективность не измерялась в эксперименте. Применяйте его перед началом серии и при намеренном переходе к другой конфигурации." ], "bullets": [ "Запишите цель: следовать текущему сервису или сравнивать закреплённую конфигурацию.", "Сохраните способ вызова: динамическое имя, возвращённая версия либо полный набор явных полей.", "Для effort сохраните отправленное значение, версию из исходного ответа и все переопределения.", "Для явного запроса проверьте модель, инструменты, instructions, параметры и отсутствие effort; отметьте недоступные настройки.", "Сохраните точные запросы, отправленные инструкции с датой, время запуска, полные ответы и ошибки.", "Заранее определите правило сравнения ответов; любое изменение конфигурации оформляйте отдельным условием." ], "source_ids": [ "public-80630b7b677edc1c" ] }, { "heading": "Метод проверки и границы результата", "paragraphs": [ "GeoAeoAle Editorial проверила совпадение SHA-256 предоставленного публичного снимка и разобрала определения, синтаксис версий, правила переопределения и ограничения явных конфигураций. Дата проверки источника — 2026-10-27. Сопоставление способов вызова основано на одном документе; API-запросы и сравнение исторических снимков не выполнялись.", "Полные тексты потенциально пересекающихся опубликованных материалов использованы только для проверки дублирования и выбора связанных страниц. Существующий аудит Fast Search посвящён возвращённым страницам и использованию фактов, а руководства по измерениям — условиям и исходам проверок. Задача этой страницы уже: выбрать и проверить способ закрепления конфигурации Agent API. Другие предложения пакета решают иные задачи; подготовленных текстов соседних кандидатов не было.", "Наш ограниченный вывод: закрепление помогает контролировать конфигурационную составляющую оценки. Оно не сохраняет снимок веба и не устанавливает тождественность ответов. Следующий шаг — заполнить чек-лист и проверить собственный запуск. Оригинальный текст и чек-лист распространяются по CC BY 4.0; на источник распространяются его условия использования." ], "source_ids": [ "public-80630b7b677edc1c" ] } ], "published_at": "2026-10-27", "modified_at": "2026-10-27", "data_through": "2026-10-27", "next_review_at": "2026-11-27", "author": "GeoAeoAle Editorial", "origin": "editorial", "topics": [ "Perplexity Agent API", "effort", "evaluation reproducibility" ], "publisher": "GeoAeoAle Editorial", "license": "https://creativecommons.org/licenses/by/4.0/", "canonical_url": "https://geoaeoale.com/ru/knowledge/perplexity-agent-effort-pinning/", "claims": [ { "claim_id": "C01", "text": "В Agent API параметр effort выбирает набор настроек модели, поиска, шагов рассуждения, системной инструкции и инструментов; reasoning.effort управляет рассуждением выбранной модели отдельно.", "status": "observed", "confidence": "high", "source_ids": [ "public-80630b7b677edc1c" ], "publication_status": "public", "confidentiality": "public" }, { "claim_id": "C02", "text": "Имя effort без версии и форма @latest используют активную версию; динамические уровни автоматически получают обновления конфигурации.", "status": "observed", "confidence": "high", "source_ids": [ "public-80630b7b677edc1c" ], "publication_status": "public", "confidentiality": "public" }, { "claim_id": "C03", "text": "Поле effort ответа содержит уровень и выполненную версию; документация приводит fast@2026-10-16.0 как пример. Это значение можно передать обратно для закрепления версии. Возобновлённые с starting_after потоки не содержат это поле.", "status": "observed", "confidence": "high", "source_ids": [ "public-80630b7b677edc1c" ], "publication_status": "public", "confidentiality": "public" }, { "claim_id": "C04", "text": "Документация предлагает замороженную конфигурацию через явное копирование модели, инструментов, системной инструкции и параметров с исключением effort; вкладка cURL может содержать больше параметров, чем примеры SDK.", "status": "observed", "confidence": "high", "source_ids": [ "public-80630b7b677edc1c" ], "publication_status": "public", "confidentiality": "public" }, { "claim_id": "C05", "text": "Неизвестное имя effort, неизвестная версия или некорректное значение возвращают HTTP 400.", "status": "observed", "confidence": "high", "source_ids": [ "public-80630b7b677edc1c" ], "publication_status": "public", "confidentiality": "public" }, { "claim_id": "C06", "text": "Поля запроса переопределяют значения effort, но tools объединяются по инструментам. Подстановка {{current_date}} работает в стандартных инструкциях effort; в инструкциях запроса этот шаблон передаётся буквально.", "status": "observed", "confidence": "high", "source_ids": [ "public-80630b7b677edc1c" ], "publication_status": "public", "confidentiality": "public" }, { "claim_id": "C07", "text": "Для medium и high документация указывает настройки обработки fetch_url, которые нельзя задать полями запроса: отключённый grep и извлечение содержимого с medium effort.", "status": "observed", "confidence": "high", "source_ids": [ "public-80630b7b677edc1c" ], "publication_status": "public", "confidentiality": "public" }, { "claim_id": "C08", "text": "Для оценки полезно хранить выбранный способ закрепления, фактическую версию и явные переопределения отдельно от ответов. Закрепление конфигурации не доказывает неизменность веб-источников или идентичность результатов.", "status": "inference", "confidence": "medium", "source_ids": [ "public-80630b7b677edc1c" ], "publication_status": "public", "confidentiality": "public" } ], "sources": [ { "source_id": "public-80630b7b677edc1c", "canonical_url": "https://docs.perplexity.ai/docs/agent-api/effort", "title": "Effort", "publisher": "Perplexity", "source_type": "official", "locale": "en", "published_at": null, "checked_at": "2026-10-27", "sha256": "a78652dcc2865e2dae0db20a3a75114842b92e531cfdcc8148f67194eb094fc8", "license": "Source terms apply", "visibility": "public" } ], "related_slugs": [ "perplexity-fast-search-retrieval-audit", "interface-api-product-recommendation-audit", "measuring-ai-visibility" ], "limitations": [ "Это разбор документации, а не выполненный тест API: качество, стоимость, задержка и устойчивость ответов не измерялись.", "Проверен один публичный снимок; дата появления функций и изменения относительно предыдущей версии документации не устанавливались.", "Срок доступности закреплённых версий не установлен рассмотренным источником.", "Для medium и high часть настроек fetch_url недоступна через поля запроса; полная эквивалентность явной конфигурации не доказана." ], "corrections": [] }