《Agent Runtime 工程化》第四章 工具系统设计：4.2 Schema：从 Zod 到 JSON Schema

书名：《Agent Runtime 工程化：从工具调用循环到可恢复执行系统》

作者：陈堂会

章节：第四章 工具系统设计 / 4.2 Schema：从 Zod 到 JSON Schema

电子版系列：查看完整目录

第四章 工具系统设计：4.2 Schema：从 Zod 到 JSON Schema

TypeScript 生态里，Zod 常用于运行时校验；模型和协议层常使用 JSON Schema。工程上可以用 Zod 编写工具输入，再转换为 JSON Schema 提供给模型或 MCP。

import { z } from "zod";

const SearchCodeInput = z.object({
  query: z.string().min(1).describe("Search query, preferably ripgrep syntax"),
  path: z.string().default("."),
  maxResults: z.number().int().min(1).max(100).default(50),
});

const searchCodeTool = {
  name: "search_code",
  description: "Search text in the workspace using ripgrep.",
  inputSchema: SearchCodeInput,
  :   ,
   () {
     args = .(input);
     ctx..(args);
  },
};