Zion默认不启用重试机制,需显式配置retry_policy.enabled为true或传入retry_config对象;未配置时遇ConnectionTimeout等错误直接失败,且配置变更须重启进程才生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

当智能体在函子Zion中调用工具失败时,系统默认不自动重试,必须显式配置重试策略才能触发重试行为。
确认Zion当前是否启用重试机制
打开Zion项目根目录下的 config/agent.yaml 文件,查找 【retry_policy】 字段。若该字段不存在或值为 null、false 或空对象,则表示重试功能未启用。
检查示例:
retry_policy:
enabled: false
max_attempts: 3
此时即使工具返回 ConnectionTimeout 或 HTTPStatusError(503),Zion也会直接终止当前步骤并标记为失败。
手动启用重试的两种方法
方法一:修改 YAML 配置文件
将 config/agent.yaml 中的 enabled 值设为 true,并确保 max_attempts ≥ 2。注意:【必须重启Zion运行时进程才能使配置生效】,热重载不支持 retry_policy 变更。
方法二:在工具调用时动态指定
调用工具前,在参数中传入 retry_config 对象:
{ "tool": "db_query", "input": { "sql": "SELECT * FROM users" }, "retry_config": { "attempts": 2, "backoff": 0.8 } }
该方式优先级高于全局配置,适用于对特定高价值工具(如支付确认、状态同步)单独加固。
验证重试是否真实发生
第一步:在Zion日志目录(默认 logs/agent/)中启用 DEBUG 级别输出;
第二步:触发一次已知会失败的工具调用(例如故意将API地址指向一个不存在的端口);
第三步:查看日志中是否出现连续编号的相同请求记录,形如:
[2026-11-13T19:58:22.101] [DEBUG] tool_call_attempt #1 → db_query
[2026-11-13T19:58:22.415] [ERROR] Connection refused: localhost:8081
[2026-11-13T19:58:23.227] [DEBUG] tool_call_attempt #2 → db_query
若仅见 #1 尝试且无后续编号,则说明重试未激活或被拦截。


















