openai--openai-agents-python/docs/ja/sessions/sqlalchemy_session.md

search

search
exclude true

SQLAlchemy セッション

SQLAlchemySession は SQLAlchemy を使用して、本番環境に対応したセッション実装を提供します。これにより、セッションストレージとして SQLAlchemy がサポートする任意のデータベース (PostgreSQL、MySQL、SQLite など) を使用できます。

インストール

SQLAlchemy セッションには sqlalchemy extra が必要です:

pip install openai-agents[sqlalchemy]

クイックスタート

データベース URL の使用

始めるための最も簡単な方法です:

import asyncio
from agents import Agent, Runner
from agents.extensions.memory import SQLAlchemySession

async def main():
    agent = Agent("Assistant")
    
    # Create session using database URL
    session = SQLAlchemySession.from_url(
        "user-123",
        url="sqlite+aiosqlite:///:memory:",
        create_tables=True
    )
    
    result = await Runner.run(agent, "Hello", session=session)
    print(result.final_output)

if __name__ == "__main__":
    asyncio.run(main())

既存エンジンの使用

既存の SQLAlchemy エンジンを持つアプリケーション向けです:

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

async def main():
    # Create your database engine
    engine = create_async_engine("postgresql+asyncpg://user:pass@localhost/db")
    
    agent = Agent("Assistant")
    session = SQLAlchemySession(
        "user-456",
        engine=engine,
        create_tables=True
    )
    
    result = await Runner.run(agent, "Hello", session=session)
    print(result.final_output)
    
    # Clean up
    await engine.dispose()

if __name__ == "__main__":
    asyncio.run(main())

API リファレンス

• [SQLAlchemySession][agents.extensions.memory.sqlalchemy_session.SQLAlchemySession] - メインクラス
• [Session][agents.memory.session.Session] - 基本セッションプロトコル