必须切换iframe上下文才能点击内部按钮：先显式等待iframe加载完成，再用switch_to_frame或>>语法切入，多层嵌套需逐级切入并退出至顶层。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让agent-browser准确点击iframe内部的“提交订单”按钮，却总在父页面上空转找不到元素，问题几乎都出在frame上下文切换缺失。
确认目标iframe是否已加载完成
执行任何操作前，先用显式等待确认iframe存在且可交互：browser.wait_for("iframe#order-form", timeout=8)。不加这步就直接find，agent-browser会默认在顶层document里搜索，永远匹配不到子frame里的节点。
注意：timeout设为8秒是因多数后台iframe依赖异步API加载，低于5秒容易误判为未就绪。
进入指定iframe执行操作
方法一：使用frame_path定位并切入
执行browser.switch_to_frame("iframe#order-form")→再运行browser.click("#submit-btn")。这一步必须成对出现，切进去后所有后续操作才作用于该iframe内部DOM。
方法二：用CSS选择器链一次性定位iframe内元素browser.click("iframe#order-form >> #submit-btn")。Agent-Browser底层会自动解析>>符号，先切入iframe再查找子元素，适合单次操作场景。
【必须手动调用switch_to_frame或使用>>语法，否则所有find/click均作用于主文档】
处理多层嵌套iframe
第一步：获取完整frame路径
运行frames = browser.get_frames()，返回类似[{"id": "a1", "src": "/nav.html"}, {"id": "b2", "src": "/form.html"}]的结构，从中识别目标iframe的id或src特征。
第二步：按层级顺序切入browser.switch_to_frame("iframe#nav-frame")→browser.switch_to_frame("iframe#form-frame")→执行browser.input("input[name='amount']", "99.99")。
第三步：退出至顶层（如需后续操作主页面）browser.switch_to_default_content()。遗漏此步会导致后续所有操作仍困在最内层iframe中。
验证当前frame上下文是否正确
执行current = browser.get_current_frame()，返回值为None表示在顶层document，返回类似{"id": "b2", "tag_name": "iframe"}则说明已切入指定frame。
这一步建议在关键操作前插入，避免因异步加载导致frame_path失效却无感知。
