Firebase iOS SDK中多函数调用的正确响应方式

理解函数调用机制

在Firebase iOS SDK的VertexAI组件中，当使用支持多函数调用的模型（如gemini-1.5-flash-002）时，开发者可能会遇到函数响应处理的问题。核心问题在于如何正确处理模型在一次交互中发出的多个函数调用请求。

问题现象

当模型在一次交互中返回多个函数调用请求时，常见的错误处理方式是：

1. 将多个函数响应分别放入不同的ModelContent对象中发送
2. 或者尝试分多次发送这些响应

这两种方式都会导致后端返回400错误，提示"请确保函数响应轮次紧跟在函数调用轮次之后，并且函数响应部分的数量应与函数调用轮次的函数调用部分数量相等"。

解决方案

正确的处理方式是将所有函数响应合并到同一个ModelContent对象中发送。具体实现如下：

let functionResponse1 = FunctionResponsePart(name: "getExchangeRate", response: apiResponse1)
let functionResponse2 = FunctionResponsePart(name: "getExchangeRate", response: apiResponse2)

let result = try chat?.sendMessageStream([
    ModelContent(role: "function", parts: [functionResponse1, functionResponse2])
])

实现细节

1. 单一ModelContent原则：所有函数响应必须包含在同一个ModelContent对象中
2. 角色设置：ModelContent的角色必须设置为"function"
3. 响应顺序：响应顺序应与函数调用顺序保持一致
4. 数量匹配：响应数量必须与函数调用数量完全一致

最佳实践

对于需要频繁处理函数调用的应用，可以创建一个扩展方法来简化响应构建：

extension Array where Element == FunctionResponsePart {
    func modelContent() -> [ModelContent] {
        [ModelContent(role: "function", parts: self as [any Part])]
    }
}

这样使用时只需：

let responses = [
    FunctionResponsePart(name: "getExchangeRate", response: apiResponse1),
    FunctionResponsePart(name: "getExchangeRate", response: apiResponse2)
]
let result = try chat?.sendMessageStream(responses.modelContent())

注意事项

1. 确保函数响应紧跟在对应的函数调用之后发送
2. 不要将函数响应分多次发送
3. 检查模型是否确实支持并行函数调用功能
4. 在系统提示中明确说明模型的能力，可以提高函数调用的准确性

通过遵循这些原则，开发者可以充分利用Firebase iOS SDK中VertexAI组件的多函数调用能力，构建更强大的AI交互应用。