Как ограничить историю через SessionSettings в OpenAI Agents SDK

• SessionSettings(limit=None) по умолчанию получает всю доступную историю.
• SessionSettings(limit=N) получает последние N items.
• Per-run настройка передаётся через RunConfig.session_settings.
• Непустые значения per-run переопределяют default session settings.
• Limit влияет на retrieval, а не физически удаляет старые items.

Каждый пункт проверяется отдельно. Не объединяйте доступность backend, корректность истории и качество ответа в один флаг success: это независимые слои.

Что подготовить

• отдельную тестовую базу, Redis database или временный файл;
• уникальный session_id, не совпадающий с ID реального пользователя;
• fake tool и provider stub для контроля вызовов;
• переменные окружения для ключей и строк подключения;
• журнал безопасных агрегатов и версий без содержимого переписки.

Прежде чем запускать код, определите владельца соединения и cleanup. Для hosted storage проверьте, где фактически лежат данные. Для durable state считайте payload чувствительным: он включает app context и runtime metadata.

Пошаговая настройка

1. Наполните тестовую session нумерованными items.
2. Задайте небольшой limit через RunConfig только для одного run.
3. Перехватите model input и проверьте, что пришёл хвост истории.
4. После run вызовите get_items без limit и подтвердите сохранность старых записей.

После каждого шага записывайте наблюдаемый признак: число items, конкретный exception, наличие interruption, счётчик tool или факт завершения async iterator. Комментарий в коде не является проверкой.

Копируемый пример

import asyncio
from agents import Agent, RunConfig, Runner, SessionSettings, SQLiteSession

async def main():
    session=SQLiteSession("ticket-781","history.db")
    await session.add_items([{"role":"user","content":f"item-{i}"} for i in range(60)])
    agent=Agent(name="assistant",instructions="Используй только доступную историю.")
    await Runner.run(agent,"Перечисли последние элементы",session=session,run_config=RunConfig(session_settings=SessionSettings(limit=50)))
    all_items=await session.get_items()
    assert len(all_items)>=60

asyncio.run(main())

Запускайте пример в отдельном virtualenv. Все ключи и URL берите из окружения; тестовые localhost-адреса не превращайте в production-конфигурацию автоматически. Заполнители paused, original_agent и fake counters должны быть определены вашим воспроизводимым fixture.

Реалистичный вход

В session 60 нумерованных items, для run задан limit=50.

Ожидаемый результат

Model input содержит последние 50 старых items плюс новый ввод по правилам объединения; хранилище по-прежнему содержит исходные записи.

Перенесите ожидание в assert. Для недетерминированного текста проверяйте сохранённый факт через model stub либо напрямую session items. Для approval проверяйте и interruptions, и execution counter.

Негативный тест

Проверьте, что item-0 не попал в model input, но остался в session storage.

Негативная проверка меняет одно условие. Ошибка подключения не равна пустой истории, новый run не равен resume, другой session_id не является потерей данных, а отсутствие второй паузы допустимо только при подтверждённом sticky decision.

Готовый prompt для ревью

Проверь конфигурацию сценария «Как ограничить историю через SessionSettings в OpenAI Agents SDK». Для каждого факта найди исполняемое доказательство. Проверь ownership соединений, cleanup, секреты, session_id, число model/tool вызовов и негативный тест. Верни таблицу PASS/FAIL; если доказательства нет, ставь FAIL.

Prompt используйте после приложения кода и очищенного лога. Он не заменяет исполнение: языковая модель может назвать комментарий гарантией или пропустить неверный cleanup.

Независимая проверка

Составьте три сценария: штатный, ошибочный и пограничный. Для каждого укажите исходное состояние, действие, ожидаемый side effect и последующее чтение. Повторите тест из второго процесса, если backend заявлен как shared.

Считайте отдельно model calls, tool executions, session writes и approval interruptions. Один счётчик не описывает весь run. Для async cleanup добавьте fixture, который проверяет закрытие даже после исключения.