第二部分 · Python 进程内嵌入

Python 宿主的最短集成路径：直接 from agentao import Agentao 拿到运行时，用方法调用驱动，没有任何协议层开销。

本部分关键词

五个反复出现的核心词汇 —— 完整词汇表见 附录 G。

• Agentao 实例 — 一次构造 = 一段会话；close() 是义务 · §2.3、G.1
• Working directory（cwd） — 文件工具根目录、MCP cwd、AGENTAO.md 查找路径；构造时冻结 · §2.2、G.1
• Transport — 推送式回调（emit(event)），驱动流式 UI · §2.7、G.2
• CancellationToken — 宿主侧的取消句柄，用于中断进行中的 chat() · §2.6、G.1
• extra_mcp_servers — 会话级 MCP 注入（不同租户 → 不同 token） · §2.2

本部分覆盖

• 2.1 安装与包导入 — 选版本、包 extras、懒加载特性
• 2.2 构造器完整参数表 — 全部参数语义、工作目录冻结、会话级 MCP、生产嵌入模板
• 2.3 生命周期管理 — chat() / clear_history() / close()、运行时换模型、并发模式、FastAPI 完整示例
• 2.4 会话状态 — 四块状态、持久化/还原配方、记忆自动恢复
• 2.5 运行时切换 LLM — set_provider() / set_model()、路由模式、级联退路
• 2.6 取消与超时 — CancellationToken、断连接线、硬超时、max_iterations
• 2.7 嵌入 FastAPI / Flask 示例 — 生产级模板：SSE 流式、会话池、鉴权、取消

按任务阅读

你现在要做什么	最短路径
先把 Python SDK 嵌进一个脚本	2.1 安装与包导入 → 2.2 构造器最少参数 → 2.3 标准生命周期
接进 FastAPI / Flask 产品	2.7 生产级模板 → 2.6 取消与超时 → 2.4 会话状态
做多租户 / 多会话池	2.2 构造器参数 → 2.4 会话状态 → 2.7 会话池模板
只查某个 API 怎么用	2.2 构造器完整参数表 或 附录 A · API 参考

开始之前

确保你已读过：

• 1.2 核心概念 — Agent / Tool / Transport / Working Directory 等名词
• 1.3 两种集成模式 — 确认 Python SDK 是你的选择
• 1.4 Hello Agentao — 20 行可跑样板

预备心智模型

Agent 不是一个"函数调用"，而是一个有状态的进程组件。 一次 Agentao(...) 对应一段会话； 多会话 = 多实例； close() 是义务，不是建议。

→ 2.1 开始 →