3 行代码打通多轮对话：openai-agents-python Session 会话指南

3 行代码打通多轮对话openai-agents-python Session 会话指南【免费下载链接】openai-agents-pythonA lightweight, powerful framework for multi-agent workflows项目地址: https://gitcode.com/GitHub_Trending/op/openai-agents-python在 openai-agents-python 中Session负责把每次Runner.run()产生的对话历史存下来并在下次运行时自动拼回输入让你不用手写.to_input_list()就能实现跨轮上下文。框架自带 SQLite、Redis、MongoDB、SQLAlchemy、加密包装层等后端全部遵循同一个Session协议可以互换。读完本文你可以为自己的 Agent 配上持久化会话、撤销一次错误回复并接入 Redis 或自建存储。系统全景1 个协议、4 个方法、多个后端整个体系只有一张接口定义在 Session 协议 中方法作用get_items(limit)读取历史limit只取最近 N 条按时间正序返回add_items(items)追加新对话项pop_item()移除并返回最近一条空会话返回Noneclear_session()清空当前会话内置与扩展实现一览SQLiteSession核心包自带:memory:或文件路径两种模式RedisSession/MongoDBSession/DaprSession分布式存储位于agents.extensions.memorySQLAlchemySession对接 PostgreSQL、MySQL 等任意 SQLAlchemy 异步数据库EncryptedSession包装层对任意底层会话做 Fernet 加密并支持 TTL 过期OpenAIConversationsSession直接用 OpenAI 托管对话存储状态最小示例3 行代码启用会话from agents import Agent, Runner, SQLiteSession agent Agent(nameAssistant, instructionsReply very concisely.) session SQLiteSession(user_1001) result await Runner.run(agent, Ill order the salmon tonight, sessionsession) result await Runner.run(agent, How about a dessert to go with it?, sessionsession)创建会话只需SQLiteSession(session_id)之后把session传给Runner.run即可。第一次运行后历史自动入库第二次运行时框架自动把上文读回输入。完整可运行版本见 sqlite_session_example.py。存储选型先问自己一个问题判断问题只有一个对话状态需要跨进程存活多久、谁能访问只在单进程内用、重启可丢 →SQLiteSession默认的:memory:单机要落盘 →SQLiteSession(session_id, conversations.db)指定文件路径多实例/多服务共享 →RedisSession、MongoDBSession或SQLAlchemySession对接既有企业数据库 →SQLAlchemySession.from_url(user-123, urlpostgresqlasyncpg://..., create_tablesTrue)涉及隐私数据 → 任意后端再套一层EncryptedSession方案依赖持久化适用场景SQLiteSession内存无否测试、脚本SQLiteSession文件无是单机应用RedisSessionredis是多实例共享、高频读写MongoDBSessionmongodb是已有 Mongo 基础设施SQLAlchemySessionsqlalchemy是企业级 RDBMS 集成EncryptedSessioncryptography随底层敏感对话数据场景实战用 pop_item() 撤销一次错误回复用户发现上一轮回答有问题时按从新到旧的顺序弹出条目再重跑bad_reply await session.pop_item() # 移除助手的错误回答 bad_query await session.pop_item() # 再移除触发它的那条用户输入 result await Runner.run(agent, 换个角度只列关键结论, sessionsession)弹出条目时会原样返回方便你记录日志或展示给用户被撤销的内容。多智能体共享同一段对话客服和账单两个 Agent 共用一个session_id后者天然知道前者的上下文无需传递摘要session SQLiteSession(ticket_456) r1 await Runner.run(support_agent, 我的账单好像多扣了一笔, sessionsession) r2 await Runner.run(billing_agent, 帮我核对这笔扣款, sessionsession)这种模式适合工单、售前售后交接等需要接话的流程。自定义后端实现 Session 协议即可第三方实现只需满足Session协议的结构session_id属性 4 个异步方法无需继承SessionABCfrom agents.memory.session import Session from agents.items import TResponseInputItem class MySession(Session): session_id: str async def get_items(self, limitNone): # 返回最近 N 条历史limit 为 None 时返回全部 ... async def add_items(self, items): # 批量写入新对话项 ... async def pop_item(self): # 删除并返回最近一条空会话返回 None ... async def clear_session(self): # 清空本会话全部数据 ...实现后直接传给Runner.run(session...)框架不关心数据落在哪里。避坑清单上线前检查 5 件事会话 ID 要能反查到业务实体用ticket_456、user_1001这类前缀 主键的格式排查问题时能直接定位数据避免用str(uuid4())生成后无处记录。默认 SQLite 是内存模式不传db_path时数据随进程消失需要落盘记得显式传文件路径。TTL 别设得太长EncryptedSession的ttl按会话冷却期估算客服场景 10 分钟到 1 小时通常够用避免敏感数据无限期驻留。get_items(limit)返回的是最近 N 条且按时间正序做滑动窗口时别假设它是倒序。pop_item()是移除不是查看只读最近一条用get_items(limit1)误弹后要自行把条目加回去。延伸资料协议与全部方法签名src/agents/memory/session.py官方会话文档docs/sessions/index.mdSQLAlchemy 后端源码src/agents/extensions/memory/sqlalchemy_session.py高级 SQLite 示例examples/memory/advanced_sqlite_session_example.py加密会话示例examples/memory/encrypted_session_example.py【免费下载链接】openai-agents-pythonA lightweight, powerful framework for multi-agent workflows项目地址: https://gitcode.com/GitHub_Trending/op/openai-agents-python创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考