Как настроить SQLAlchemySession OpenAI Agents SDK с PostgreSQL

• SQLAlchemySession работает с базами, поддерживаемыми SQLAlchemy.
• Можно использовать from_url либо передать существующий async engine.
• create_tables=True разрешает создание необходимых таблиц.
• При engine, созданном приложением или from_url, приложение отвечает за dispose после использования.
• Строку подключения нельзя хранить в статье, prompt или открытом логе.

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

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

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

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

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

1. Передайте DATABASE_URL через секрет окружения.
2. Создайте async engine и SQLAlchemySession с уникальным session_id.
3. После первого run вызовите get_items и проверьте непустую историю.
4. В finally вызовите await engine.dispose даже при ошибке Runner.

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

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

import asyncio, os
from sqlalchemy.ext.asyncio import create_async_engine
from agents import Agent, Runner
from agents.extensions.memory import SQLAlchemySession

async def main():
    engine=create_async_engine(os.environ["DATABASE_URL"])
    session=SQLAlchemySession("ticket-781",engine=engine,create_tables=True)
    try:
        agent=Agent(name="support",instructions="Помни историю обращения.")
        await Runner.run(agent,"Тикет T-781",session=session)
        items=await session.get_items()
        assert items
    finally:
        await engine.dispose()

asyncio.run(main())

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

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

Тестовая база и сессия ticket-781 получают один обезличенный turn.

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

get_items возвращает записанные элементы; engine dispose выполняется при успехе и при исключении.

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

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

Смоделируйте исключение внутри Runner и счётчиком проверьте, что finally всё равно вызвал dispose.

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

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

Проверь конфигурацию сценария «Как настроить SQLAlchemySession OpenAI Agents SDK с PostgreSQL». Для каждого факта найди исполняемое доказательство. Проверь 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, который проверяет закрытие даже после исключения.