add-agent-playbooks

添加 Agent Playbook

让现有 Python Agent 完成一次经验证、由 Playbook 支持的对话轮次，然后完成所请求的内容迁移或集成。FAQ 提供已发布的答案；Skill 提供独立加载、不会显示在发现预览中的操作流程。应用负责管理响应策略、工具权限以及操作审批。

1. 明确方向并选择行为

找到模型调用、工具注册、框架/版本，以及现有的策略或操作流程来源。保留现有图结构、业务工具，以及全局响应/授权规则。根据请求和代码推断以下决策；仅针对尚未解决的选择提问，并说明所采用的默认值：

决策	结果
哪些重复任务需要操作流程？	每项操作流程对应一个 Skill；若没有则跳过。将针对特定任务的工具指引移出提示词。
哪些问题需要经过审批的答案？	每个经过审批的答案对应一个 FAQ；若没有则跳过。
哪些受众会使用这些内容？	单一受众：不使用属性或筛选条件。多个受众：在内容中设置匹配的属性，并使用可信的运行时受众信息。
是否应将未覆盖的答案提交审核？	默认否。若是：选择自动提交未覆盖内容建议，或由应用管理质量/隐私审核关卡；保留现有审核关卡。
这些内容目前存放在哪里？	将相关提示词文本、文档或检索内容转换为带版本的文件。保留权威来源。

如果 Agent 可以执行工具，优先采用渐进式披露；否则使用基于评分的钩子。定义澄清、升级处理和服务中断时的行为：仅允许使用经过审批的答案时，必须明确规定内容不足时的策略。

2. 检查前提条件并连接

按照 配置 中的说明，简要检查前提条件，并完成新建、部分配置或现有配置的设置。复用可用的配置和已发布内容。本地默认配置要求有正在运行的堆栈；Cloud 和自托管管理使用不同的方式。

编辑前，先根据已安装的版本检查框架 API。使用可用的文档 MCP。使用 CLI 时，运行 iris agent-playbooks <command> --help。如果文档与已安装的 API 不一致，请检查已安装软件包的源码。报告尚未解决的兼容性问题。

3. 发布首批相关内容

按照 内容编写 中的说明，了解文件格式、质量检查、受众属性、验证、预览和发布。先创建一个与所请求任务相关且经过审批的 FAQ 或操作流程；仅在必要时两者都创建。将 Agent 接入前，确认其服务版本。首轮对话正常运行后，再完成其他已请求的大范围迁移。

4. 与应用集成

按照 运行时集成 中的说明，了解所选模式、异步变体和框架中的放置位置。创建一个已配置的上下文对象，并在整个流程中使用它。每轮都从基础提示词重新构建上下文。将披露工具同时注册到模型和执行器中。

5. 运行、检查并改进

按照 首次成功 中的说明：运行实际应用，检查内容键/版本和操作流程加载情况，测试同义改写问题以及内容缺失时的行为，修复发现的问题，然后重新运行。向用户展示已成功运行的内容及重复操作的方法。替换后的读取流程正常工作后，删除已过时的运行时提示词/检索器/缓存代码及未使用的嵌入流程；针对最终集成运行受影响的应用检查。

6. 交接并维护

使用 首次成功 中的交接说明，区分已观察到的结果与尚未验证的工作，并提供可准确重复的命令。说明如何进行下一次已审批的内容更新，指出内容负责人/发布者，以及任何尚未完成的部署配置。

必要约束与可选路径

• 每条 iris 命令都使用根选项 --json --no-input。CLI 用于管理和内容管理；Python SDK 在应用内部运行。
• 将运行时 .env 凭据与 .env.content 发布凭据及管理令牌分开。授予 Agent read 权限；仅在提交内容时才添加 propose 权限。切勿打印密钥或提交环境文件。
• 发布操作决定提供服务的内容。提案是待审核的候选内容；提交或接受提案不会自动发布内容。
• 如需语义响应缓存，请先阅读缓存迁移，再替换其查找／写入路径。
• 如需从 Agent Memory 创建后台提案，请先阅读Memory 提取，再启用其他提交路径。