返回目录 / Agent 状态
用持久会话延续跨请求Agent对话
为同一用户或任务关联持久会话,使后续运行读取必要历史且不串用他人上下文。
目标
让后续调用延续正确的对话状态,并隔离不同用户的记录。
步骤
- 定义会话标识的生成、归属、过期和删除规则。 [openai-sessions] [openai-context]
- 为用户或对话创建稳定ID:
session=SQLiteSession("conversation_123", "conversations.db");共享持久存储时确保session_id按用户授权。 [openai-sessions] [openai-context] - 每轮调用
await Runner.run(agent, user_input, session=session);可用RunConfig(session_settings=SessionSettings(limit=...))限制取回历史。 [openai-sessions] [openai-context] - 按保留策略清理过期会话,并让会话内容遵循数据最小化原则。 [openai-sessions] [openai-context]
- 用两个隔离用户完成多轮测试,确认各自能延续历史且看不到另一方记录。 [openai-sessions] [openai-context]
验证方式
多轮测试应保留同一用户上下文,同时验证跨用户会话读取被拒绝。
故障处理
若历史丢失或串线,先核对会话ID归属和后端持久化,再检查提示词。
权限边界
前置条件
- Python 3.10+、固定提交兼容的 openai-agents、获准模型提供商凭据(本地模拟测试例外)
权限边界
- 只在本地或隔离测试环境操作;涉及外部数据或副作用时使用最小权限并先审批
限制
`SQLiteSession`适合内嵌/本机持久化;多进程部署需选择共享Session backend。Session不能与conversation_id、previous_response_id等server-managed续接同时传入。
固定上游来源
- 仓库
- openai/openai-agents-python
- 文件路径
- docs/ref/memory/session.md
- 固定提交
f53c62451c7f34c15f0c87fa745e05404025420f- 来源检查
- 2026-10-14 · 已按固定上游来源核对
仓库指标
以下数字属于上游仓库整体,不代表单个 Skill 或指南的点赞/热度。
- Stars
- 未取得
- Forks
- 未取得
- 观测时间
- 未取得
尚未取得指标快照。
许可证: MIT