OpenAI实时API函数调用未执行问题求助

阿华AIGC实验室

2026-4-7

我现在遇到一个头疼的问题：已经正确定义并注册了函数，但OpenAI实时API（gpt-4o-realtime-preview-2024-10-01）完全不调用这些函数。AI助手能正常回应用户请求，但哪怕是最简单的测试函数也从来没被触发过。下面是我的环境、代码细节和症状，求大佬帮忙排查！

环境与基础配置

使用OpenAI Realtime API的WebSocket连接，模型版本为gpt-4o-realtime-preview-2024-10-01
集成Twilio实现电话通话功能
后端基于Node.js/TypeScript开发
通过session.update消息中的tools数组完成函数注册

测试函数定义

我先写了一个无参数的极简测试函数，用来验证调用逻辑：

functions.push({
  schema: {
    name: "test_function",
    type: "function",
    description: "A simple test function that returns a greeting message",
    parameters: {
      type: "object",
      properties: {},
      required: [],
    },
  },
  handler: async () => {
    return "Hello! This is a test function call response.";
  },
});

函数注册代码

函数是在发送给OpenAI的session配置中注册的，确保schema完全一致：

const config = session.saved_config || {};
jsonSend(session.modelConn, {
  type: "session.update",
  session: {
    modalities: ["text", "audio"],
    turn_detection: { type: "server_vad" },
    voice: "alloy",
    input_audio_transcription: { model: "whisper-1" },
    input_audio_format: "g711_ulaw",
    output_audio_format: "g711_ulaw",
    instructions: instructions,
    tools: [
      {
        name: "test_function",
        type: "function",
        description: "A simple test function that returns a greeting message",
        parameters: {
          type: "object",
          properties: {},
          required: [],
        },
      }
    ],
    ...config, // 合并前端传来的session配置覆盖项
  },
});

函数调用处理代码

我也实现了对应的事件监听逻辑，处理函数调用的响应：

case "response.output_item.done": {
  const { item } = event;
  if (item.type === "function_call") {
    handleFunctionCall(session, item)
      .then((output) => {
        if (session.modelConn) {
          jsonSend(session.modelConn, {
            type: "conversation.item.create",
            item: {
              type: "function_call_output",
              call_id: item.call_id,
              output: JSON.stringify(output),
            },
          });
          jsonSend(session.modelConn, { type: "response.create" });
        }
      })
      .catch((err) => {
        console.error(`Error handling function call for ${session.streamSid}:`, err);
      });
  }
  break;
}