制作通常有三个入口：
\n本部分先从少量配置开始，带你看清每一项设置的作用。使用模板或自然语言创建时，也可以按同样的方法检查生成的内容。
\n我们先制作一个依据资料回答问题的话题助手，再学习判断与调度、工具执行、后台运行和实时语音。第一次制作时，先让它完成一件可以检查的小事。例如，依据一份活动说明回答时间、费用和参加条件；这些回答通过检查后，再考虑连接报名系统、查询个人记录等能力。
\n制作前，还需要确定成品放在哪里、供谁使用。问答助手可以做成一个通过链接打开的聊天网页；工作流中的 Agent 可以作为其中一个处理步骤；后台任务则需要配置无人值守时的运行入口。制作平台要根据这些用途选择。第一节学习平台内专用助手的创建，以及已有 Agent 的知识配置。
" }, { "id": "course-agent-building-topic-1", "title": "1. 制作有知识库的话题助手", "url": "https://ai-knowledge-map.com/software/agents-automation/agent-building/#course-agent-building-topic-1", "html": "打开 ChatGPT 网页端，点击左侧的三个点后选择“GPT”。
点击右上角“创建”，之后选择“创建插件”或创建“GPT”（后者即将被取消）。
| 配置项 | 需要填写或准备的内容 |
|---|---|
| 名字、描述 | 核心用途、面向谁使用、语气和回答深度 |
| 指令 | 具体功能、操作范围、运行限制、使用示例（用户需要提供什么、结果应是什么样、信息不足时怎么办） |
| 对话开场白 | 开场白展示可以问什么，指令中的示例展示应该怎样回答 |
| 知识 | 数据来源、已有资料、每份资料的用途 |
| 工具能力 | 需要启用的能力；涉及外部服务时再配置连接 |
填写配置项的要点和写优秀提示词一样，只不过更需要能反复处理不同用户、不同材料的同类任务，也不存在必须使用的特殊格式或神奇词语。我们分别来看指令、对话开场白、知识和工具能力如何配置。
\n写出遇到什么情况如何处理（是否需要追问，是否可以默认或标注未说明），通常包括：
\n列出用户经常问的问题，以及我们回复的优秀案例。
\n示例需要教会模型以下情况的处理：
\n在及基础上，示例也需要教模型回答格式，回答语气和答案结构。且不同示例需要保持差异避免模型学到不该学到的规律。例如，如果示例中全部以追问结尾，模型可能会无意中学到”必须追问“。
\n有些示例可能会采用特殊写法：
\n<examples> 和 </examples>：标记整组示例的开始与结束。
<input>、<output>：区分用户输入和理想回答。
但普通文字写法也没有问题。
\n这部分在开始使用时展示给用户，让用户知道可以怎么写提示词，怎么问问题，以及间接传达该agent的核心功能。
\n优秀的开场白应该：
\n通常设计至少3段对话开场白。
\n数据来源、已有资料、每份资料的用途可以写进一段中。
\n数据来源包括1. 来源名称，2.版本， 3.获取方式， 4.适用范围。
\n每份资料的用途需要说明：遇到什么任务，使用哪份资料，取得什么信息；必要时说明不能从中推断什么。
\n如果知识里没有填写数据来源、已有资料、每份资料的用途的地方，只有上传按钮，我们可以将该部分写在指令里。如果资料很多且难以分类，可以额外写一份资料使用说明文档上传，并在指令中让agent需要时读取它。
\n接入外部工具的入口，在ChatGPT的"创建GPT"中，我们使用"Actions"来接入工具。ChatGPT的Enterprise用户的"创建GPT"在12月后将被取消并转换为插件，现在的插件制作skill中可以通过agent很轻松地接入外部工具。
\n如果你没有看到Actions，有可能是勾选了Apps，或者还没有跟"创建GPT"中的agent说话。在第一次对话后，Actions和推荐模型才会出现。
\n接下来只需要在对应的工具平台上充值后使用API key连接到我们的Agent上就可以了。如果你找不到API key的网址入口，就直接让AI帮你找。
\n尽管同一个api key可以分给不同agent和其他接入软件，但还是推荐对每个agent和用途建立不同的key，这样方便进行单独停用，用量查看和权限管理。此外注意key属于隐私信息，一旦泄露相当于别人可以使用你的平台余额，需要妥善保管。
\n如果你已经在使用 Claude、WorkBuddy 或 Codex，可以把自己的资料接入原来的 Agent。除了处理单次任务的附件外，我们可以把需要反复使用的资料，再放进项目知识区、资料库或固定目录。
\nAGENTS.md是给Agents看的命令文件中最常用的（注意大小写固定）。如果你希望ChatGPT与你的所有对话都带有某种特征或遵循某个规则，可以在设置全局AGENTS.md（路径是~/.codex/AGENTS.md）。不同的模型都有类似的设置，例如Claude Code的全局文件CLAUDE.md(路径是~\\.claude\\CLAUDE.md)。这些文件会在全局启动时加载。
\n对于单独的项目，也可以在项目文件夹中加入针对该项目的AGENTS.md，里面说明了AGENTS.md该如何使用知识库，该在什么条件下加载哪份资料，从而避免对于任何问题都花费大量时间和token查看无用资料。
\n注意AGENTS.md也会被放入上下文，因此尽量简洁明确，彼此不矛盾。更复杂的信息和长篇操作流程可以另放文件。
\n以 Codex 为例：
\nAGENTS.md。已有这个文件时，在原有内容中补充相关要求。例如，资料目录中分别保存产品手册和写作示例，
\n资料库/\n├── AGENTS.md\n├── 产品资料/\n│ ├── 产品手册.md\n│ └── 常见问题.md\n└── 写作参考/\n └── 文章示例.md可以在 AGENTS.md 中写：
回答产品功能和操作问题时，先查阅“资料/产品手册”。\n“资料/写作示例”用于参考表达，其中的具体事实不直接用于新任务。\n回答中注明所用文件及对应章节。\n本项目的资料问答任务只读取文件；修改资料需要明确的更新要求。注意有些旧版本的平台不支持根文件夹下放子文件夹时直接读取子文件夹里的资料，会导致子文件夹无法读取，请检查这一点。
\n资料已经保存在团队文档、网盘、业务系统中，且需要持续更新时，可以先查看 Agent 是否支持相应连接器。这样，后续任务可以查询原系统中的资料。
\n| 准备项 | 具体内容 | 通常由谁提供 |
|---|---|---|
| 访问账号 | 能够读取这些资料的企业账号 | 企业管理员授权 |
| 接入方式 | 软件已有的连接器，或企业提供的 MCP／API | 自己查找；没有时找技术人员 |
| 使用说明 | 资料分别用于什么，哪些版本有效，回答如何标注来源 | 你和业务负责人 |
| 测试问题 | 几个已知答案的问题，以及对应原文 | 你 |
不要只说“帮我把数据库接上”。可以直接提交这样的需求：
\n\n我需要让 Agent 查询订单状态，并按日期、地区统计已付款销售额。
\n请提供允许查询的数据范围、只读访问方式、字段与统计口径说明，以及可用于核对结果的测试问题。
\n如果企业已有查询 API 或 MCP，请提供接入配置；如果需要直接连接数据库，请提供对应工具的配置方法。
技术人员可以据此选择两种做法：
\n如果企业提供远程 MCP，按前面的“添加 MCP 服务”步骤连接即可。数据库凭据可以保留在企业服务端，你使用企业账号登录。
\n如果企业允许从本地直接连接，也有现成工具。例如，Google 开源的 MCP Toolbox for Databases 提供 PostgreSQL 等数据库的接入方案。PostgreSQL 官方接入教程
\n以 PostgreSQL 为例，需要先由技术人员：
\n注意对Agent的只读限制需要落实到数据库账号或服务端。之后进行连接验证和小测试。
" }, { "id": "course-agent-building-topic-2", "title": "2. 制作有记忆的语音 Agent", "url": "https://ai-knowledge-map.com/software/agents-automation/agent-building/#course-agent-building-topic-2", "html": "如果你希望 Agent 在新对话中继续了解你的偏好、已经确认的事情和正在推进的工作，就需要配置跨对话使用的记忆。例如，学习助手记住你已经学到哪里，写作助手记住你认可的表达方式，工作助手记住上次确定的方案。
\n先确定这些信息保存在哪里。使用平台自带的助手，可以先开启内置记忆；希望自己查看、修改和迁移记录，可以使用记忆文件；需要让多个设备或不同 Agent 共用记忆，可以考虑外部记忆服务。
\n如果主要在同一个产品中使用自己的助手，先检查内置记忆是否够用。通常不需要另建数据库，也不需要购买其他服务的 API。
\nClaude 的项目也有自己的记忆。在项目页面的 Memory 设置中，可以用 Use account memory 控制是否同时使用账号记忆。不要把一个项目里保存的信息，当作所有项目都会使用的信息。Claude 官方记忆教程
\n点击头像，进入 设置 → 记忆，检查“生成对话记忆”是否开启。打开已生成的记忆可以查看内容，点击编辑图标可以通过对话提出修改要求。
\nWorkBuddy 官方说明会每晚整理当天会话，因此刚说完一件事，记忆摘要不一定立即更新。需要检查保存结果时，要考虑这个更新时间。WorkBuddy 官方记忆教程
\n进入 Settings → Personalization，开启 Enable Codex memories；在当前聊天中输入 /memories，检查是否允许使用已有记忆，以及让本次聊天参与生成后续记忆。涉及 MCP 工具或网页搜索的聊天，还要检查 Allow memories from tool-assisted chats。
这里的记忆在后台整理，不一定立即生成；它和 ChatGPT 网页端的账号记忆是两套存储。换到网页端或另一台电脑时，需要另外检查，不能因为登录同一账号就认定已经共用。OpenAI 官方记忆教程
\n如果你希望明确知道保存了什么，能够自己修改、备份，或者把记录交给另一个 Agent，可以使用普通文本文件。这种方式适合能够读写本地文件的 Agent；只有上传附件功能的聊天界面，不能据此自动更新你电脑上的文件。
\n在 Agent 可以访问的工作目录中新建 memory.md，可以先只写三个分类：
# 用户偏好\n\n# 已确认的背景信息\n\n# 正在进行的事情这里的文件名是我们自己约定的。文件叫 memory.md，并不意味着任何 Agent 都会自动读取它。
在上一节配置的项目指令文件中，补充记忆文件的实际路径和使用要求。下面是一份可以按需修改的写法：
\n记忆文件位于当前项目根目录的 memory.md。\n\n每次开始新对话时，先读取该文件，使用其中与当前任务有关的信息。\n当我明确要求“记住”，或确认某项偏好以后继续适用时，更新该文件。\n只记录我已经确认的信息，不把你的猜测、举例或待选方案记成事实。\n每条记录写明内容和确认日期；临时事项另外写明适用时间或完成状态。\n同一事项发生变化时，更新原条目，避免同时保留两个相互矛盾的当前结论。\n我要求忘记某项信息时，删除对应条目。\n只有文件写入成功后，才告诉我已经保存；没有写入权限时说明原因。这份写法选择“明确要求或确认后保存”。如果希望 Agent 自动整理，也可以改成允许它保存已确认的偏好和工作进展，同时保留“不记录猜测”和“更新旧条目”的要求。
\n有些产品已经提供自动维护记忆文件的功能。例如，Claude Code 的普通本地会话默认开启自动记忆，可以输入 /memory 查看设置和记录。其记忆按项目保存在本机，官方说明不会自动跨电脑共享。使用这类功能前，可以先检查是否已经满足需要，再决定是否另外维护文件。Claude Code 官方记忆教程
如果你希望不同设备、不同客户端中的 Agent 共用一份记忆，可以把记录放在外部服务中。前提是这些 Agent 都能连接该服务，并使用同一份记忆范围。仅仅分别打开两个软件的内置记忆开关，不会把它们连起来。
例如Mem0 。它提供保存、搜索、修改和删除记忆的工具，支持通过 MCP 接入。
配置时，可以先确定以下几类信息的处理方式：
\n如果需要回看某次讨论的完整经过，应查原始对话或工作记录。不要要求一条简短记忆同时充当完整聊天备份。
\n如果希望像通话一样连续交流，让 Agent 听你说话并用声音回应，就需要完整的语音对话功能。
\n如果已有任务中没有语音按钮，先更新桌面应用和运行任务的 Codex 主机，再检查账号与工作区是否开放该功能。语音输入和实时语音对话是不同入口，看到麦克风按钮不一定代表能够连续通话。OpenAI 官方语音教程
\nClaude 支持在同一段对话中切换文字和语音，之前的上下文会延续。需要补充网址、专有名词或其他容易听错的内容时，可以改用文字输入。Claude 官方语音教程
\n如果希望单独设置助手的声音、开场话术、等待时间，并把它提供给别人使用，可以选择带有语音配置界面的搭建平台。下面以 ElevenLabs Agents 为例：它可以在网页中配置语音助手，并提供测试入口和网站组件。
\n登录 ElevenLabs，进入 Agents 控制台，新建助手并选择 Blank template。
\n在 Agent 页中填写：
\n进入 Voice 页选择声音和调整 Speed。
\n在 Agent 设置中找到 Turn eagerness，先用 Normal；经常需要思考、组织长句时，可以改成 Patient，让它多等一会儿。
\n需要随时插话时，在 Advanced → Client Events 中确认选中了 interruption。等待时间、打断等行为要在相应设置中配置，不能只在指令里写一句“不要抢话”。官方对话节奏配置教程
如果希望保留自己的网页、角色形象，或继续使用已经开发好的 Agent，可以通过 API 接入语音。已有 Agent 需要提供可调用的接口，或者你能够修改它的代码。
\nAgent 生成最终回答\n ↓\n程序自动取得这段回答文字\n ↓\n后端调用 ElevenLabs等平台，提交文字、声音编号和模型\n ↓\nElevenLabs 返回音频\n ↓\n后端把音频传给当前用户的网页\n ↓\n网页播放器播放声音可以通过对话提出要求，不必先学习定时表达式。下面这些信息需要讲清楚，可以按实际任务替换方括号中的内容：
\n请创建一个定时任务。\n执行时间：[单次日期，或重复频率、具体时间、时区]。\n每次任务：[要执行的工作]。\n资料来源：[文件、项目、已连接的服务或指定网站]。\n处理范围：[本次要处理哪些对象，或哪个时间段的内容]。\n交付结果：[输出内容，以及保存位置或通知方式]。\n没有符合条件的内容时：[结束本次任务，或记录“无更新”等处理方式]。“提醒我整理周报”和“读取本周记录并生成周报”是两个不同要求。希望 Agent 完成工作时，要把实际工作写进任务，而不只是设置提醒。
\n在聊天中提出定时要求，并说明以后回到当前对话继续处理，还是每次独立运行。创建后打开 Scheduled，检查保存的任务内容、执行时间和状态。
\n需要在电脑项目中读写文件时，使用桌面端对应项目，保持电脑开机、应用运行；网页任务使用可访问的上传材料或连接服务，不能直接使用电脑上的文件夹。OpenAI 官方定时任务教程
\n可以直接在普通对话中描述周期性需求。也可以点击左侧 定时任务 → 新建旁的下拉箭头 → 从任务新建，补充需求后发送。
\n需要手动配置时，点击 定时任务 → 新建，填写：
\n保存后，查看卡片上的下一次执行时间，点击运行按钮试跑；在“运行记录”中查看结果。不再需要重复执行时，可用卡片开关暂停。暂停后续执行不会中断已经开始的那一次。
\n本地任务依赖电脑和客户端；标有“云端”的任务在云端执行，但不能直接访问本机文件。WorkBuddy 官方定时任务教程
\n如果只想在某类事情发生时工作，先找软件已经支持的事件，例如“收到邮件”“出现新消息”“代码仓库有更新”。连接到某个应用，并不意味着所有事件都能触发任务，需要检查支持的事件清单。
\n以 ChatGPT 为例，符合条件的账号可以在网页端或手机端创建 Gmail、Slack、GitHub 的事件任务，桌面端没有这个创建入口。
\n先连接并授权应用，再在对话中描述：
\n请创建一个事件触发任务。\n事件来源：[账号、频道或仓库]。\n触发条件：[哪些新事件需要处理，以及筛选条件]。\n每次任务：[根据收到的内容执行什么工作]。\n交付结果：[保存在哪里，什么情况通知我]。创建后到 Scheduled 核对。是否可用受套餐和工作区设置影响；一个任务不能同时使用事件触发和时间计划。OpenAI 官方事件触发说明
\n筛选条件尽量放在触发设置中。例如，只处理某个发件人的邮件时，优先配置发件人条件，减少无关邮件触发 Agent。任务指令则说明收到符合条件的内容后，该如何处理。
\n需要连接的软件或触发条件不在原产品的支持范围内时，可以使用 n8n 这类自动化平台。它把“什么时候启动”“交给谁处理”“结果送到哪里”连接起来。
\n下面以 n8n 为例。可以使用云端版，省去本地安装；已经有企业提供的 n8n，也可以在现有环境中配置(可能需要Docker)。这里先做最短的流程：
\n定时或事件触发 → Agent 处理 → 保存结果或通知在新工作流中添加触发节点。节点可以理解为流程中的一个步骤。
\n定时运行：添加 Schedule Trigger。
\n在 Trigger Rules 中添加规则，用 Trigger Interval 选择天、周、小时等单位，再填写对应时间。在工作流设置中核对时区，避免把服务器时区当成自己的时区。保存后还需要发布工作流，才会按计划执行。n8n 官方定时触发教程
\n事件触发：选择对应应用的 Trigger。
\n以邮件为例，添加 Gmail Trigger：
\n希望 Agent 全天接收任务、在你离开后继续工作，首先要给它一个持续可用的运行位置。最方便的是使用产品已经提供的云端功能；必须使用本机软件和文件时，再配置电脑持续运行；已经开发成独立程序时，可以部署到云端托管平台或服务器。
\n这里要区分两种需求：一是随时等待新任务，有任务才处理；二是围绕一个目标持续推进，完成一部分后继续下一部分。程序保持在线，只解决运行位置的问题；要让工作继续推进，还需要配置后面的目标与进度。
\n如果任务可以使用上传的资料、在线文档、远程工具和接口完成，可以先选择云端运行。这样，自己的电脑不必一直开机。
\n在 ChatGPT 网页端选择 Work 发起工作；在支持切换的桌面端，新建任务时选择 Cloud。上传需要的资料、连接工具，再说明要完成的工作。
\n官方说明，云端 Work 任务可以在关闭桌面应用后继续，并从网页或手机跟进。仍需留意任务是否已经完成，或正在等待补充信息与确认。OpenAI 官方云端 Work 说明
\n如果任务还需要通过连接的电脑读取本地文件、操作本机工具，那台电脑仍要在线。选择云端协调，不会把电脑里的所有文件和软件一起搬到云端。官方本地访问说明
\n账号中有 dots 入口时，也可以使用这种持续型助手。它有自己的云端电脑，可以在对话之间继续跟进工作，并按需要暂停、唤醒和继续。
\n配置时，先打开 dots 完成创建，再连接工作需要的应用；随后交代持续负责的目标、资料来源、交付结果，以及什么时候需要你决定。之后可以从它的 Activity 查看具体任务。需要使用你自己的电脑时，仍要单独连接并保持电脑在线。官方创建教程、持续任务说明
\n如果已经在 n8n Cloud 中搭好 3.1 的流程，可以继续使用云端实例并发布工作流，无需为了保持运行而开着个人电脑。不过，流程调用的 Agent 接口、资料和工具也必须持续可达；若其中一步依赖本机程序，本机离线仍会影响这一步。n8n Cloud 官方说明
\n需要处理本地文件、使用本机登录状态，或者操作没有云端接口的软件时，可以继续在自己的电脑上运行 Agent。先配置运行条件，再考虑是否需要额外服务器。
\n以 WorkBuddy 桌面端为例：
\n“运行时防止系统休眠”在任务结束后就不再阻止休眠；它也不能阻止主动关机或睡眠。需要全天待命时，不能只检查任务运行期间的这个开关。WorkBuddy 官方系统设置、锁屏运行说明
\n其他本地 Agent 也需要检查相应的防休眠、退出行为和启动设置。缩小窗口、关闭窗口、退出程序可能产生不同结果，要按具体软件确认。涉及桌面操作时，还应实际检查锁屏后能否完成所需操作。
\n如果希望 Agent 整理大量材料、逐步完成一个项目，除了保持运行，还要让它清楚下一步做什么、做到哪里结束。
\n以 ChatGPT 桌面端或 Codex 的 Goal mode 为例，在对话中输入 /goal，填写目标、约束和可检查的完成条件。运行时可以通过目标进度栏暂停、恢复或修改目标。
这个功能帮助 Agent 围绕目标持续工作，不会替它扩大权限，也不能让断网或关机后的本地程序继续执行。官方建议在预计失去连接前暂停，恢复条件后再继续。OpenAI 官方长任务教程
\n对于自己配置的 Agent，可以要求它在每个阶段结束时，更新一份进度文件或数据库记录，至少包含：
\n再次启动时，先读取并核对这些记录，再继续剩余任务。保存方法可以沿用 2.1 的文件或外部存储方式；这里需要记录的是任务执行进度。
\n长任务会不断积累对话、文件内容和工具结果。保存进度以后，还需要控制每一轮带入的信息，否则任务可能在完成前就耗尽上下文，或者难以从大量旧内容中找到当前需要的依据。
\n1. 优先使用产品自带的自动压缩。
\n自动压缩会把较早的对话整理成摘要，为后续工作腾出空间。例如，Claude Code 会在接近上下文上限时自动整理；可以用 /context 查看占用，也可以手动执行 /compact，并指定整理重点。
希望压缩后继续保留某些内容，可以在 CLAUDE.md 中添加 Compact Instructions，说明要保留当前目标、关键决定、未完成事项和验证结果。固定规则也应保存在持久指令中，因为摘要可能遗漏早期对话里的细节。Claude Code 官方上下文说明
Codex CLI 也提供 /compact，用于把较早对话替换为简短摘要。这个命令属于对应客户端，不应直接套用到所有聊天软件中。OpenAI 官方命令说明
手动压缩适合有人跟进时使用。无人值守任务需要确认产品能够自动管理上下文，或由程序在合适阶段执行整理；只在提示词中写“上下文满了就压缩”，不能替代这项软件能力。
\n2. 每个阶段只读取当前需要的材料。
\n把任务拆成可以分别完成和检查的阶段，每次读取当前阶段涉及的文件或检索结果。完整资料、详细日志和已生成成果保存在外部，当前上下文只保留摘要、关键结论和来源位置；需要核对时再读取原文。
\n例如，逐份处理大量文档时，可以把每份文档的成果分别保存，后续汇总时读取这些成果；不必让所有文档全文、每次工具输出和修改过程一直留在同一段对话中。Anthropic 官方上下文管理实践
\n3. 阶段结束后，可以用新的上下文继续。
\n新会话先读取任务说明和最新交接记录，核对已有成果，再按需要读取材料。这样，后续工作通过文件和记录衔接，不必依赖一段无限增长的聊天历史。Anthropic 的长任务实践也采用分段推进、记录成果并让后续会话读取的方式。官方长任务实践
\n可以在项目指令中补充：
\n每个阶段只读取当前任务需要的资料，详细结果保存到成果文件。\n阶段结束时，更新进度记录，保留关键决定、依据位置和下一步。\n新会话开始后，先读取任务说明和最新进度，核对已有成果后再继续。\n摘要不能确定的事实，回到原始资料核对，不凭摘要补全。“24小时运行”解决的是持续可用和继续工作的条件。任务完成、没有新工作时可以等待；额度不足、工具故障或需要人工决定时仍可能暂停。下一节继续配置这些无人值守时的处理要求。
\n平时聊天时，Agent 可以随时追问，你也可以发现问题后立即纠正。无人值守时，需要提前决定：哪些问题可以按约定继续处理，哪些必须停下，停下后怎样把事情交回给你。
\n处理规则可以补充到现有任务提示词或持久指令中；使用 n8n 时，放在 AI Agent 的 System Message 中。权限、审批、超时等设置，则需要同时配置在软件或工具中。
\n1.1 已经介绍了缺少信息和材料冲突的处理。这里要补充的是：不能及时得到用户回答时，这次运行怎么收尾。
\n可以根据工作性质选择：
\n| 遇到的情况 | 适合的处理方式 | 需要写清楚的要求 |
|---|---|---|
| 缺少不影响事实和行动的偏好，例如排版样式 | 使用已经约定的默认值继续 | 默认采用什么，结果中是否注明 |
| 批量任务中，某一条记录缺少关键字段，其他记录互不依赖 | 跳过这一条，继续处理其余记录 | 保存记录编号、缺少什么、哪些内容未处理 |
| 缺少决定整体结果的资料，或无法确定操作对象 | 停止依赖这些信息的工作 | 保存已完成成果，列出需要补充的问题 |
| 需要用户选择方案，或者资料存在无法自行解决的矛盾 | 标记待决定，保留候选结果 | 说明选项、差异，以及下一步需要用户决定什么 |
例如，可以在原有指令后补充：
\n本任务无人值守运行，遇到问题时按以下规则处理：\n缺少表达或排版偏好时，使用已有默认要求继续，不为此等待。\n单条记录缺少关键材料时，记录编号和原因，跳过该条；仅继续处理不依赖它的记录。\n无法确认整体任务的依据或操作对象时，停止相关操作，保存已有结果并列出待补充问题。\n不要把未处理、待确认或失败的事项计入已完成数量。独立记录可以跳过，后续步骤依赖的关键资料则不能跳过。比如某个文件无法读取，可以继续整理其他独立文件；计算总数所需的一整份数据缺失时，就不能把不完整结果当作完整统计交付。
\n先检查本次任务实际需要哪些操作。例如，读取资料、生成草稿和正式发送消息，可以分别授权。只需要生成草稿时，可以不提供发送工具；只需要查询数据时，使用只读账号。这些限制应落实到工具、账号或服务端。
\n适合保留人工确认的情况包括：正式对外发送、修改重要业务记录、删除资料，以及超出预先约定范围的操作。
\n以 n8n 为例，可以给指定工具增加审批：
\n没有审批功能的助手，可以先生成草稿、操作清单或待处理记录，通知你回来继续。应写清楚“未收到确认时保持待处理，不执行该操作”。如果需要等待期限，也要规定超时后取消还是转交人工，不能把“用户没有回复”当作同意。
\n无人值守时，不要只写“失败后继续尝试”，要区分失败类型：
\n第三种情况尤其需要注意。例如发送请求超时，可能是消息没发出去，也可能已经发出但回执没回来。查不到结果时，应标为“结果待核实”，不要自动再发一遍。
\n在 n8n 中，可以打开节点的 Settings，为适合重试的操作配置 Retry On Fail，并限制重试次数与等待间隔。需要失败后停止整条流程时，使用 On Error → Stop Workflow；希望记录错误后继续独立工作时，选择 Continue (using error output)，把错误送到专门的处理分支。n8n 官方节点设置
\n继续执行的分支要明确处理错误，不能把失败输出继续当成正常材料。认证失效也不应靠反复重试解决。复杂恢复和重复处理防护，在后面的自动化章节展开。
\n需要检索、调用多个工具或处理大量记录的任务，先设置本次允许处理的数量，以及运行时间、尝试轮次和用量上限。数值按正常试跑的结果确定，给必要波动留余量，不存在适合所有任务的统一数值。
\n以 n8n 为例：
\n超时限制和 Agent 轮次限制分别控制整条工作流与 Agent 节点，不能相互替代；n8n Cloud 还受套餐允许的最大超时约束。官方工作流超时设置、Agent 轮次设置
\n达到上限时，报告已经完成和剩余的工作，不自动提高额度或扩大处理范围。进度按 3.2 的方法分阶段保存，避免等到平台强制超时后才尝试保存。
\n3.1 已经配置了结果保存位置。这里补充每次运行的状态要求：
\n例如，“报告已生成，但发送失败”应分别记录生成和发送的状态，而不是只报“已完成”。
\n通知可以按任务需要设置：正常完成按约定汇总，待确认和影响后续工作的失败及时通知；没有变化时，可以只保留运行记录。通知中放任务名称、问题摘要、成果或运行记录链接，以及需要你做的下一步。
\nWorkBuddy 的本地定时任务可以在 设置 → 通用 → 定时任务产物通知 中开启产物通知。已关联电脑的手机 App 也可以收到完成、待确认或失败通知。官方通知说明
\n使用 n8n 时，可以单独配置失败通知：
\n发布有三种类型：
\n这里需要查清两件事：谁有权决定发布，以及用了别人的哪些东西。
\n如果准备开放源码，让别人修改和分发，就需要选择许可证。没有许可证时，别人不能仅凭仓库公开，就认为自己获得了任意修改、分发的授权。GitHub 官方许可说明
\n下面四种许可证，主要区别在于：别人修改你的程序后，是否可以闭源，以及什么情况下必须提供源码。
\n如果你希望代码尽量容易被使用，接受别人基于它制作收费、闭源的产品，可以考虑 MIT。
\n例如，你用 MIT 发布 Agent 框架，别人改进后做成收费软件，只要履行保留声明等条件，MIT 允许这种做法。若你不能接受别人将修改版闭源，MIT 就不符合这个要求。MIT 许可证全文与说明
\n如果你同样接受别人制作闭源产品，但希望许可证明确处理贡献者的相关专利权，可以考虑 Apache-2.0。相比 MIT，它增加了这些具体规定：
\nNOTICE 文件时，还要按条款保留其中适用的署名内容。它允许修改版闭源，不要求把改进交回原作者。它相对 MIT 的主要特点是授权和声明规则更详细。Apache-2.0 官方条款第 3、4、6 节
\n如果你希望别人分发你的程序或受 GPL 约束的修改版时，仍然让接收者能够查看、修改和再分发源码，可以考虑 GPL-3.0。
\n这里的“对应源码”包括修改、构建和运行该程序所需的源码及相关脚本；并不自动扩大到同一公司的所有独立软件。判断与其他代码组合后哪些部分受约束，需要看实际组合方式。GPL-3.0 条款第 1、5、6 节
\n自己修改、自用，不因此必须发布。如果程序只在服务器上运行，用户通过网络使用而没有取得程序副本，仅凭这种网络交互，GPL 本身通常不要求把修改版源码提供给这些用户。这也是它与下面 AGPL 的关键区别。GPL-3.0 定义及第 2 节
\n如果你发布的是 Agent 服务端程序，希望别人修改后部署成网站或在线接口时，也向使用者提供修改版源码，可以考虑 AGPL-3.0。
\n它保留了 GPL 类似的分发要求，并增加了针对网络服务的要求：修改该程序后，如果用户能够通过网络与修改版交互，需要向这些用户醒目地提供免费取得该版本对应源码的方式。例如，在服务界面提供与线上版本对应的源码下载入口。
\n这意味着，别人不能仅以“用户没有下载程序，只是在网页上使用”为由，避开这项源码提供要求。它要求面向与修改版交互的用户提供获取机会，并不指定必须上传 GitHub。它也不因为服务器上运行了一个 AGPL 程序，就自动要求公开所有其他独立系统。AGPL-3.0 第 13 节及对应源码定义
\nAGPL 同样允许商业使用和收费服务；它约束的是源码获取与后续使用权，不是禁止别人靠它赚钱。AGPL-3.0 许可说明与全文
\n这些许可证都允许商业使用。若要求“禁止商用”，可以另行考虑相应的授权方式，但不应把它称为符合开放源代码促进会定义的开源许可。OSI 开源定义
\n在 GitHub 中添加许可证：
\nLICENSE，点击 Choose a license template。在本地项目中，也可以直接创建 LICENSE 文件，放入对应的完整许可文本。不要只写一句“本项目开源”，也不要自行删改许可条款后仍沿用原许可证名称。GitHub 官方添加许可证教程
发布在线助手时，把使用说明放在介绍页或入口附近，通常放在项目根目录的 README.md 中。
分享可复制的项目时，额外提供安装、配置和启动步骤。把 API Key、数据库密码等改成占位符，例如在 .env.example 中只保留变量名和填写说明；实际密钥放在部署平台的密钥或服务端环境变量设置中。