Как закрепить effort в Perplexity Agent API для повторных оценок

Этот порядок предназначен для разработчика или исследователя, который готовит повторные оценки Agent API. До запуска нужны точный набор запросов, выбранный уровень effort и решение о допустимости автоматических обновлений. Результатом подготовки должна стать сохранённая запись конфигурации, по которой можно проверить условия следующего запуска.

Документация перечисляет fast, low, medium, high и xhigh. Это наборы настроек, объединяющие модель, поиск, шаги рассуждения, системную инструкцию и доступные инструменты. Параметр reasoning.effort относится отдельно к рассуждению выбранной модели. Поэтому запись только reasoning.effort не описывает всю конфигурацию агента. Основание: [Perplexity — Effort](https://docs.perplexity.ai/docs/agent-api/effort).

Источники раздела:[1] Perplexity

При динамическом вызове, например effort="low", приложение следует за активной конфигурацией уровня. Perplexity описывает обновления как направленные на повышение качества с сохранением близких диапазонов стоимости и задержки. Это заявленная цель обновлений, а не подтверждённый здесь результат или гарантия одинаковой стоимости каждого запроса.

Закреплённая версия сохраняет выбранную выпущенную конфигурацию после смены активной версии. Явная замороженная конфигурация переносит опубликованные настройки в сам запрос. Наш редакционный критерий выбора: используйте динамический вариант для оценки текущего предложения сервиса, версию — для закреплённой базовой серии, явные поля — для проверки и изменения конкретных настроек.

• Динамический effort: обновления принимаются автоматически.
• Версия effort: переход к другой выпущенной конфигурации становится явным решением.
• Явная конфигурация: модель, инструменты, инструкции и параметры сохраняются в запросе.

Источники раздела:[1] Perplexity

Выполните исходный запрос с выбранным effort и сохраните поле effort ответа. Затем передавайте это значение в следующих запросах серии. В документации fast@2026-10-16.0 служит примером формата, а не доказательством того, что именно эта версия активна на дату вашей проверки.

Формы fast и fast@latest обозначают активную версию. Добавление @latest не закрепляет конфигурацию. Проверка перехода состоит в сопоставлении отправленного значения с версией, указанной в ответе; рядом нужно сохранить все явные переопределения.

Документация предупреждает, что потоки, возобновлённые через starting_after, не включают поле effort. Поэтому сохраняйте сведения о версии из исходного ответа. Не восстанавливайте отсутствующее значение по имени модели или стилю текста.

Источники раздела:[1] Perplexity

Для замороженного варианта откройте раздел Current effort level values и возьмите полный блок выбранного уровня. Перенесите модель, инструменты, системные инструкции и параметры; удалите effort. Сверьте вкладки: источник прямо предупреждает, что cURL может показывать параметры, ещё не представленные в SDK. Одного скопированного имени модели недостаточно.

Есть важная граница полноты. Для medium и high источник описывает отключённый grep и извлечение содержимого fetch_url с medium effort как настройки уровня, недоступные через поля запроса. Не придумывайте для них параметры. Если оценке нужна именно выпущенная конфигурация уровня, закреплённая версия — более прямой выбор; эквивалентность явного запроса по этим настройкам остаётся непроверенной.

Отдельно подготовьте инструкции с датой. Шаблон {{current_date}} подставляется только в стандартных инструкциях effort. В переданных пользователем instructions он останется буквальным текстом. Примеры замороженной конфигурации вычисляют дату UTC перед отправкой; в записи оценки сохраняйте фактически отправленную строку.

Источники раздела:[1] Perplexity

Неизвестное имя уровня, неизвестная версия и некорректная форма значения приводят к HTTP 400. Сначала проверьте сохранённое значение и формат запроса. Для закреплённой серии не заменяйте ошибочную версию на latest без отдельной записи: это изменит выбранную политику обновления.

Переопределение tools требует другой проверки. В сочетании с effort инструменты объединяются по отдельным инструментам, а не заменяют весь набор. Настройка одного web_search оставляет остальные инструменты уровня включёнными. Поэтому наличие короткого массива tools само по себе не доказывает, что агенту доступен только этот инструмент.

Если ожидалась полностью явная конфигурация, проверьте отсутствие effort и полноту переданных полей. Если сохраняется effort, называйте запрос конфигурацией уровня с переопределениями и перечисляйте их. Это позволяет обнаружить ошибку постановки теста до интерпретации ответа.

Источники раздела:[1] Perplexity

Следующий чек-лист — редакционный рабочий артефакт, выведенный из документированных различий. Он проверяет полноту записи условий; его эффективность не измерялась в эксперименте. Применяйте его перед началом серии и при намеренном переходе к другой конфигурации.

• Запишите цель: следовать текущему сервису или сравнивать закреплённую конфигурацию.
• Сохраните способ вызова: динамическое имя, возвращённая версия либо полный набор явных полей.
• Для effort сохраните отправленное значение, версию из исходного ответа и все переопределения.
• Для явного запроса проверьте модель, инструменты, instructions, параметры и отсутствие effort; отметьте недоступные настройки.
• Сохраните точные запросы, отправленные инструкции с датой, время запуска, полные ответы и ошибки.
• Заранее определите правило сравнения ответов; любое изменение конфигурации оформляйте отдельным условием.

Источники раздела:[1] Perplexity

GeoAeoAle Editorial проверила совпадение SHA-256 предоставленного публичного снимка и разобрала определения, синтаксис версий, правила переопределения и ограничения явных конфигураций. Дата проверки источника — 2026-10-27. Сопоставление способов вызова основано на одном документе; API-запросы и сравнение исторических снимков не выполнялись.

Полные тексты потенциально пересекающихся опубликованных материалов использованы только для проверки дублирования и выбора связанных страниц. Существующий аудит Fast Search посвящён возвращённым страницам и использованию фактов, а руководства по измерениям — условиям и исходам проверок. Задача этой страницы уже: выбрать и проверить способ закрепления конфигурации Agent API. Другие предложения пакета решают иные задачи; подготовленных текстов соседних кандидатов не было.

Наш ограниченный вывод: закрепление помогает контролировать конфигурационную составляющую оценки. Оно не сохраняет снимок веба и не устанавливает тождественность ответов. Следующий шаг — заполнить чек-лист и проверить собственный запуск. Оригинальный текст и чек-лист распространяются по CC BY 4.0; на источник распространяются его условия использования.

Источники раздела:[1] Perplexity