blob: 211be0b18b1e941c19563bc23c2ad361dee15b09 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
# MiMo Web Search Plugin for Hermes Agent
将小米 MiMo 的**联网搜索**（server-side web search）接入 Hermes Agent 的 `web_search` 工具。
MiMo 在服务端执行搜索、浏览网页、提取内容，通过 Chat Completions API 的 `url_citation` 注释返回结构化结果。适合中文搜索场景。
## 工作原理
```
Hermes web_search 工具
↓
MiMoWebSearchProvider.search(query, limit)
↓
POST {base_url}/chat/completions
tools: [{type: "web_search", force_search: true, ...}]
↓
MiMo 服务端搜索 → 返回 annotations: [{type: "url_citation", ...}]
↓
解析为 Hermes 标准格式: {title, url, description, position}
```
## 可选配置
在 Hermes 的 `config.yaml` 的 `web.mimo` 下可调整：
```yaml
web:
search_backend: "mimo"
mimo:
model: "mimo-v2.5" # 可选: mimo-v2.5-pro, mimo-v2.5, mimo-v2-flash 等
max_keyword: 3 # 每轮搜索最大关键词数（影响调用次数和费用）
timeout: 30 # 请求超时秒数
```
## 计费
- **联网搜索工具**：国内 ¥16/1000 次，海外 $5/1000 次
- **Token 消耗**：搜索结果拼入 prompt，按模型输入 token 标准价计费
- 每轮搜索可能触发 `max_keyword` 个关键词，每个关键词算一次调用
## API 参考
- [MiMo 联网搜索文档](https://mimo.mi.com/docs/zh-CN/guides/text-generation/web-search)
- [MiMo 平台](https://platform.xiaomimimo.com)
- [Hermes Web Search Provider 插件开发指南](https://hermes-agent.nousresearch.com/docs/developer-guide/web-search-provider-plugin)
## 文件说明
```
mimo-websearch-for-hermes/
├── README.md # 本文档（介绍）
├── INSTALL.md # 安装说明（给 Agent 看）
├── plugin.yaml # Hermes 插件清单
├── setup.sh # 安装/卸载脚本（仅供参考）
├── __init__.py # 插件注册入口
├── provider.py # WebSearchProvider 实现
└── test_search.py # 独立测试脚本（可脱离 Hermes 使用）
```
|
