ChatGPT-Wrapper项目中的函数调用迁移至工具配置指南

在ChatGPT-Wrapper项目的更新中，一个重要的变化是将原有的OpenAI函数调用配置迁移到了新的工具配置语法。这一变化反映了OpenAI API的演进方向，也为开发者提供了更清晰、更一致的配置方式。

配置迁移的核心变化

迁移主要涉及两个关键配置项的路径调整：

1. 函数列表迁移：原先位于model_customizations -> model_kwargs -> functions的函数列表，现在直接移动到model_customizations -> tools路径下。

2. 函数调用指定迁移：原先的model_customizations -> model_kwargs -> function_call配置，现在改为model_customizations -> tool_choice。

新旧配置对比

旧版配置示例：

metadata:
  name: gpt-4-function-test
  provider: chat_openai
model_customizations:
  model_kwargs:
    functions:
      - test_function
      - test_function_2
    function_call:
      name: test_function

新版配置示例：

metadata:
  name: gpt-4-function-test
  provider: chat_openai
model_customizations:
  tools:
    - test_function
    - test_function_2
  tool_choice: test_function

技术背景与优势

这一变更不仅仅是简单的路径调整，它反映了OpenAI API从"函数调用"到"工具"概念的演进。工具是一个更通用的概念，可以包含函数调用、插件等多种扩展能力。

新配置的优势包括：

1. 结构更清晰：工具配置不再嵌套在model_kwargs下，直接作为顶级配置项
2. 语义更明确：使用"tools"和"tool_choice"更准确地表达了这些配置的用途
3. 扩展性更好：为未来可能添加的其他工具类型预留了空间

迁移注意事项

1. 确保在迁移后测试所有函数调用功能是否正常工作
2. 检查是否有自定义的函数调用逻辑需要相应调整
3. 注意新配置不再需要嵌套在model_kwargs下
4. 工具选择(tool_choice)的语法更简洁，直接指定工具名即可

这一变更虽然简单，但对于保持项目与最新API标准的同步非常重要。开发者应尽快完成配置迁移，以确保获得最佳的功能支持和未来的兼容性。