org.noear.solon.ai.skills.search

类 WebSearchSkill

java.lang.Object

org.noear.solon.ai.chat.skill.AbsSkill

org.noear.solon.ai.skills.search.WebSearchSkill

所有已实现的接口:

Skill

@Preview(value="3.9.1")
public class WebSearchSkill
extends AbsSkill

联网搜索技能：为 AI 代理提供实时动态的互联网信息检索能力。

该技能集成了全球主流搜索引擎驱动，具备以下特性：

• 全场景覆盖：内置 SERPER(Google)、BING 与 BAIDU 驱动，适配全球与中文本地化搜索需求。
• 结构化上下文：自动将搜索原始结果转化为包含标题、链接与摘要的 Markdown 格式，便于 AI 进行二次引用与溯源。
• 自适应解析策略：不同搜索引擎的 JSON 响应格式互异，通过 WebSearchSkill.SearchDriver 契约实现透明化的元数据提取。
• Token 成本控制：支持设置 maxResults，在保证信息丰富度的同时防止因搜索内容过多导致 LLM 上下文溢出。

从以下版本开始:

3.9.1

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	WebSearchSkill.SearchDriver
static class	WebSearchSkill.SearchResult

字段概要

字段

限定符和类型	字段和说明
static WebSearchSkill.SearchDriver	BAIDU
static WebSearchSkill.SearchDriver	BING
static WebSearchSkill.SearchDriver	SERPER

从类继承的字段 org.noear.solon.ai.chat.skill.AbsSkill

tools

构造器概要

构造器

构造器和说明
WebSearchSkill(WebSearchSkill.SearchDriver driver, java.lang.String apiKey)

方法概要

限定符和类型	方法和说明
java.lang.String	description() 获取技能描述
WebSearchSkill	maxResults(int maxResults)
java.lang.String	name() 获取技能名称（默认类名）
java.lang.String	search(java.lang.String query)

从类继承的方法 org.noear.solon.ai.chat.skill.AbsSkill

getTools, metadata

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 org.noear.solon.ai.chat.skill.Skill

getInstruction, isSupported, onAttach

字段详细资料

SERPER

public static final WebSearchSkill.SearchDriver SERPER

BING

public static final WebSearchSkill.SearchDriver BING

BAIDU

public static final WebSearchSkill.SearchDriver BAIDU

构造器详细资料

WebSearchSkill

public WebSearchSkill(WebSearchSkill.SearchDriver driver,
                      java.lang.String apiKey)

方法详细资料

maxResults

public WebSearchSkill maxResults(int maxResults)

name

public java.lang.String name()

从接口复制的说明: Skill

获取技能名称（默认类名）

description

public java.lang.String description()

从接口复制的说明: Skill

获取技能描述

search

@ToolMapping(name="search",
             description="\u8054\u7f51\u641c\u7d22\uff0c\u8fd4\u56de\u6807\u9898\u3001\u94fe\u63a5\u548c\u6458\u8981")
public java.lang.String search(@Param(value="query")
                                                                                                                                                                                  java.lang.String query)