docs: update agents options section to include color and top_p options (#11355)

1 files changed, 41 insertions, 1 deletions

diff --git a/packages/web/src/content/docs/agents.mdx b/packages/web/src/content/docs/agents.mdx
index ea1f779cd..62957ad91 100644
--- a/packages/web/src/content/docs/agents.mdx
+++ b/packages/web/src/content/docs/agents.mdx
@@ -269,7 +269,7 @@ If this is not set, the agent will continue to iterate until the model chooses t
     "quick-thinker": {
       "description": "Fast reasoning with limited iterations",
       "prompt": "You are a quick thinker. Solve problems with minimal steps.",
-      "maxSteps": 5
+      "steps": 5
     }
   }
 }
@@ -277,6 +277,10 @@ If this is not set, the agent will continue to iterate until the model chooses t
 
 When the limit is reached, the agent receives a special system prompt instructing it to respond with a summarization of its work and recommended remaining tasks.
 
+:::caution
+The legacy `maxSteps` field is deprecated. Use `steps` instead.
+:::
+
 ---
 
 ### Disable
@@ -568,6 +572,42 @@ Users can always invoke any subagent directly via the `@` autocomplete menu, eve
 
 ---
 
+### Color
+
+Customize the agent's visual appearance in the UI with the `color` option. This affects how the agent appears in the interface.
+
+```json title="opencode.json"
+{
+  "agent": {
+    "creative": {
+      "color": "#ff6b6b"
+    }
+  }
+}
+```
+
+Must be a valid hex color code like `#FF5733`.
+
+---
+
+### Top P
+
+Control response diversity with the `top_p` option. Alternative to temperature for controlling randomness.
+
+```json title="opencode.json"
+{
+  "agent": {
+    "brainstorm": {
+      "top_p": 0.9
+    }
+  }
+}
+```
+
+Values range from 0.0 to 1.0. Lower values are more focused, higher values more diverse.
+
+---
+
 ### Additional
 
 Any other options you specify in your agent configuration will be **passed through directly** to the provider as model options. This allows you to use provider-specific features and parameters.