SuperAPI AI 工具集

docs-code-samples

智能体与模型

查看项目

更新于 10-15 23:48

技能介绍

用途:把 LangChain 文档 MDX 中的内联 Python、TypeScript/JavaScript、Java 等代码块迁移到 src/code-samples/ 下的独立可测试文件,再由脚本提取为 Mintlify 片段供文档引用。

主要能力:按产品分目录(langchain、langgraph、deepagents、langsmith);用 :snippet-start:/:snippet-end: 标记文档可见代码,用 :remove-start:/:remove-end: 包裹仅测试用的代码;片段名需带语言后缀(-py、-js、-java、-kt、-go、-sh);生成脚本会把含 model 字符串的片段展开为 Mintlify CodeGroup 的多个提供商标签页。

使用方式:创建代码文件并加标记;运行 make test-code-samples(可加 FILES="路径")验证,Java 用 jbang、Go 用 go run、Bash 用 bash 执行;运行 make lint 与 make format;运行 make code-snippets(LangSmith JVM 可用 make code-snippets-langsmith)生成 src/snippets/code-samples/ 下的 MDX;在 MDX 中 import 组件并替换内联代码块。

适用场景:文档代码示例迁移、可运行示例维护、多语言片段生成。

限制:测试须真正执行片段,不得在片段前提前退出;不要 mock LangChain 内部或使用假聊天模型;TypeScript 在导入或顶层绑定冲突时需拆分文件;Go 与 Bash 每个变体单独文件;Java 需打印输出并在缺少可选密钥时成功退出。其余细节暂未提供。