昨天OpenAI发布了全新的Function Calling指南，这次更新不仅让文档缩短了50%，还带来了一些重要的最佳实践。作为Agent的核心能力之一，Function Calling的正确使用对于构建强大的AI Agents应用至关重要。所以今天给家人们分享一下这次更新的重点内容！
Function Calling的两大核心应用
文中明确指出，Function Calling主要有两个核心应用场景：
获取数据（Fetching Data）
检索最新信息并整合到模型响应中 适用于搜索知识库和获取特定API数据（如天气数据） 本质是一种RAG（检索增强生成）的实现方式 执行动作（Taking Action）
提交表单、调用API 修改应用状态（前端/后端） 执行Agent工作流动作（如对话交接） 写清晰的函数定义
全新的最佳实践
这次更新最重要的是提供了一系列实用的最佳实践，让我们重点来看几个：
#好的示例
defget_weather(location:str):
"""获取指定位置的当前温度
Args:
location:城市和国家，例如：'北京, 中国'
"""
pass
#糟糕的示例
deftoggle_light_switch(on:bool,off:bool):
"""这个设计允许无效状态的存在"""
pass
应用软件工程最佳实践
让函数直观且符合最小惊讶原则（维基百科上叫：Principle of least astonishment, https://en.wikipedia.org/wiki/Principle_of_least_astonishment） 使用枚举和对象结构，避免无效状态 通过"实习生测试"：如果一个实习生只看函数定义就能正确使用，说明设计的不错
尽可能减轻模型负担
#不推荐
defget_orders(user_id:str):
pass
#推荐
defget_orders():
#在代码中传递user_id
pass
保持函数数量精简
建议同时使用的函数不超过20个 如果发现两个函数总是一起调用，考虑合并它们
重要的配置选项
工具选择模式（tool_choice）
#自动模式（默认）
tool_choice="auto"#可以调用零个、一个或多个函数
#强制模式
tool_choice="required"#必须调用至少一个函数
#指定函数
tool_choice={
"type":"function",
"function":{"name":"get_weather"}
}#强制调用特定函数
严格模式（Strict Mode）
{
"type":"function",
"function":{
"name":"get_weather",
"strict":True,#启用严格模式
"parameters":{
"type":"object",
"properties":{
"location":{
"type":"string"
},
"units":{
"type":["string","null"],#可选参数
"enum":["celsius","fahrenheit"]
}
},
"required":["location","units"],
"additionalProperties":false
}
}
}
流式处理的支持
OpenAI还优化了流式处理的支持，让你能实时展示函数调用的过程：
stream=client.chat.completions.create(
model="gpt-4o",
messages=[{"role":"user","content":"北京今天天气如何？"}],
tools=tools,
stream=True
)
forchunkinstream:
delta=chunk.choices[0].delta
print(delta.tool_calls)#实时显示函数调用进度
最后
这次的更新，主要是提供了一些的最佳实践。随着o1-mini即将支持Function Calling（官方确认），昨天还开始发布了tasks的功能，可以期待在2025年看到真正的Agents