sii_web_search - SII 网络搜索

概述

sii_web_search 工具使用 SII 后端搜索服务执行网络搜索并返回结果。这个工具对于根据查询在互联网上查找信息非常有用。

工具名称

• 内部名称: sii_web_search
• 显示名称: SII Search
• 图标: 地球 (Globe)

前置条件

使用此工具需要：

1. SII 账户：需要有效的 SII 账户
2. 环境变量：
   • SII_USERNAME: SII 用户名
   • SII_PASSWORD: SII 密码
   • SII_BASE_URL: SII 后端 URL（可选，默认为 https://www.opensii.ai/backend）

参数

必需参数

参数名	类型	说明
query	string	搜索查询，用于在网络上查找信息。

功能说明

1. 网络搜索：

   • 使用 SII 后端搜索引擎
   • 返回相关的网页结果
   • 包含标题、URL 和摘要

2. 结果格式化：

   • 清晰的结果展示
   • 包含来源链接
   • 提供内容摘要

3. 认证管理：

   • 自动处理 token 认证
   • 支持 token 刷新
   • 处理认证错误

4. 错误处理：

   • 清晰的错误消息
   • 自动重试机制
   • 网络错误处理

使用示例

基本搜索

{
  "query": "人工智能最新进展"
}

技术搜索

{
  "query": "React 18 新特性"
}

学术搜索

{
  "query": "transformer 模型原理"
}

新闻搜索

{
  "query": "2024 科技趋势"
}

返回结果

工具返回一个包含以下字段的对象：

• llmContent: 格式化的搜索结果文本
• returnDisplay: 用户友好的显示信息
• sources: 搜索结果数组

搜索结果格式

每个搜索结果包含：

{
  title: string;      // 网页标题
  url: string;        // 网页 URL
  snippet?: string;   // 内容摘要
  content?: string;   // 完整内容（如果可用）
}

示例输出

Search results for "人工智能最新进展":

1. **AI 技术突破：2024 年度回顾**
   人工智能在 2024 年取得了重大突破，包括大语言模型的进步...
   Source: https://example.com/ai-2024

2. **深度学习的新方向**
   研究人员发现了提高神经网络效率的新方法...
   Source: https://example.com/deep-learning

Sources:
[1] AI 技术突破：2024 年度回顾 (https://example.com/ai-2024)
[2] 深度学习的新方向 (https://example.com/deep-learning)

错误处理

可能的错误情况：

1. 认证错误：

   • 缺少 SII 凭据
   • 用户名或密码错误
   • Token 过期

2. 搜索错误：

   • 查询为空
   • 网络连接失败
   • API 请求失败

3. 结果错误：

   • 没有找到结果
   • 结果格式错误
   • 超时

配置

环境变量设置

在使用工具前，需要设置以下环境变量：

# Linux/macOS
export SII_USERNAME="your_username"
export SII_PASSWORD="your_password"

# Windows (PowerShell)
$env:SII_USERNAME="your_username"
$env:SII_PASSWORD="your_password"

# Windows (CMD)
set SII_USERNAME=your_username
set SII_PASSWORD=your_password

自定义后端 URL

如果需要使用自定义的 SII 后端：

export SII_BASE_URL="https://custom.sii.ai/backend"

搜索技巧

1. 使用具体的关键词：

   • ✅ "React 18 并发渲染特性"
   • ❌ "React 新东西"

2. 组合多个关键词：

   • "机器学习 + 自然语言处理 + 应用"

3. 使用引号精确匹配：

   • "transformer architecture"

4. 指定时间范围：

   • "AI 进展 2024"

5. 使用专业术语：

   • 使用领域特定的术语获得更准确的结果

性能考虑

1. 搜索限制：

   • 默认返回最多 5 个结果
   • 可以通过后端配置调整

2. 响应时间：

   • 通常在 1-3 秒内返回结果
   • 取决于网络状况和查询复杂度

3. 并发请求：

   • 支持多个并发搜索请求
   • 自动处理 token 刷新

与其他工具的集成

与 sii_web_fetch 结合

1. 使用 sii_web_search 查找相关网页
2. 使用 sii_web_fetch 获取详细内容

与 sii_hybrid_search 结合

1. 使用 sii_hybrid_search 同时搜索网络和认知库
2. 获得更全面的搜索结果

与 sii_cognition_extract_upload 结合

1. 使用 sii_web_search 找到有价值的内容
2. 使用 sii_cognition_extract_upload 提取并保存认知

注意事项

1. 认证要求：必须设置有效的 SII 凭据
2. 网络连接：需要稳定的网络连接
3. 查询质量：查询质量直接影响搜索结果
4. 结果数量：默认返回有限数量的结果

相关工具

• sii_web_fetch: 获取网页内容
• sii_hybrid_search: 混合搜索（网络 + 认知库）
• sii_cognitions: 搜索 SII 认知库
• sii_cognition_extract_upload: 提取和上传认知