LLM Workflow Engine 项目中的函数调用迁移指南

在LLM Workflow Engine项目中，随着OpenAI API的更新，函数调用(function calling)的配置方式发生了变化。本文将详细介绍如何将原有的函数调用配置迁移到新的工具(tools)配置语法。

配置变更概述

OpenAI API从函数调用模式升级为更通用的工具调用模式，这一变化带来了配置方式的调整。在LLM Workflow Engine项目中，主要体现在两个关键配置项的迁移：

1. 函数列表迁移：原先在model_kwargs下的functions数组现在直接移至model_customizations下的tools数组
2. 函数选择迁移：原先的function_call配置项更名为tool_choice并提升到model_customizations层级

新旧配置对比

旧版配置示例

在旧版本中，函数调用的配置位于model_kwargs下：

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

迁移注意事项

1. 层级简化：新配置消除了model_kwargs这一中间层级，使配置结构更加扁平化
2. 命名变更：function_call更名为tool_choice，反映了OpenAI API从专用函数调用到通用工具调用的演进
3. 兼容性考虑：虽然语法变更，但功能上保持了向后兼容，原有函数定义无需修改

技术背景

OpenAI将函数调用升级为工具调用的设计，是为了支持更广泛的外部能力集成。工具调用不仅包含了原有的函数调用能力，还可以支持：

• 多种类型的工具集成
• 更灵活的工具选择策略
• 未来可能扩展的其他交互方式

这一变更使得LLM Workflow Engine能够更好地适应OpenAI API的演进，同时为用户提供更清晰的配置方式。

总结

对于LLM Workflow Engine用户而言，迁移到新的工具调用配置非常简单。只需将原有的functions和function_call配置项移动到新的位置并重命名即可。这一变更不仅简化了配置结构，也为未来可能的功能扩展奠定了基础。