/MainProcess] 22208184909825/agent-e80a0 agent invoke chat to retry again llm er...

2026年06月22日 21:57 27.34 秒 success

错误信息

[2025-09-03 11:10:25,969: ERROR/MainProcess] 22208184909825/agent-e80a0 agent invoke chat to retry again llm error: Error code: 400 - {'error': {'message': "Invalid schema for function 'self_intent_recognition_0': None is not of type 'array'. (request id: 20250903110948261917640BBDOPt2p)", 'type': 'openai_error', 'param': '', 'code': 'invalid_function_parameters'}}

AI 解决方案

● AI 思考过程 ▼

好的，用户提供了一个报错信息，我需要作为代码报错分析助理来分析它。

嗯，从报错信息来看，这是一个LLM调用错误，发生在自意图识别函数上。错误提示说函数'self_intent_recognition_0'的模式无效，具体是"None is not of type 'array'"。

让我先做错误翻译，把核心的英文错误信息翻译成中文，这样能帮助用户更好地理解问题。

错误信息的核心部分是"Invalid schema for function 'self_intent_recognition_0': None is not of type 'array'"，翻译过来就是函数'self_intent_recognition_0'的参数定义无效，某个应该为数组类型的参数被设置成了None。

现在分析原因。用户在调用LLM时传入了函数定义，但函数'self_intent_recognition_0'的某个参数属性应该是一个数组，却错误地设置成了None。这通常是在构建API请求体时，函数的parameters对象中某个字段没有正确初始化。

具体来说，可能是在parameters.properties中定义参数时，某个参数的"type"、"enum"、"items"或"required"字段被设置成了None而不是正确的数组。

对于解决方案，我需要提供修复代码示例。应该确保所有参数属性都正确定义，特别是那些应该是数组的字段。比如，如果使用了"enum"字段，它必须是字符串数组；如果使用了"required"字段，它必须是字段名的数组。

在代码示例中，我会展示如何正确构建函数定义，确保所有应该是数组的字段都被正确初始化，避免None值。

最后提供预防措施。建议在构建请求体后使用JSON验证工具检查结构，或者在代码中添加参数定义的验证逻辑，确保所有字段都符合OpenAI API的规范。

这样的分析应该能帮助用户快速定位并解决问题。

🔍 分错分析

1. 🌐 错误翻译

原文：Invalid schema for function 'self_intent_recognition_0': None is not of type 'array'.
译文：函数‘self_intent_recognition_0’的模式无效：某个应为数组（array）类型的值不能为None。

2. 🎯 原因分析

根本原因：调用LLM API（如OpenAI）时，传递的函数（function/tools）定义格式不正确。

具体问题：在函数self_intent_recognition_0的parameters定义中，某个期望是数组（Array）类型的属性（例如enum, items, required或type本身）的值被设置为了None（或null），而非一个有效的数组。

常见场景：这通常发生在动态构建函数定义的代码中，某个列表字段未被正确初始化或赋值。

3. 💡 解决方案

检查并修正传递给LLM的函数定义结构。确保所有应为数组的字段都正确定义。

错误示例（可能出错的代码片段）：

tools = [{
    "type": "function",
    "function": {
        "name": "self_intent_recognition_0",
        "description": "识别用户意图",
        "parameters": {
            "type": "object",
            "properties": {
                "intent": {
                    "type": "string",
                    "enum": None,  # ❌ 错误：enum 应为数组，不能是 None
                    "description": "意图类型"
                }
            },
            "required": ["intent"]  # ✅ 正确：这是一个数组
        }
    }
}]

修复示例（正确的代码结构）：

tools = [{
    "type": "function",
    "function": {
        "name": "self_intent_recognition_0",
        "description": "识别用户意图",
        "parameters": {
            "type": "object",
            "properties": {
                "intent": {
                    "type": "string",
                    "enum": ["greeting", "farewell", "query"],  # ✅ 修复：提供一个有效的字符串数组
                    "description": "意图类型"
                }
            },
            "required": ["intent"]
        }
    }
}]

# 然后使用正确的 tools 定义调用 API
response = client.chat.completions.create(
    model="your-model",
    messages=messages,
    tools=tools,  # 使用修正后的定义
    tool_choice="auto"
)

4. 🛡️ 预防措施

构建后验证：在将函数定义发送给API之前，使用 json.dumps() 将其序列化为字符串，确保没有 None 值，并使用在线JSON校验工具检查其结构。

使用类型检查：在代码中为函数定义添加简单的检查逻辑。

   # 简单检查示例
   for tool in tools:
       params = tool['function'].get('parameters', {})
       for prop_name, prop_def in params.get('properties', {}).items():
           for key in ['enum', 'items']:
               if key in prop_def and prop_def[key] is None:
                   raise ValueError(f"参数'{prop_name}'的'{key}'字段不能为None，请检查。")

分析新问题查看更多