Agent 总览
TauriTavern 的 Agent 系统，是在原有 SillyTavern 生成体验之外，新增的一条创作路径。
传统生成更像一次请求：前端整理上下文，模型返回一段文字，文字进入聊天。如果结果不合心意，通常只能重新生成。Agent 模式希望把这件事改成一段更接近真实写作的过程：先理解上下文，再查阅需要的资料，必要时修改草稿，最后把完成的内容提交到聊天。
它不是要替代普通生成。普通生成仍然适合轻量、快速、直接的对话；Agent 模式更适合需要多步处理、需要回看资料、需要按照创作者约束工作的场景。
一个朴素的定义
在 TauriTavern 中，一次 Agent 运行可以理解为：
Agent 在一个受约束的工作区里阅读、搜索、写入和修改文件，并在完成后把指定的输出提交为聊天消息。
这里的重点不是“模型会调用工具”这件事本身，而是 TauriTavern 为这段过程提供了清晰边界：
- Agent 的中间过程写在工作区中，而不是直接污染聊天记录。
- 每次读取、搜索、写入、修改、委派和提交都会进入运行时间线。
- 创作者可以通过 Agent 配置档案限制可见内容、可用工具、SKILLS、模型和预算。
- 复杂任务可以拆给允许被调用的 SubAgent，由它们在后台完成局部工作后返回结果。
- Agent Mode 关闭时，原有 SillyTavern 生成路径保持不变。
什么时候适合使用 Agent
Agent 模式适合这些情况：
- 你希望回复在生成前能回看较长的聊天历史。
- 你希望模型能先整理草稿，再提交最终回复。
- 角色卡、预设或玩法需要更稳定的状态栏、小剧场、摘要或长期记忆。
- 创作者希望为某类写作任务提供固定工具、说明和素材。
- 一个任务可以被拆成几个相对独立的小任务，例如资料整理、草稿检查或风格校对。
- 你希望看见模型到底做了哪些操作，而不是只得到最后一段文字。
普通生成仍然适合这些情况：
- 你只需要一次快速回复。
- 当前模型或 API 不支持 Agent 所需的工具调用路径。
- 当前玩法依赖上游 SillyTavern 的工具调用或流式事件细节。
- 你希望完全保持原有 SillyTavern 行为。
Agent 不是什么
为了避免误解，当前 TauriTavern Agent 也有明确边界：
- 它不是让模型直接操作系统文件。
- 它不是让预设、角色卡或 SKILLS 执行脚本。
- 它不是把工具结果伪装成聊天楼层。
- 它不是一个绕过现有 API 设置、密钥、日志和平台策略的独立模型调用器。
- 它不是让多个 Agent 无限制并行工作的后台队列；委派能力仍受 Profile 和运行预算约束。
- 它也不是必须开启的全局行为。
温和但明确的失败
如果 Agent 配置缺失、请求了不可见工具，或试图访问工作区之外的路径，TauriTavern 会明确停止本次运行或返回可理解的错误。这样做是为了避免“看起来成功了，但实际走了另一条路”的隐性问题。
当前文档的读法
如果你只是想使用 Agent：
如果你是预设、角色卡或玩法创作者：
- 先读 Agent 配置档案。
- 如果要拆分任务，继续读 SubAgent。
- 再读 SKILLS。
- 然后读 创作者适配指南，把说明、素材和限制整理成稳定的分发方式。
- 如果你主要维护预设，继续读 预设作者指南。
- 如果你维护扩展或自动化面板，继续读 扩展作者指南。
- 如果你制作主题或 CSS 美化，继续读 主题美化作者指南。
和现有文档的关系
Agent 栏目面向用户与创作者，重点解释如何使用、如何适配、边界在哪里。
如果你需要开发层面的接口或宿主 ABI，请查看 API 文档；如果你需要理解 TauriTavern 的整体工程分层，请查看 架构总览。
更细的 Agent 参考也可以直接阅读：
- Agent 系统架构：理解工作区、时间线、工具循环和提交边界。
- Agent API：查看启动、订阅、取消、读取工作区和配置档案管理接口。
- Agent 工具参考：查看当前内建工具的输入输出。
- Skill API：查看 SKILLS 的导入、安装、读取、导出和删除接口。