Agent Space模型调用失败时流程中断，需依日志分三步定位：非结构化输出→prompt或模型不支持tool calling；JSON工具名报错→工具注册不匹配；工具执行异常→缺Pydantic参数校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当Agent Space模型调用失败时，你无法继续执行工具链路、任务规划或结果生成，整个智能体流程会卡在“思考→调用”环节，用户对话直接中断或返回空响应。
确认失败类型：先分清是哪一环断了
第一步：查看日志中模型输出的原始内容。如果返回的是非结构化文本（比如纯自然语言回答），说明【模型根本没走tool-calling流程】，可能是prompt未启用function calling模式，或模型不支持该能力。
第二步：如果日志里有类似{"name": "search_web", "arguments": "..."}的JSON片段，但后续报错"Tool 'search_web' not found"，那就是工具注册失败——Space环境里工具名大小写、特殊字符、注册时机都必须严格匹配。
第三步：若工具成功执行但返回空content或格式异常（如JSON字段缺失、类型错乱），问题出在模型参数生成环节，不是模型调用失败，而是参数校验未拦截，需立刻加Pydantic schema约束。
修复模型调用入口：让Space真正识别function calling
方法一：检查LLM初始化是否显式启用tool use
使用OpenAI兼容接口时，必须传入tools参数且设置tool_choice="auto"；用Qwen或GLM系列模型时，需确认其Space SDK版本≥2.3.1，并在config中开启enable_tool_calling: true——旧版SDK默认关闭此功能，不报错也不生效。
方法二：验证system prompt是否包含明确指令
在Space的agent config中，system prompt必须含有一句不可省略的声明：“你是一个支持函数调用的智能体，所有需要外部数据的操作都必须通过调用指定工具完成，禁止自行编造结果。”缺这句话，部分轻量模型会忽略tools定义直接自由作答。
方法三：强制触发一次schema校验
向模型发送一条测试query：“请调用get_time获取当前时间”，并观察返回。若仍无tool_call字段，说明模型根本不理解当前上下文处于tool-calling mode，此时需在prompt末尾追加JSON Schema示例（哪怕只写一行{"name":"get_time","arguments":"{}"}），用few-shot方式唤醒模型的结构化输出意识。
重试前必做：区分错误类型再决定是否重试
① 网络超时、503/429状态码 → 启用指数退避重试，base_delay设为800ms，最多2次，第2次失败后立即熔断。
② 400/401/404错误 → 【禁止重试】，这类错误根源在参数或权限，重试只会放大问题。应立即将错误原文注入conversation_history，作为新system message发给模型：“你上一次调用工具时因参数错误被拒绝，请检查工具名、参数类型和必填字段。”
③ 模型返回空字符串、纯文本、或JSON解析失败 → 触发格式兜底：用正则提取{.*?}片段，若提取失败，直接返回error_type="format_mismatch"，跳过执行器，进入Prompt容错分支。
切换备用模型：Space内快速降级方案
在Space控制台的Agent配置页，打开“模型降级开关”，绑定一个已验证可用的备用模型ID（如qwen2-7b-instruct-space-v2）。当主模型连续2次未输出tool_call字段时，系统自动将下一轮请求路由至备用模型，无需重启服务。
注意：备用模型的tools schema必须与主模型完全一致，否则注册表匹配会失败——Space不支持跨schema动态适配。
执行Space控制台→Agent配置→模型降级开关→启用→填写备用模型ID→保存。
