Agent 快速开始

Agent Mode 是一个可以按需开启的生成模式。它不会在关闭时改变普通 SillyTavern 生成，也不会要求你重新组织现有聊天。

开启入口

当前有两个常用入口：

• 在聊天输入栏附近，点击 Agent 按钮切换开启或关闭。
• 在扩展设置中的 Agent 系统 区域，点击 Agent 模式已开启 / Agent 模式已关闭。

长按输入栏旁的 Agent 按钮，可以打开 Agent 系统面板。面板里可以管理配置档案、SKILLS 和当前使用的 Agent。

TIP

如果你只是想体验 Agent，先使用内置的 default-writer 即可。它是通用写作者配置，适合普通创作与对话。后续需进一步的需求时，再复制它做自己的配置。

选择当前 Agent

Agent 系统面板里有一个 Active Profile。它决定下一次 Agent 运行实际使用哪份配置。

需要注意两点：

• 正在编辑的 Profile 不一定就是正在运行的 Profile。运行前请确认 Active Profile 选对了。
• 只能直接运行的 Profile 才会出现在 Active Profile 列表中。只允许作为 SubAgent 的 Profile 不能被手动选为主 Agent。

如果某个导入的 Profile 显示需要重新配置模型，先在 Profile 里选择本机可用的模型连接，再启动 Agent。

开启后会影响哪些操作

Agent Mode 开启后，当前这些生成会接入 Agent：

操作	行为
普通发送	使用当前聊天上下文启动一次 Agent 运行
重新生成	为当前回复启动新的 Agent 运行
右划生成新候选	生成新的 swipe 候选时走 Agent
/trigger	在支持的单人聊天中触发一次普通 Agent 生成

这些行为保持原有路径：

操作	行为
切换已有 swipe 候选	不启动新的 Agent
Agent Mode 关闭后的发送	走原有 SillyTavern 生成
非 Agent 的扩展行为	不会因为 Agent 面板存在而自动改变

当前 Agent Mode 主要面向单人聊天和 OpenAI/chat-completion 路径。群聊、非 chat-completion 路径或已有外部 tool turns 的生成，会明确失败或回到原有路径，而不是静默混用。

一次 Agent 运行会发生什么

从用户角度看，流程大致是这样：

你发送消息
  ↓
TauriTavern 捕获本轮生成所需上下文
  ↓
Agent 创建本次工作区
  ↓
模型按配置档案看到可用工具、SKILLS、工作区和可调用的 SubAgent
  ↓
Agent 可能搜索聊天、读取世界书、读取 SKILLS、写入草稿，也可能把局部任务委派给 SubAgent
  ↓
Agent 将输出文件提交为聊天消息
  ↓
运行结束，时间线保留过程

这意味着，Agent 的最终回复不是模型直接吐出的一段文字，而是由它在工作区里完成的输出文件提交而来。

认识时间线

Agent 运行时，输入栏附近会出现 Agent 时间线。它用于展示本次运行正在做什么。

常见事件包括：

时间线事件	含义
搜索聊天	Agent 在当前聊天中查找相关历史
读取聊天记录	Agent 按消息索引读取具体内容
读取世界书	Agent 查看本轮实际激活的世界书条目
查看技能列表	Agent 查看当前配置允许使用的 SKILLS
读取技能	Agent 读取某个 Skill 的文件
委派子任务	Agent 启动一个 SubAgent 去处理局部任务
等待子任务	Agent 等待一个或多个 SubAgent 返回结果
子任务返回	SubAgent 返回摘要、发现或产物引用
写入文件	Agent 在工作区写入草稿、输出或笔记
修改文件	Agent 对已读文件做精确修改
提交回复	Agent 把输出文件提交到聊天
完成任务	Agent 结束本次运行

点击时间线中的条目，可以查看更具体的详情。并不是每个事件都有长文本详情；有些事件只用于说明运行状态。

短对话式回复

Agent 不一定只能等到最后一次性提交一大段回复。它也可以多次使用追加提交，让回复以更短、更接近真人聊天节奏的方式逐段出现。

这适合：

• 轻松闲聊。
• 角色自然接话。
• 需要一点停顿感的对话。
• 不希望一次回复显得过长的场景。

需要注意的是，当前追加提交仍属于同一次 Agent 运行，并由同一条 Agent 消息承载连续内容；它不是在聊天记录中创建多条完全独立的消息楼层。这样可以保留短对话的阅读节奏，同时不破坏本次运行的提交、时间线和保存语义。

运行时不要急着再次发送

Agent 正在运行时，建议先等待当前运行完成。Agent 需要维护工作区、时间线和聊天提交顺序；连续触发多次生成可能让当前聊天更难判断哪一次是你真正想保留的结果。

如果结果不理想，可以在运行结束后再重新生成，或调整配置档案和 SKILLS 后再次尝试。

第一次使用的建议

可以从一个普通场景开始：

1. 打开一个已有聊天。
2. 确认当前使用的是 chat-completion 路径的模型连接。若要让 Agent 使用独立模型，先参考常见问题中的模型指定说明。
3. 开启 Agent Mode，并确认 Active Profile 是 default-writer 或其它可直接运行的配置。
4. 发送一句普通消息。
5. 展开 Agent 时间线，观察它是否搜索、读取、写入并提交。

如果本次运行失败，先查看错误提示。当前 Agent 倾向于明确失败，而不是悄悄退回普通生成；这能帮助你知道到底是模型、配置、工具权限还是上下文路径出了问题。