我们如何让文档自己测试自己
这件事讲了什么
LangChain 团队把文档里的示例代码变成 CI 可自动测试的代码,方法是用 Deep Agents CLI 这个命令行智能体,配上预先写好的技能(类似给同事的步骤说明),让智能体自动把文档里的内联代码抽成独立文件、补全可运行的环境、加标记、跑测试,再嵌回文档。原来这些示例是静态的,API 或依赖一变就悄悄失效,而手动改造又太费工,所以很多团队干脆不做。现在只需在文档仓库里对智能体说一句“把某个文件里的内联代码迁移成可测试的示例”,它就会照技能执行,再配合 GitHub Action 定期跑测试并在失败时开单。这一做法目前是 LangChain 团队自用的示例,Deep Agents CLI 可查看官方文档试用,技能脚本需自己在仓库中配置,并非开箱即用的成品服务。
可以使用的工具
文中可用工具
- Deep Agents CLI一个命令行智能体,可用对话方式让它按技能说明自动完成文档代码迁移等任务
- Skills可复用的步骤说明文件,智能体在任务匹配时加载并照做
- Bluehawk根据标记从代码中抽取片段的工具,生成可嵌入文档的代码片段
- Mintlify文档平台,接收生成的代码片段作为文档内嵌内容
- GitHub Action定期自动运行代码示例测试,并在失败时创建工单
讨论 0
登录后参与讨论,阅读资讯无需注册。
还没有评论,来分享第一个看法。