实用提示：每位软件工程师都应使用的4个实用AI智能体

本指南将逐步构建从原材料到可运行系统的完整流程，内容涵盖：每位软件工程师都应使用的4个实用AI智能体。重点在于可操作的步骤、明确的检查点，以及无需猜测意图即可直接放入代码仓库的代码。 在概览阶段，应在修改代码之前明确输入参数、各步骤的负责人以及完成标准。操作人员应能够从已知的检查点重新运行相应步骤，而无需猜测隐藏的状态。 除了功能结果外，还需记录执行时间以及令牌或查询成本。提前了解成本情况，可避免在流程从演示环境过渡到共享环境时出现意外费用。

我们并不需要更快的打字速度。

在处理“我们不需要”阶段时，首先写下相关契约：所需的输入参数、成功信号以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 将配置信息与应用程序代码分开存放。环境文件、密钥存储以及功能开关应集中于一个位置，这样操作人员无需查看整个系统结构即可进行审计。 在耗时较高的步骤之后设置检查点。当操作人员重新尝试后续节点时，恢复流程不应再次调用相同的大型语言模型。

Human
   │
   ▼
Ask Question
   │
   ▼
AI gives Answer

Task
  │
  ▼
Think
  │
  ▼
Take Action
  │
  ▼
Check Result
  │
  ▼
Improve
  │
  ▼
Return Final Output

代理1：协调代理

在处理 Agent 1 的协调阶段时，首先写下相关契约：所需的输入参数、成功信号以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 同时记录正常流程和故障恢复流程。重试机制、人工审核环节以及死信处理都是产品本身的组成部分，而非后续需要补充的功能。 在成本较高的步骤之后设置检查点。当操作员重新尝试某个节点时，恢复流程不应再次调用相同的大型语言模型。

Good Morning 👋

Urgent Emails (3)
------------------
✓ Client waiting for reply
✓ Production alert
✓ Interview confirmation

Information (9)
------------------
• Weekly newsletter
• Team updates
Ignore (14)

------------------
Marketing emails

Calendar Conflict
Meeting: 2 PM
Deployment: 2:30 PM
⚠ High Risk

真正有效的提示词结构

在处理“A提示结构”阶段时，首先需明确相关约定：所需输入、成功标志以及部分失败时的处理方式。这份清单能确保后续的代码修改保持一致性。 优先选择小型、可测试的单元，而非庞大的脚本。当某个步骤失败时，故障应指向单一责任模块，而非复杂的流程链。 缓存稳定的系统指令和工具结构。重复发送相同的开头信息是导致资源浪费的常见原因。 在处理“A提示结构”阶段时，首先需明确相关约定：所需输入、成功标志以及部分失败时的处理方式。这份清单能确保后续的代码修改保持一致性。 在功能结果旁记录执行时间以及代币或查询成本。提前了解成本情况，可避免在从演示环境过渡到共享环境时出现意外账单。

Summarize my emails.

Role:
Executive Assistant
Task:
Review unread Gmail emails.
Categories:
- Urgent
- Information
- Ignore
Output:
Summarize each category.
Draft replies for urgent emails.
Boundary:
Never send any email without my approval.

从小处着手

将“从小规模开始”阶段视为可度量的对象来处理效果最佳。在扩大范围之前，先记录一份优秀的案例、一个失败案例以及回滚说明。 将配置与应用程序代码分开。环境文件、密钥存储和功能标志应集中存放于一处，这样操作人员无需查看整个结构就能进行审计。 保持数据结构的层次简单且类型明确。嵌套的数据块会掩盖哪个节点修改了哪个字段的信息，还会在出现中断后导致流程无法继续。

Observe
↓
Organize
↓
Suggest
↓
Automate
↓
Delegate

代理2：创意型代理

将《Agent 2：创造力阶段》视为可测量的对象来处理时效果最佳。在扩大范围之前，先记录一个成功的案例、一个失败案例以及回滚说明。 同时记录正常流程和恢复流程。重试机制、人工审核环节以及死信处理都是产品本身的一部分，而非后续的优化工作。 保持图表状态简洁且类型明确。嵌套的数据块会掩盖哪个节点编写了哪个字段的信息，还会在中断后导致流程无法继续。

• Increase revenue
• Reduce infrastructure cost
• New pricing
• Investors meeting Friday

AI会放大你给予它的一切

将 AI Multiplies Whatever You stage 视为可度量的界面来使用效果最佳。在扩大范围之前，先记录一份理想的运行日志、一个故障案例以及回滚说明。 优先选择小型且可测试的单元，而非庞大的脚本。当某一步骤出错时，故障应能指向单一责任主体，而非复杂的流程链。 保持图结构的状态简洁且具有类型定义。嵌套的数据块会掩盖哪个节点修改了哪个字段的信息，还会在进程中断后导致无法继续运行。 将 AI Multiplies Whatever You stage 视为可度量的界面来使用效果最佳。在扩大范围之前，先记录一份理想的运行日志、一个故障案例以及回滚说明。 在功能结果旁同时记录执行时间以及令牌或查询成本。提前了解成本情况，可避免在从演示环境过渡到共享环境时出现意外费用。

Write documentation.

Audience:
Backend developers
Goal:
Explain Redis caching.
Reading time:
5 minutes
Include:
Code example
Common mistakes
Architecture diagram

Agent 3：清晰度代理

在 Agent 3 的“清晰度”阶段，应在修改代码之前明确输入参数、该步骤的负责人以及结束标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 配置信息应置于应用程序代码之外。环境文件、密钥存储以及功能标志应集中存放于一个位置，这样操作人员无需查看整个系统结构即可进行审核。 对于涉及资金支出或修改生产数据的操作，必须经过人工审批。编译时的连接方式并不等同于业务功能的完整性。

Extract:
• Deadlines
• Hidden fees
• Responsibilities
• Risks
• Questions I should ask

望远镜模式与显微镜模式

在更改代码之前，需明确望远镜模式与显微镜模式下的输入参数、该步骤的负责人以及结束标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 需同时记录正常流程与异常恢复流程。重试机制、人工审核环节以及错误处理都是产品不可或缺的部分，而非后续需要补充的内容。 对于涉及资金支出或更改生产数据的操作，必须经过人工审批。仅靠编译时的配置并不能保证业务的完整性。

望远镜模式

在“望远镜模式”阶段，修改代码之前需明确输入参数、该步骤的负责人以及终止条件。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 优先选择小型、可测试的单元，而非冗长的脚本。当某个步骤失败时，故障应指向单一责任点，而非复杂的流程链。 对于涉及资金支出或修改生产数据的操作，必须经过人工审批。编译时的逻辑连接并不等同于业务功能的完整性。 在“望远镜模式”阶段，修改代码之前需明确输入参数、该步骤的负责人以及终止条件。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 除了功能结果外，还需记录执行时间以及令牌或查询成本。提前了解成本情况，可避免在流程从演示环境转向共享环境时出现意外账单。

显微镜模式

在使用显微镜模式处理任务时，首先列出相关要求：所需输入、成功信号以及部分失败时的处理方式。这样的清单能确保后续的代码修改不会出错。 将配置信息置于应用程序代码之外。环境文件、密钥存储以及功能开关应集中存放，这样操作人员无需查看整个系统结构即可进行审核。 在耗时较高的步骤之后设置检查点。当操作人员重新执行后续节点时，恢复流程不应再次调用相同的大型语言模型。

一个改善结果的微小习惯

在处理“一个微小习惯”阶段时，首先写下相关约定：所需的输入、成功标志以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 同时记录正常流程和异常恢复流程。重试机制、人工审核环节以及死信处理都是产品本身的一部分，而非后续的优化工作。 在成本较高的步骤之后设置检查点。当操作员重新尝试某个后续节点时，恢复流程不应再次调用相同的大型语言模型。

智能体4：辅导型智能体

在完成“Agent 4 教学”阶段时，首先需写明契约内容：所需输入、成功标志以及部分失败时的处理方式。这样的清单能确保后续的代码修改保持透明。 建议使用小型、可测试的单元，而非庞大的脚本。当某一步骤失败时，故障应指向单一责任点，而非复杂的流程链。 在成本较高的步骤之后设置检查点。当操作员重新尝试后续节点时，恢复流程不应再次调用相同的LLM接口。 在完成“Agent 4 教学”阶段时，首先需写明契约内容：所需输入、成功标志以及部分失败时的处理方式。这样的清单能确保后续的代码修改保持透明。 在功能结果旁记录执行时间以及token或查询成本。提前了解成本情况，可避免从演示环境过渡到共享环境时出现意外收费。

简单对比

“简单对比”阶段若被视为可度量的对象，效果最佳。在扩大范围之前，先记录一份成功的案例、一个失败案例以及回滚说明。 将配置与应用程序代码分开。环境文件、密钥存储和功能标志应集中存放于一处，这样操作人员无需查看整个结构即可进行审计。 保持数据结构的层次简单且类型明确。嵌套的数据块会掩盖是哪个节点修改了哪个字段，还会在出现中断后导致无法继续处理。

AI工具重要吗？

将AI工具的流程视为可度量的界面时，其效果最佳。在扩大范围之前，先记录一个成功的案例、一个失败案例以及回滚说明。同时记录正常流程和恢复流程。重试机制、人工审核环节以及错误处理都是产品本身的一部分，而非后续需要补充的内容。应提供具有明确结构定义和清晰副作用标签的工具，这样主机在自动批准之前就能知道哪些调用会改变状态。

有一件事绝不能立即自动化

将“唯一需要上架的功能”视为可度量的对象来处理时，其效果最佳。在扩大范围之前，先记录一份完美的操作日志、一个故障案例以及回滚说明。 相较于庞大的脚本，应优先选择小型且可测试的单元。当某个步骤出现故障时，故障点应指向单一责任模块，而非复杂的流程链。 保持图表状态简洁且具有类型定义。嵌套的数据结构会掩盖哪个节点修改了哪个字段的信息，还会在流程中断后导致无法继续执行。 将“唯一需要上架的功能”视为可度量的对象来处理时，其效果最佳。在扩大范围之前，先记录一份完美的操作日志、一个故障案例以及回滚说明。 除了功能结果外，还需记录执行时间以及令牌或查询成本。尽早了解成本情况，就能避免在从演示环境过渡到共享环境时出现意外费用。

值得思考的一个问题

在“值得思考的问题”阶段，应在修改代码之前明确输入参数、该步骤的负责人以及结束标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 配置信息应置于应用程序代码之外。环境文件、密钥存储以及功能开关应集中存放，以便操作人员无需查看整个流程即可进行审计。 对于涉及资金支出或修改生产数据的操作，必须经过人工审批。编译时的连接方式并不等同于业务流程的完整性。

总结

在“最终思考”阶段，应在修改代码之前明确输入参数、该步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 需同时记录正常流程和异常恢复路径。重试机制、人工审核环节以及错误处理都是产品本身的组成部分，而非后续需要补充的内容。 对于涉及资金支出或修改生产数据的操作，必须经过人工审批。编译时的连接方式并不等同于业务功能的完整性。

操作检查清单

将“操作检查清单”阶段视为可衡量的工作面，能更有效地推进工作。在扩大范围之前，需记录一份最佳操作范例、一个故障案例以及回滚说明。 应将此阶段视为输入参数与已验证输出结果之间的契约。为相关文档命名，明确成功标准，杜绝默许的不完整处理方式。

保持图状态扁平且具有类型约束。嵌套的二进制数据会隐藏是哪个节点修改了哪个字段，还会在中断后导致程序无法继续运行。

只要预算允许，就在持续集成过程中使用测试用例而非真实的付费 API 来执行关键路径的冒烟测试。

在功能结果旁记录执行时间以及令牌或查询成本。提前了解成本情况，可避免在从演示环境过渡到共享环境时出现意外账单。

保持图状态扁平且具有类型约束。嵌套的二进制数据会隐藏是哪个节点修改了哪个字段，还会在中断后导致程序无法继续运行。

在升级技术栈之前，先冻结现有版本，为关键路径生成标准化的测试记录，并确认回滚步骤。共享环境需要设置速率限制、进行租户身份验证，同时明确负责密钥轮换的人员。与其追求花哨的一次性演示，不如注重扎实的可靠性。

58b3122fafab的批处理说明：不要将提供者密钥放入仓库中，设定单会话令牌上限，并将转录内容存储在评估测试用例的旁边，以便后续模型更换时仍能保持可比性。