ARTICLE · 1363642
Agent 学习第 76 课:项目:模板化 Agent
Agent 学习第 76 课:项目:模板化 Agent
我这套 Agent 课写到第 76 课,终于把脚手架落地了。
以前每建一个新项目,都得从手写 while 循环开始。目录各写各的,审批、重试、日志反复补洞,评测也没法复用。所以这次不搭黑盒框架,只做一个可 fork 的最小模板——把目录、初始化脚本、主循环和工具注册表固定下来。
目录拆得很清楚:loop 管主循环,tools 管工具,config 管配置,hitl 管高危审批,logging_trace 统一 run_id。业务不进 agent/,全塞进 skills/。CLI 提供 doctor 和 init-check,检查 API Key、工具 schema、审批门。
主循环就做三件事:调模型、走审批、写 trace。高风险操作必须人工确认,日志每条都带 run_id,多用户并发也不乱。
最容易踩的坑是模板越做越大。一默认拉 RAG、向量库,hello-world 就得起三个服务。还有工具改字段不升版本,回归集直接全红;审批门默认关掉,生产环境连 shell 都敢自动执行。
脚手架不是替你写业务,是把目录、安全、日志先立住。fork 一下就能接 cron 巡检和 CI 门禁。















































































