Dart开发者福音：自动生成LLM工具Schema的代码生成器

tool_schema_generator让Dart开发者告别手写JSON Schema的繁琐工作，通过注解即可自动生成兼容OpenAI、Anthropic、Gemini的LLM工具定义。

• 原作者/维护者: joedexdev
• 来源平台: GitHub
• 原始标题: tool_schema_generator
• 原始链接: https://github.com/joedexdev/tool_schema_generator
• 发布时间: 2026-06-04

---

在构建AI Agent时，开发者经常需要为大型语言模型（LLM）提供可调用的工具（函数）定义。这些定义通常以JSON Schema格式呈现，描述工具的参数、类型和用途。然而，手动编写和维护这些Schema既繁琐又容易出错，尤其是当工具数量增加或参数发生变化时。

对于Dart开发者来说，这个问题尤为突出。Dart作为一种强类型语言，其类型系统本应为Schema生成提供天然优势，但过去缺乏一个能够充分利用这一优势的自动化工具。tool_schema_generator正是为了解决这一痛点而诞生的。

---

tool_schema_generator是一个Dart代码生成器，它能够从带注解的Dart函数自动生成符合JSON Schema Draft 2020-12标准的工具定义。该项目的主要特性包括：

该工具能够直接从Dart语法中推断类型、名称和可空性，无需开发者编写额外的映射代码。这意味着你可以专注于编写业务逻辑，而让生成器处理繁琐的Schema转换工作。

支持String、int、double、bool、List、Map、枚举类型以及自定义嵌套类。这种全面的类型覆盖确保了复杂的Dart数据结构能够被准确地转换为JSON Schema。

这是该工具最引人注目的特性之一。它能够从相同的Dart函数生成OpenAI、Anthropic和Gemini三种主流LLM平台所需的工具Schema格式。开发者无需为不同平台维护多套Schema定义。

使用标准的source_gen构建器，输出到.g.dart文件，可以与json_serializable等其他代码生成器完美协作。这种设计选择使得它能够融入现有的Dart项目工作流。