Wiki 与搜索

Wiki 与搜索工具让 AI 能够获取 Minecraft 游戏知识和互联网信息。通过这两个工具，AI 可以搜索 Minecraft Wiki 查询物品/方块/生物资料，也可以搜索互联网获取最新的游戏资讯。

工具列表

工具	功能	参数	返回值
`web_search`	搜索互联网	`query`, `limit`(可选)	搜索结果列表
`minecraft_wiki_search`	搜索 Minecraft Wiki	`query`, `limit`(可选)	Wiki 搜索结果

工具详解

web_search — 网页搜索

搜索互联网获取实时信息，适用于 LLM 知识截止日期后的新内容、最新版本资讯、攻略等。

{
  "tool": "web_search",
  "params": { "query": "Minecraft 1.21 新内容", "limit": 5 }
}

返回结果包含标题、URL 和摘要，格式为 Markdown 列表。

minecraft_wiki_search — Wiki 搜索

搜索 Minecraft Wiki（官方中文 Wiki），获取物品、方块、生物、结构等页面的标题和简介。

{
  "tool": "minecraft_wiki_search",
  "params": { "query": "下界合金装备", "limit": 5 }
}

搜索到目标页面后，可进一步在 LLM 对话中追问更多细节，LLM 会自动获取并整理 Wiki 内容。

搜索流程

LLM 需要获取游戏知识
    │
    ▼
minecraft_wiki_search(query: "钻石剑")
    │ 搜索 Wiki 返回标题列表
    ▼
LLM 解析结果为用户提供答案
    │
    │ 如需更深度的信息：
    ▼
LLM 再次调用 minecraft_wiki_search(query: "Diamond Sword 合成")
    │ 获取更精确的结果
    ▼
LLM 整理并回复用户

搜索引擎架构

搜索模块使用多引擎策略，按优先级自动切换：

1. Bing HTML 搜索（默认，国内可访问，无需 API Key）
   ↓ 失败时自动切换
2. 百度搜索
   ↓ 失败时自动切换
3. DuckDuckGo 搜索

Wiki 搜索则直接调用的 Minecraft Wiki 的 API，获取结构化内容。

典型场景

查询最新版本信息：

用户: "Minecraft 1.21 版本有什么新内容？"

AI:
1. web_search(query: "Minecraft 1.21 new features", limit: 5)
   → 获取最新版本资讯
2. 整理搜索结果并回复用户

查询游戏机制：

用户: "怎么做出下界合金装备？"

AI:
1. minecraft_wiki_search(query: "下界合金装备")
   → 获取 Wiki 条目
2. knowledge_query(query: "下界合金装备合成配方")
   → 结合内置知识库
3. 综合回复: "首先需要获得下界合金锭，然后在锻造台..."

解决 LLM 知识过时问题：

用户: "最新的 Minecraft 版本是多少？"

AI 知道自己的知识截止日期，主动调用:
→ web_search(query: "最新 Minecraft 版本 2026")
→ 获取到最新版本号
→ 回复用户

错误处理

场景	错误码	说明
搜索词为空	—	返回提示信息”搜索词不能为空”
搜索结果为空	—	返回空列表，不报错
搜索引擎不可用	—	自动切换备选引擎
Wiki 页面不存在	`NOT_FOUND`	页面标题无效

Task