AionClaw中实现可搜索下拉框需三步:1.准备含id/label字段的标准数据源;2.创建API技能(/api/search-options)支持模糊过滤;3.通过内置表单或手写JS嵌入搜索逻辑,并绑定选中ID至后续动作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在 AionClaw 中实现可搜索的下拉选择框,本质是让智能体能动态响应用户输入、实时过滤本地或 API 返回的候选选项,并将选中结果回填到指定字段。这不是界面控件的 HTML 编写,而是通过技能(Skill)+ 工具调用(Tool Call)+ 前端渲染逻辑三者协同完成——AionClaw 本身不提供原生“带搜索下拉框”UI 组件,但可通过自定义技能注入交互式表单。
准备可被搜索的数据源
第一步必须明确数据来源:是静态 JSON 列表、本地 CSV 文件,还是调用外部 API 获取?AionClaw 的技能脚本支持读取本地文件(如 data/servers.json),也支持发起 HTTP 请求。若数据量超 50 条,强烈建议走 API 模式,避免技能启动时加载过慢。
把原始数据整理成标准数组格式,每项含 id 和 label 字段,例如:[{"id":"11","label":"天火大道"},{"id":"22","label":"兵界之王"}]。这个结构是后续 JS 渲染和匹配的基础,【label 字段必须是字符串,不能为 null 或数字】。
创建一个返回过滤后选项的技能
打开 AionClaw 客户端 → 左侧导航栏点击「技能市场」→ 右上角「新建技能」→ 选择「自定义技能」模板。
在「触发方式」中勾选「API 调用」,并设置路径为 /api/search-options;在「执行逻辑」中粘贴如下 Python 脚本(适配 AionClaw 2.3+ 内置 Python 环境):
```python
import json
from pathlib import Path
def main(params):
query = params.get("q", "").strip()
https://www.php.cn/link/93ac0c50dd620dc7b88e5fe05c70e15b 从本地读取预置数据
data_path = Path(__file__).parent / "data" / "options.json"
if not data_path.exists():
return {"error": "data/options.json not found"}
options = json.loads(data_path.read_text(encoding="utf-8"))
https://www.php.cn/link/93ac0c50dd620dc7b88e5fe05c70e15b 模糊匹配 label 字段(大小写不敏感)
filtered = [o for o in options if query.lower() in o.get("label", "").lower()]
return {"items": filtered[:10]} https://www.php.cn/link/93ac0c50dd620dc7b88e5fe05c70e15b 最多返回 10 条,防列表过长
```
保存后点击「测试」,传入 {"q": "火"} 应返回含“火”的条目。这一步失败,后续所有交互都会卡死。
在前端页面中嵌入搜索下拉逻辑
方法一:复用 AionClaw 内置表单组件(推荐给非开发用户)
进入「自动化(RPA)」→ 新建流程 → 添加「弹窗表单」动作 → 在字段配置中,将目标字段类型设为「下拉选择」→ 展开「高级设置」→ 勾选「启用搜索」→ 在「选项来源」选择「API」→ 填写你上一步创建的技能路径 /api/search-options → 参数映射填 {"q": "{input}"}。
方法二:手写 HTML + JS 注入(适合需深度定制样式或行为的用户)
在技能的「前端渲染」区域(如有)或通过「网页注入」功能,插入以下代码片段:
```html
<script><br>const input = document.getElementById('searchInput');<br>const list = document.getElementById('dropdownList');<br>input.addEventListener('input', async () => {<br> const q = input.value.trim();<br> if (!q) { list.style.display = 'none'; return; }<br> try {<br> const res = await fetch('/api/search-options?q=' + encodeURIComponent(q));<br> const data = await res.json();<br> list.innerHTML = data.items.map(i => `<li><a href="https://www.php.cn/link/93ac0c50dd620dc7b88e5fe05c70e15b" data-id="${i.id}">${i.label}`).join('');<br> list.style.display = data.items.length ? 'block' : 'none';<br> } catch(e) { console.error(e); }<br>});<br>list.addEventListener('click', e => {<br> if (e.target.tagName === 'A') {<br> input.value = e.target.textContent;<br> input.dataset.selectedId = e.target.dataset.id;<br> list.style.display = 'none';<br> }<br>});<br></script>
```
这段代码会监听输入、自动请求、渲染列表、点击回填,且不依赖 jQuery。注意:AionClaw 默认禁用跨域请求,【所有 fetch 必须指向以 /api/ 开头的本地技能路径】,否则浏览器控制台报 CORS 错误。
绑定选中值到后续动作
第一步:在表单提交或按钮点击事件中,获取当前选中值。若用方法一(内置表单),直接在「下一步动作」中引用字段变量,如 {{form.field_name}};若用方法二(手写 JS),需将值存入全局状态或 hidden input:
```html
```
并在 JS 点击回调中追加:document.getElementById('selectedValue').value = e.target.dataset.id;
第二步:在后续技能或自动化步骤中,通过 params.server_id 或对应变量名读取该值。这一步漏掉,搜索就只是视觉效果,无法驱动真实业务逻辑。
第三步:验证整个链路是否连通。在「定时任务」或「对话任务」中手动触发该表单,输入关键词、点击选项、观察后续动作日志里是否收到正确 ID。只要日志里出现 "server_id": "11" 这类输出,说明已打通。

















