feat(workflow): add per-agent vision configuration

backend/tests/test_brains.py

@@ -470,6 +470,81 @@ class PromptBrainTests(unittest.IsolatedAsyncioTestCase):
 
 
 class WorkflowBrainTests(unittest.IsolatedAsyncioTestCase):
+    async def test_agent_vision_tool_is_scoped_to_effective_stage(self):
+        brain = WorkflowBrain(
+            {
+                "specVersion": 3,
+                "settings": {
+                    "globalPrompt": "全局规则",
+                    "defaultLlmResourceId": "llm_global",
+                    "visionEnabled": True,
+                    "visionModelResourceId": "vision_global",
+                },
+                "nodes": [
+                    {"id": "start", "type": "start", "data": {}},
+                    {
+                        "id": "agent",
+                        "type": "agent",
+                        "data": {
+                            "prompt": "观察用户需要展示的物品",
+                            "inheritGlobalConfig": True,
+                        },
+                    },
+                ],
+                "edges": [
+                    {
+                        "id": "begin",
+                        "source": "start",
+                        "target": "agent",
+                        "data": {"mode": "always", "priority": 0},
+                    }
+                ],
+            }
+        )
+        scopes = []
+        vision_function = object()
+
+        async def queue_frame(_frame):
+            pass
+
+        brain._runtime = BrainRuntime(
+            context=LLMContext(messages=[]),
+            llm=FakeLLM(),
+            queue_frame=queue_frame,
+            set_system_prompt=lambda _prompt: None,
+            set_tools=lambda _tools: None,
+            call_end=FakeCallEnd(),
+            set_vision_scope=scopes.append,
+            vision_function=vision_function,
+        )
+
+        await brain._apply_agent_stage("agent")
+        inherited_config = brain._agent_config("agent")
+        self.assertIn(vision_function, inherited_config["functions"])
+        self.assertIn("fetch_user_image", inherited_config["role_message"])
+        self.assertEqual(
+            scopes[-1],
+            {
+                "enabled": True,
+                "vision_model_resource_id": "vision_global",
+                "llm_resource_id": "llm_global",
+            },
+        )
+
+        brain._engine.data("agent").update(
+            {
+                "inheritGlobalConfig": False,
+                "llmResourceId": "llm_agent",
+                "visionEnabled": False,
+                "visionModelResourceId": "",
+            }
+        )
+        await brain._apply_agent_stage("agent")
+        custom_config = brain._agent_config("agent")
+        self.assertNotIn(vision_function, custom_config["functions"])
+        self.assertNotIn("fetch_user_image", custom_config["role_message"])
+        self.assertFalse(scopes[-1]["enabled"])
+
     async def test_initial_fixed_speech_waits_for_start_greeting_to_finish(self):
         brain = WorkflowBrain(
             {