openai--openai-agents-python/docs/ko/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] - 기본 세션 프로토콜