首页
/ Ollama工具定义中数组参数类型的扩展支持

Ollama工具定义中数组参数类型的扩展支持

2025-04-26 14:41:47作者:江焘钦

在Ollama项目的工具定义机制中,开发者发现当前的工具语法存在一个关键限制:无法完整描述数组类型参数的元素结构。这一问题在需要处理复杂数据结构的场景下尤为突出。

传统JSON Schema规范允许通过items字段定义数组元素的类型和结构。例如,当定义一个包含样本列表的工具时,开发者需要明确每个样本对象的结构(如样本名称、质量等属性)。然而在现有实现中,Ollama服务端会剥离items字段,导致工具定义丢失关键的类型信息。

技术实现层面,这个问题源于工具定义解析器未完全实现JSON Schema规范。当客户端发送包含嵌套结构的工具定义时(如下示例),服务端日志显示items定义被移除:

{
  'type': 'array',
  'items': {
    'type': 'object',
    'properties': {
      'sample_name': {'type': 'string'},
      'mass': {'type': 'integer'}
    }
  }
}

这种限制会影响以下典型场景:

  1. 需要处理对象数组的自动化流程
  2. 需要严格类型校验的科研分析工具
  3. 需要生成结构化响应的AI代理

解决方案已在相关PR中提出,主要改进包括:

  • 完整保留JSON Schema的items定义
  • 支持嵌套对象类型的数组元素描述
  • 确保类型信息在工具调用时可用

对于开发者而言,这意味着可以构建更精确的工具契约。例如在生物信息学场景中,现在可以明确定义:

  • 样本列表中的每个元素必须包含字符串类型的样本ID
  • 必须包含数值类型的质量参数
  • 可选包含其他元数据字段

这种改进使得Ollama的工具系统能够更好地支持复杂业务逻辑,同时保持与标准JSON Schema的兼容性。对于新用户,建议在定义工具时参考完整的JSON Schema规范,充分利用类型系统提供的表达能力。

未来可能的扩展方向包括:

  • 支持数组元素的联合类型
  • 添加自定义验证规则
  • 实现更丰富的文档注释功能
登录后查看全文
热门项目推荐
相关项目推荐

项目优选

收起
kernelkernel
deepin linux kernel
C
24
6
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
267
2.54 K
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
1.02 K
434
pytorchpytorch
Ascend Extension for PyTorch
Python
98
126
flutter_flutterflutter_flutter
暂无简介
Dart
557
124
fountainfountain
一个用于服务器应用开发的综合工具库。 - 零配置文件 - 环境变量和命令行参数配置 - 约定优于配置 - 深刻利用仓颉语言特性 - 只需要开发动态链接库,fboot负责加载、初始化并运行。
Cangjie
54
11
IssueSolutionDemosIssueSolutionDemos
用于管理和运行HarmonyOS Issue解决方案Demo集锦。
ArkTS
13
23
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.02 K
604
cangjie_compilercangjie_compiler
仓颉编译器源码及 cjdb 调试工具。
C++
117
93
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
9
1