扣子入门篇——从零建一个“工作日志精灵”Age
1.1 这个项目做什么
目标:创建一个 Agent,用户输入当天零散的工作记录(如“上午开了需求评审会,下午改了三个 bug,晚上写了周报”),Agent 输出结构化的工作日志,包含:今日完成事项(分点)、耗时预估、遗留问题、明日建议。输出格式固定,可直接粘贴到日报系统。
这个项目虽小,但覆盖了 Agent 使用的核心环节:人设设定、提示词约束、插件挂载、预览调试。做完这一个,你对“提示词如何影响输出稳定性”会有直观感受。
1.2 创建 Agent 与配置人设
登录扣子后,在 Agent 区域点击“+”。如果你有明确的垂直场景,可以先看行业模板是否有接近的;这个项目选择“定义专属 Agent”,名称填“工作日志精灵”,描述写“将零散工作记录整理为结构化日志”。
进入编辑页后,核心工作在“人设与回复逻辑”文本框里。不要写“你是一个 helpful assistant”这种空话,要按角色 + 任务 + 输出格式 + 行为约束四段式来写:
text
角色 你是一名严谨的职场效率助手,擅长从零散口述中提取工作项并结构化输出。 任务 用户会输入当天的工作流水账。你需要: 1. 提取所有明确完成的事项,按重要性降序排列 2. 对每项给出耗时估算(单位:小时,保留一位小数) 3. 识别用户提到的“没做完”“卡住了”的内容,归入遗留问题 4. 基于遗留问题,给出不超过3条明日优先建议 输出格式 严格按以下 Markdown 结构输出,不要添加额外段落: 今日完成 - 事项 | 预估耗时 遗留问题 明日建议
行为约束里必须加一条:“如果用户输入中完全没有工作相关内容,回复‘未识别到有效工作记录,请重新输入’并停止。” 这条约束在调试时能防止 Agent 对闲聊也硬凑出一份日志。
1.3 挂载插件与调试
这个项目暂时不需要插件(纯文本处理),但建议挂上“联网搜索”备用,后续可以扩展“查询行业资讯并附在日志末尾”的能力。插件的作用是给 Agent 装“手脚”。
调试时不要只输入一次就下结论。打开右侧预览窗口,依次测三类输入:
-
正常输入:“上午 10 点到 11 点半对齐了支付流程,下午修了订单列表的排序 bug,花了 1 小时。还有一个优惠券叠加的问题没搞定,等后端确认。”
-
边界输入:“今天好累。” → 预期 Agent 回复未识别到有效记录
-
混杂输入:“中午吃了拉面,下午开了个会,大概半小时,讨论了下个季度的排期。”
重点看输出格式是否稳定。如果 Agent 在“今日完成”里把“吃拉面”也写进去,说明提示词中“工作事项”的边界不够清晰,需要补充排除规则:“社交、用餐、休息等非工作内容不计入完成事项。”
一个常见坑:Agent 有时会自行添加“总结”段落。如果输出格式不符合 Markdown 结构,把提示词里的“不要添加额外段落”改成更硬的指令:“输出必须以‘## 今日完成’开头,以‘## 明日建议’下的最后一条建议结尾,前后不得有任何其他文字。”
完成调试后,这个 Agent 可以直接在扣子预览页使用,也可以先不发布,留到第三篇学完发布流程后再推送到飞书给自己用。github.0voice
更多推荐


所有评论(0)