세션

Agents SDK는 여러 에이전트 실행에 걸쳐 대화 기록을 자동으로 유지하는 내장 세션 메모리를 제공하므로, 턴 사이에 .to_input_list()를 수동으로 처리할 필요가 없습니다.

세션은 특정 세션의 대화 기록을 저장하여, 명시적으로 메모리를 직접 관리하지 않아도 에이전트가 컨텍스트를 유지할 수 있게 합니다. 이는 에이전트가 이전 상호작용을 기억해야 하는 채팅 애플리케이션이나 멀티턴 대화를 구축할 때 특히 유용합니다.

SDK가 클라이언트 측 메모리를 관리하도록 하려면 세션을 사용하세요. 동일한 실행에서 세션을 conversation_id, previous_response_id 또는 auto_previous_response_id와 함께 사용할 수 없습니다. OpenAI 서버에서 관리하는 대화 연속성을 사용하려면 세션을 추가로 적용하지 말고 이러한 메커니즘 중 하나를 선택하세요.

빠른 시작

from agents import Agent, Runner, SQLiteSession

# Create agent
agent = Agent(
    name="Assistant",
    instructions="Reply very concisely.",
)

# Create a session instance with a session ID
session = SQLiteSession("conversation_123")

# First turn
result = await Runner.run(
    agent,
    "What city is the Golden Gate Bridge in?",
    session=session
)
print(result.final_output)  # "San Francisco"

# Second turn - agent automatically remembers previous context
result = await Runner.run(
    agent,
    "What state is it in?",
    session=session
)
print(result.final_output)  # "California"

# Also works with synchronous runner
result = Runner.run_sync(
    agent,
    "What's the population?",
    session=session
)
print(result.final_output)  # "Approximately 39 million"

동일한 세션을 사용한 인터럽션된 실행 재개

승인을 위해 실행이 일시 중지되면 동일한 세션 인스턴스 또는 동일한 기반 스토리지를 가리키는 다른 세션 인스턴스로 재개하여, 재개된 턴이 저장된 동일한 대화 기록을 이어가도록 하세요.

result = await Runner.run(agent, "Delete temporary files that are no longer needed.", session=session)

if result.interruptions:
    state = result.to_state()
    for interruption in result.interruptions:
        state.approve(interruption)
    result = await Runner.run(agent, state, session=session)

핵심 세션 동작

세션 메모리가 활성화된 경우:

1. 각 실행 전: 러너가 세션의 대화 기록을 자동으로 가져와 입력 항목 앞에 추가합니다.
2. 각 실행 후: 실행 중 생성된 모든 새 항목(사용자 입력, 어시스턴트 응답, 도구 호출 등)이 세션에 자동으로 저장됩니다.
3. 컨텍스트 보존: 동일한 세션을 사용하는 이후의 각 실행에는 전체 대화 기록이 포함되므로 에이전트가 컨텍스트를 유지할 수 있습니다.

따라서 .to_input_list()를 수동으로 호출하고 실행 사이의 대화 상태를 관리할 필요가 없습니다.

기록과 새 입력의 병합 방식 제어

세션을 전달하면 일반적으로 러너는 다음 순서로 모델 입력을 준비합니다.

1. 세션 기록(session.get_items(...)에서 가져옴)
2. 새 턴 입력

모델 호출 전에 이 병합 단계를 맞춤 설정하려면 RunConfig.session_input_callback을 사용하세요. 콜백은 다음 두 목록을 받습니다.

• history: 가져온 세션 기록(이미 입력 항목 형식으로 정규화됨)
• new_input: 현재 턴의 새 입력 항목

모델로 전송할 최종 입력 항목 목록을 반환하세요.

콜백은 두 목록의 복사본을 받으므로 안전하게 변경할 수 있습니다. 반환된 목록은 해당 턴의 모델 입력을 제어하지만, SDK는 여전히 새 턴에 속하는 항목만 저장합니다. 따라서 이전 기록을 재정렬하거나 필터링해도 기존 세션 항목이 새로운 입력으로 다시 저장되지 않습니다.

from agents import Agent, RunConfig, Runner, SQLiteSession


def keep_recent_history(history, new_input):
    # Keep only the last 10 history items, then append the new turn.
    return history[-10:] + new_input


agent = Agent(name="Assistant")
session = SQLiteSession("conversation_123")

result = await Runner.run(
    agent,
    "Continue from the latest updates only.",
    session=session,
    run_config=RunConfig(session_input_callback=keep_recent_history),
)

세션의 항목 저장 방식을 변경하지 않으면서 기록을 맞춤형으로 정리하거나 재정렬하거나 선택적으로 포함해야 할 때 이 기능을 사용하세요. 모델 호출 직전에 최종 처리 단계가 더 필요하면 에이전트 실행 가이드의 call_model_input_filter를 사용하세요.

가져올 기록 제한

각 실행 전에 가져올 기록의 양을 제어하려면 SessionSettings를 사용하세요.

• SessionSettings(limit=None)(기본값): 사용 가능한 모든 세션 항목을 가져옵니다
• SessionSettings(limit=N): 가장 최근의 N개 항목만 가져옵니다

RunConfig.session_settings를 통해 실행별로 적용할 수 있습니다.

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

agent = Agent(name="Assistant")
session = SQLiteSession("conversation_123")

result = await Runner.run(
    agent,
    "Summarize our recent discussion.",
    session=session,
    run_config=RunConfig(session_settings=SessionSettings(limit=50)),
)

세션 구현에서 기본 세션 설정을 제공하는 경우, RunConfig.session_settings는 해당 실행에서 None이 아닌 값을 재정의합니다. 이는 세션의 기본 동작을 변경하지 않고 가져올 기록의 크기를 제한하려는 긴 대화에 유용합니다.

메모리 작업

기본 작업

세션은 대화 기록을 관리하기 위한 여러 작업을 지원합니다.

from agents import SQLiteSession

session = SQLiteSession("user_123", "conversations.db")

# Get all items in a session
items = await session.get_items()

# Add new items to a session
new_items = [
    {"role": "user", "content": "Hello"},
    {"role": "assistant", "content": "Hi there!"}
]
await session.add_items(new_items)

# Remove and return the most recent item
last_item = await session.pop_item()
print(last_item)  # {"role": "assistant", "content": "Hi there!"}

# Clear all items from a session
await session.clear_session()

수정을 위한 pop_item 사용

대화의 마지막 항목을 실행 취소하거나 수정하려는 경우 pop_item 메서드가 특히 유용합니다.

from agents import Agent, Runner, SQLiteSession

agent = Agent(name="Assistant")
session = SQLiteSession("correction_example")

# Initial conversation
result = await Runner.run(
    agent,
    "What's 2 + 2?",
    session=session
)
print(f"Agent: {result.final_output}")

# User wants to correct their question
assistant_item = await session.pop_item()  # Remove agent's response
user_item = await session.pop_item()  # Remove user's question

# Ask a corrected question
result = await Runner.run(
    agent,
    "What's 2 + 3?",
    session=session
)
print(f"Agent: {result.final_output}")

내장 세션 구현

SDK는 다양한 사용 사례를 위한 여러 세션 구현을 제공합니다.

내장 세션 구현 선택

아래의 상세한 예제를 읽기 전에 이 표를 참고하여 시작점을 선택하세요.

세션 유형	적합한 용도	참고
SQLiteSession	로컬 개발 및 간단한 앱	내장형 경량 구현, 파일 기반 또는 인메모리
AsyncSQLiteSession	aiosqlite를 사용하는 비동기 SQLite	비동기 드라이버를 지원하는 확장 백엔드
RedisSession	여러 워커/서비스 간 공유 메모리	지연 시간이 짧은 분산 배포에 적합
SQLAlchemySession	기존 데이터베이스를 사용하는 프로덕션 앱	SQLAlchemy가 지원하는 데이터베이스에서 작동
MongoDBSession	이미 MongoDB를 사용하거나 다중 프로세스 스토리지가 필요한 앱	비동기 pymongo 사용, 순서 보존을 위한 원자적 시퀀스 카운터
DaprSession	Dapr 사이드카를 사용하는 클라우드 네이티브 배포	여러 상태 스토어와 TTL 및 일관성 제어 지원
OpenAIConversationsSession	OpenAI에서 서버가 관리하는 스토리지	OpenAI Conversations API 기반 기록
OpenAIResponsesCompactionSession	자동 압축을 사용하는 긴 대화	다른 세션 백엔드를 감싸는 래퍼
AdvancedSQLiteSession	SQLite와 분기/분석 기능	더 많은 기능을 제공하며 전용 페이지 참고
EncryptedSession	다른 세션에 암호화와 TTL 추가	래퍼이므로 먼저 기반 백엔드 선택 필요

일부 구현에는 추가 세부 정보를 제공하는 전용 페이지가 있으며, 해당 하위 섹션에 링크되어 있습니다.

ChatKit용 Python 서버를 구현하는 경우 ChatKit의 스레드 및 항목 영속성에는 chatkit.store.Store 구현을 사용하세요. SQLAlchemySession과 같은 Agents SDK 세션은 SDK 측 대화 기록을 관리하지만 ChatKit 스토어를 그대로 대체할 수는 없습니다. ChatKit 데이터 스토어 구현에 관한 chatkit-python 가이드를 참고하세요.

OpenAI Conversations API 세션

OpenAIConversationsSession을 통해 OpenAI의 Conversations API를 사용하세요.

from agents import Agent, Runner, OpenAIConversationsSession

# Create agent
agent = Agent(
    name="Assistant",
    instructions="Reply very concisely.",
)

# Create a new conversation
session = OpenAIConversationsSession()

# Optionally resume a previous conversation by passing a conversation ID
# session = OpenAIConversationsSession(conversation_id="conv_123")

# Start conversation
result = await Runner.run(
    agent,
    "What city is the Golden Gate Bridge in?",
    session=session
)
print(result.final_output)  # "San Francisco"

# Continue the conversation
result = await Runner.run(
    agent,
    "What state is it in?",
    session=session
)
print(result.final_output)  # "California"

OpenAI Responses 압축 세션

Responses API(responses.compact)로 저장된 대화 기록을 압축하려면 OpenAIResponsesCompactionSession을 사용하세요. 이 구현은 기반 세션을 감싸며 should_trigger_compaction을 기준으로 각 턴 이후 자동으로 압축할 수 있습니다. OpenAIConversationsSession을 이 구현으로 감싸지 마세요. 두 기능은 서로 다른 방식으로 기록을 관리합니다.

일반적인 사용법(자동 압축)

from agents import Agent, Runner, SQLiteSession
from agents.memory import OpenAIResponsesCompactionSession

underlying = SQLiteSession("conversation_123")
session = OpenAIResponsesCompactionSession(
    session_id="conversation_123",
    underlying_session=underlying,
)

agent = Agent(name="Assistant")
result = await Runner.run(agent, "Hello", session=session)
print(result.final_output)

기본적으로 압축 후보 임계값에 도달하면 각 턴 이후 압축이 실행됩니다.

Responses API 응답 ID로 이미 턴을 연결하고 있다면 compaction_mode="previous_response_id"가 가장 적합합니다. 반면 compaction_mode="input"은 현재 세션 항목에서 압축 요청을 다시 구성하므로, 응답 체인을 사용할 수 없거나 세션 내용을 기준 데이터로 사용하려는 경우에 유용합니다. 기본값인 "auto"는 사용 가능한 옵션 중 가장 안전한 것을 선택합니다.

에이전트가 ModelSettings(store=False)로 실행되면 Responses API는 나중에 조회할 수 있도록 마지막 응답을 보관하지 않습니다. 이러한 무상태 구성에서는 기본 "auto" 모드가 previous_response_id에 의존하지 않고 입력 기반 압축으로 대체됩니다. 전체 예제는 examples/memory/compaction_session_stateless_example.py를 참고하세요.

자동 압축으로 인한 스트리밍 차단

압축은 세션 기록을 지우고 다시 작성하므로, SDK는 실행이 완료된 것으로 처리하기 전에 압축이 끝날 때까지 기다립니다. 스트리밍 모드에서는 압축 작업이 많은 경우 마지막 출력 토큰 이후에도 run.stream_events()가 몇 초 동안 열린 상태로 유지될 수 있습니다.

지연 시간이 짧은 스트리밍이나 빠른 턴 전환이 필요하면 자동 압축을 비활성화하고 턴 사이 또는 유휴 시간에 run_compaction()을 직접 호출하세요. 자체 기준에 따라 압축을 강제로 실행할 시점을 결정할 수 있습니다.

from agents import Agent, Runner, SQLiteSession
from agents.memory import OpenAIResponsesCompactionSession

underlying = SQLiteSession("conversation_123")
session = OpenAIResponsesCompactionSession(
    session_id="conversation_123",
    underlying_session=underlying,
    # Disable triggering the auto compaction
    should_trigger_compaction=lambda _: False,
)

agent = Agent(name="Assistant")
result = await Runner.run(agent, "Hello", session=session)

# Decide when to compact (e.g., on idle, every N turns, or size thresholds).
await session.run_compaction({"force": True})

SQLite 세션

SQLite를 사용하는 기본 경량 세션 구현입니다.

from agents import SQLiteSession

# In-memory database (lost when process ends)
session = SQLiteSession("user_123")

# Persistent file-based database
session = SQLiteSession("user_123", "conversations.db")

# Use the session
result = await Runner.run(
    agent,
    "Hello",
    session=session
)

비동기 SQLite 세션

aiosqlite 기반의 SQLite 영속성이 필요하면 AsyncSQLiteSession을 사용하세요.

pip install aiosqlite

from agents import Agent, Runner
from agents.extensions.memory import AsyncSQLiteSession

agent = Agent(name="Assistant")
session = AsyncSQLiteSession("user_123", db_path="conversations.db")
result = await Runner.run(agent, "Hello", session=session)

Redis 세션

여러 워커 또는 서비스에서 세션 메모리를 공유하려면 RedisSession을 사용하세요.

pip install openai-agents[redis]

from agents import Agent, Runner
from agents.extensions.memory import RedisSession

agent = Agent(name="Assistant")
session = RedisSession.from_url(
    "user_123",
    url="redis://localhost:6379/0",
)
result = await Runner.run(agent, "Hello", session=session)
await session.close()

from_url(...)은 Redis 클라이언트를 생성하고 소유합니다. close() 이후에는 세션이 종료 상태가 되며, 이후 세션 작업은 RuntimeError를 발생시킵니다. 반복적으로 또는 동시에 close()를 호출해도 안전합니다. 애플리케이션에서 이미 Redis 클라이언트를 관리하고 있다면 redis_client=...를 사용하여 RedisSession(...)을 직접 생성하세요. 이 경우 close()는 아무 작업도 하지 않으며 호출자가 클라이언트 소유권을 유지하고 세션도 계속 사용할 수 있습니다.

SQLAlchemy 세션

SQLAlchemy가 지원하는 모든 데이터베이스를 사용하는 프로덕션 수준의 Agents SDK 세션 영속성 구현입니다.

from agents.extensions.memory import SQLAlchemySession

# Using database URL
session = SQLAlchemySession.from_url(
    "user_123",
    url="postgresql+asyncpg://user:pass@localhost/db",
    create_tables=True
)

# Using existing engine
from sqlalchemy.ext.asyncio import create_async_engine
engine = create_async_engine("postgresql+asyncpg://user:pass@localhost/db")
session = SQLAlchemySession("user_123", engine=engine, create_tables=True)

자세한 문서는 SQLAlchemy 세션을 참고하세요.

Dapr 세션

이미 Dapr 사이드카를 실행 중이거나 에이전트 코드를 변경하지 않고 다양한 상태 스토어 백엔드 간에 이동할 수 있는 세션 스토리지가 필요하면 DaprSession을 사용하세요.

pip install openai-agents[dapr]

from agents import Agent, Runner
from agents.extensions.memory import DaprSession

agent = Agent(name="Assistant")

async with DaprSession.from_address(
    "user_123",
    state_store_name="statestore",
    dapr_address="localhost:50001",
) as session:
    result = await Runner.run(agent, "Hello", session=session)
    print(result.final_output)

참고:

• from_address(...)는 Dapr 클라이언트를 생성하고 소유합니다. 앱에서 이미 클라이언트를 관리하고 있다면 dapr_client=...를 사용하여 DaprSession(...)을 직접 생성하세요.
• 컨텍스트에서 나가거나 close()를 호출하면 클라이언트를 소유한 세션은 종료 상태가 됩니다. 이후 세션 작업은 RuntimeError를 발생시키지만, 반복적으로 또는 동시에 close()를 호출해도 안전합니다. 주입된 클라이언트를 사용하면 close()는 아무 작업도 하지 않으며 세션을 계속 사용할 수 있습니다.
• 상태 스토어에서 TTL을 지원하는 경우 오래된 세션 데이터가 자동으로 만료되도록 하려면 ttl=...을 전달하세요.
• 쓰기 직후 읽기에 대해 더 강한 보장이 필요하면 consistency=DAPR_CONSISTENCY_STRONG을 전달하세요.
• Dapr Python SDK는 HTTP 사이드카 엔드포인트도 확인합니다. 로컬 개발 환경에서는 dapr_address에 사용되는 gRPC 포트뿐만 아니라 --dapr-http-port 3500도 지정하여 Dapr를 시작하세요.
• 로컬 구성 요소와 문제 해결 방법을 포함한 전체 설정 과정은 examples/memory/dapr_session_example.py를 참고하세요.

MongoDB 세션

이미 MongoDB를 사용하거나 수평 확장이 가능한 다중 프로세스 세션 스토리지가 필요한 애플리케이션에는 MongoDBSession을 사용하세요.

pip install openai-agents[mongodb]

from agents import Agent, Runner
from agents.extensions.memory import MongoDBSession

agent = Agent(name="Assistant")

# Create from URI — owns the client and closes it when session.close() is called
session = MongoDBSession.from_uri(
    "user-123",
    uri="mongodb://localhost:27017",
    database="agents",
)
result = await Runner.run(agent, "Hello", session=session)
print(result.final_output)
await session.close()

참고:

• from_uri(...)는 AsyncMongoClient를 생성하고 소유하며 session.close() 호출 시 이를 닫습니다. 애플리케이션에서 이미 클라이언트를 관리하고 있다면 client=...를 사용하여 MongoDBSession(...)을 직접 생성하세요. 이 경우 session.close()는 아무 작업도 하지 않으며 수명 주기는 호출자가 관리합니다.
• 다른 변경 없이 mongodb+srv://user:password@cluster.example.mongodb.net URI를 from_uri(...)에 전달하여 MongoDB Atlas에 연결할 수 있습니다.
• 두 개의 컬렉션이 사용되며, 두 이름 모두 sessions_collection=(기본값 agent_sessions)과 messages_collection=(기본값 agent_messages)을 통해 설정할 수 있습니다. 인덱스는 처음 사용할 때 자동으로 생성됩니다. 각 메시지 문서에는 단조 증가하는 seq 카운터가 포함되어 동시 작성자와 여러 프로세스 간에도 순서를 보존합니다.
• 첫 실행 전에 연결을 확인하려면 await session.ping()을 사용하세요.

고급 SQLite 세션

대화 분기, 사용량 분석 및 구조화된 쿼리를 제공하는 향상된 SQLite 세션입니다.

from agents.extensions.memory import AdvancedSQLiteSession

# Create with advanced features
session = AdvancedSQLiteSession(
    session_id="user_123",
    db_path="conversations.db",
    create_tables=True
)

# Automatic usage tracking
result = await Runner.run(agent, "Hello", session=session)
await session.store_run_usage(result)  # Track token usage

# Conversation branching
await session.create_branch_from_turn(2)  # Branch from turn 2

자세한 문서는 고급 SQLite 세션을 참고하세요.

암호화된 세션

모든 세션 구현에 적용할 수 있는 투명한 암호화 래퍼입니다.

from agents.extensions.memory import EncryptedSession, SQLAlchemySession

# Create underlying session
underlying_session = SQLAlchemySession.from_url(
    "user_123",
    url="sqlite+aiosqlite:///conversations.db",
    create_tables=True
)

# Wrap with encryption and TTL
session = EncryptedSession(
    session_id="user_123",
    underlying_session=underlying_session,
    encryption_key="your-secret-key",
    ttl=600  # 10 minutes
)

result = await Runner.run(agent, "Hello", session=session)

자세한 문서는 암호화된 세션을 참고하세요.

기타 세션 유형

그 밖에도 몇 가지 내장 옵션이 있습니다. examples/memory/와 extensions/memory/의 소스 코드를 참고하세요.

운영 패턴

세션 ID 명명법

대화를 정리하는 데 도움이 되는 의미 있는 세션 ID를 사용하세요.

• 사용자 기반: "user_12345"
• 스레드 기반: "thread_abc123"
• 컨텍스트 기반: "support_ticket_456"

메모리 영속성

• 임시 대화에는 인메모리 SQLite(SQLiteSession("session_id"))를 사용합니다
• 영구 대화에는 파일 기반 SQLite(SQLiteSession("session_id", "path/to/db.sqlite"))를 사용합니다
• aiosqlite 기반 구현이 필요하면 비동기 SQLite(AsyncSQLiteSession("session_id", db_path="..."))를 사용합니다
• 공유되는 저지연 세션 메모리에는 Redis 기반 세션(RedisSession.from_url("session_id", url="redis://..."))을 사용합니다
• SQLAlchemy에서 지원하는 기존 데이터베이스가 있는 프로덕션 시스템에는 SQLAlchemy 기반 세션(SQLAlchemySession("session_id", engine=engine, create_tables=True))을 사용합니다
• 이미 MongoDB를 사용하거나 수평 확장이 가능한 다중 프로세스 세션 스토리지가 필요한 애플리케이션에는 MongoDB 세션(MongoDBSession.from_uri("session_id", uri="mongodb://localhost:27017"))을 사용합니다
• 내장된 텔레메트리, 트레이싱 및 데이터 격리 기능과 30개 이상의 데이터베이스 백엔드를 지원하는 프로덕션 클라우드 네이티브 배포에는 Dapr 상태 스토어 세션(DaprSession.from_address("session_id", state_store_name="statestore", dapr_address="localhost:50001"))을 사용합니다
• OpenAI Conversations API에 기록을 저장하려면 OpenAI 호스팅 스토리지(OpenAIConversationsSession())를 사용합니다
• 모든 세션에 투명한 암호화와 TTL 기반 만료를 적용하려면 암호화된 세션(EncryptedSession(session_id, underlying_session, encryption_key))을 사용합니다
• 더 고급 사용 사례에서는 다른 프로덕션 시스템(예: Django)을 위한 맞춤형 세션 백엔드 구현을 고려합니다

여러 세션

from agents import Agent, Runner, SQLiteSession

agent = Agent(name="Assistant")

# Different sessions maintain separate conversation histories
session_1 = SQLiteSession("user_123", "conversations.db")
session_2 = SQLiteSession("user_456", "conversations.db")

result1 = await Runner.run(
    agent,
    "Help me with my account",
    session=session_1
)
result2 = await Runner.run(
    agent,
    "What are my charges?",
    session=session_2
)

세션 공유

# Different agents can share the same session
support_agent = Agent(name="Support")
billing_agent = Agent(name="Billing")
session = SQLiteSession("user_123")

# Both agents will see the same conversation history
result1 = await Runner.run(
    support_agent,
    "Help me with my account",
    session=session
)
result2 = await Runner.run(
    billing_agent,
    "What are my charges?",
    session=session
)

전체 예제

다음은 세션 메모리의 실제 동작을 보여 주는 전체 예제입니다.

import asyncio
from agents import Agent, Runner, SQLiteSession


async def main():
    # Create an agent
    agent = Agent(
        name="Assistant",
        instructions="Reply very concisely.",
    )

    # Create a session instance that will persist across runs
    session = SQLiteSession("conversation_123", "conversation_history.db")

    print("=== Sessions Example ===")
    print("The agent will remember previous messages automatically.\n")

    # First turn
    print("First turn:")
    print("User: What city is the Golden Gate Bridge in?")
    result = await Runner.run(
        agent,
        "What city is the Golden Gate Bridge in?",
        session=session
    )
    print(f"Assistant: {result.final_output}")
    print()

    # Second turn - the agent will remember the previous conversation
    print("Second turn:")
    print("User: What state is it in?")
    result = await Runner.run(
        agent,
        "What state is it in?",
        session=session
    )
    print(f"Assistant: {result.final_output}")
    print()

    # Third turn - continuing the conversation
    print("Third turn:")
    print("User: What's the population of that state?")
    result = await Runner.run(
        agent,
        "What's the population of that state?",
        session=session
    )
    print(f"Assistant: {result.final_output}")
    print()

    print("=== Conversation Complete ===")
    print("Notice how the agent remembered the context from previous turns!")
    print("Sessions automatically handles conversation history.")


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

맞춤형 세션 구현

Session 프로토콜을 따르는 클래스를 생성하여 자체 세션 메모리를 구현할 수 있습니다.

from agents.memory.session import SessionABC
from agents.items import TResponseInputItem
from typing import List

class MyCustomSession(SessionABC):
    """Custom session implementation following the Session protocol."""

    def __init__(self, session_id: str):
        self.session_id = session_id
        # Your initialization here

    async def get_items(self, limit: int | None = None) -> List[TResponseInputItem]:
        """Retrieve conversation history for this session."""
        # Your implementation here
        pass

    async def add_items(self, items: List[TResponseInputItem]) -> None:
        """Store new items for this session."""
        # Your implementation here
        pass

    async def pop_item(self) -> TResponseInputItem | None:
        """Remove and return the most recent item from this session."""
        # Your implementation here
        pass

    async def clear_session(self) -> None:
        """Clear all items for this session."""
        # Your implementation here
        pass

# Use your custom session
agent = Agent(name="Assistant")
result = await Runner.run(
    agent,
    "Hello",
    session=MyCustomSession("my_session")
)

커뮤니티 세션 구현

커뮤니티에서 추가 세션 구현을 개발했습니다.

패키지	설명
openai-django-sessions	Django가 지원하는 모든 데이터베이스(PostgreSQL, MySQL, SQLite 등)를 위한 Django ORM 기반 세션

세션 구현을 개발했다면 여기에 추가할 수 있도록 문서 PR을 자유롭게 제출해 주세요!

API 레퍼런스

자세한 API 문서는 다음을 참고하세요.

• Session - 프로토콜 인터페이스
• OpenAIConversationsSession - OpenAI Conversations API 구현
• OpenAIResponsesCompactionSession - Responses API 압축 래퍼
• SQLiteSession - 기본 SQLite 구현
• AsyncSQLiteSession - aiosqlite 기반 비동기 SQLite 구현
• RedisSession - Redis 기반 세션 구현
• SQLAlchemySession - SQLAlchemy 기반 구현
• MongoDBSession - MongoDB 기반 세션 구현
• DaprSession - Dapr 상태 스토어 구현
• AdvancedSQLiteSession - 분기 및 분석 기능을 갖춘 향상된 SQLite
• EncryptedSession - 모든 세션을 위한 암호화 래퍼