From f62e8621fc14200e23bf06871a295e3ac50c34dc Mon Sep 17 00:00:00 2001
From: dtapps <li.gc@icloud.com>
Date: Mon, 27 Apr 2026 09:30:11 +0800
Subject: [PATCH] docs: fix agents.defaults model configuration format

Change incorrect object format model.primary/fallbacks to correct
flat format model_name/model_fallbacks in Agent defaults example.

The AgentDefaults struct does not support the object format used
in AgentConfig, so the documentation example was misleading.
---
 docs/guides/providers.md    | 6 ++----
 docs/guides/providers.zh.md | 6 ++----
 2 files changed, 4 insertions(+), 8 deletions(-)

diff --git a/docs/guides/providers.md b/docs/guides/providers.md
index d99d8c016..4e1f472d5 100644
--- a/docs/guides/providers.md
+++ b/docs/guides/providers.md
@@ -393,10 +393,8 @@ It also applies cooldown tracking per candidate to avoid immediately retrying a
   ],
   "agents": {
     "defaults": {
-      "model": {
-        "primary": "qwen-main",
-        "fallbacks": ["deepseek-backup", "gemini-backup"]
-      }
+      "model_name": "qwen-main",
+      "model_fallbacks": ["deepseek-backup", "gemini-backup"]
     }
   }
 }
diff --git a/docs/guides/providers.zh.md b/docs/guides/providers.zh.md
index 1302407a3..4bab65f6b 100644
--- a/docs/guides/providers.zh.md
+++ b/docs/guides/providers.zh.md
@@ -362,10 +362,8 @@ PicoClaw 按下面的规则解析 `provider` 和最终发给上游的模型 ID
   ],
   "agents": {
     "defaults": {
-      "model": {
-        "primary": "qwen-main",
-        "fallbacks": ["deepseek-backup", "gemini-backup"]
-      }
+      "model_name": "qwen-main",
+      "model_fallbacks": ["deepseek-backup", "gemini-backup"]
     }
   }
 }