sii_cognitions - SII 认知库

概述

sii_cognitions 工具用于访问和搜索 SII 后端的认知库。可以列出带有各种过滤器的认知，或获取特定认知的详细信息。仅在通过 SII 认证时可用。

工具名称

• 内部名称: sii_cognitions
• 显示名称: SII Cognitions
• 图标: 灯泡 (LightBulb)

前置条件

使用此工具需要：

1. SII 账户：需要有效的 SII 账户
2. 环境变量：
   • SII_USERNAME: SII 用户名
   • SII_PASSWORD: SII 密码
   • SII_BASE_URL: SII 后端 URL（可选）

参数

必需参数

参数名	类型	说明
action	string	要执行的操作：list（获取认知列表）或 detail（获取特定认知详情）。

可选参数（用于 list 操作）

参数名	类型	说明
search	string	用于过滤认知的搜索关键词。
skip	number	分页跳过的记录数（默认：0）。
limit	number	返回的结果数量（默认：20，最大：100）。
time_filter	string	时间过滤器：day、week、month、all（默认：day）。
sort	string	排序方法：latest、hot、most_liked（默认：latest）。
topics	string[]	要过滤的主题列表。
source_filter	string	来源过滤器（默认：all）。
author_filter	string	作者过滤器。

可选参数（用于 detail 操作）

参数名	类型	说明
cognition_id	string	要获取详情的认知 ID（仅用于 detail 操作）。

功能说明

1. 认知列表：

   • 浏览可用的认知
   • 支持多种过滤和排序选项
   • 分页支持

2. 认知详情：

   • 获取特定认知的完整信息
   • 包含中英文内容
   • 显示相关元数据

3. 高级过滤：

   • 按时间范围过滤
   • 按主题过滤
   • 按来源和作者过滤

4. 排序选项：

   • 最新：按创建时间排序
   • 热门：按热度排序
   • 最多点赞：按点赞数排序

认知结构

每个认知包含以下信息：

{
  id: string;                    // 认知 ID
  abstract_zh?: string;          // 中文摘要
  abstract_en?: string;          // 英文摘要
  question_zh?: string;          // 中文问题
  question_en?: string;          // 英文问题
  answer_zh?: string;            // 中文答案
  answer_en?: string;            // 英文答案
  source?: string;               // 来源
  author_name?: string;          // 作者名称
  likes: number;                 // 点赞数
  neutral: number;               // 中立数
  dislikes: number;              // 踩数
  created_at: string;            // 创建时间
  raw_at?: string;               // 原始时间
  primary_topic?: string;        // 主要主题
  related_topics?: string[];     // 相关主题
  user_vote?: string;            // 用户投票
}

使用示例

列出最新认知

{
  "action": "list",
  "limit": 10,
  "sort": "latest"
}

搜索特定主题

{
  "action": "list",
  "search": "机器学习",
  "topics": ["AI", "Technology"],
  "limit": 20
}

按时间过滤

{
  "action": "list",
  "time_filter": "week",
  "sort": "hot"
}

获取认知详情

{
  "action": "detail",
  "cognition_id": "abc123xyz"
}

分页浏览

{
  "action": "list",
  "skip": 20,
  "limit": 20,
  "sort": "most_liked"
}

按作者过滤

{
  "action": "list",
  "author_filter": "张三",
  "limit": 10
}

返回结果

List 操作返回

{
  llmContent: string;           // 格式化的认知列表
  returnDisplay: string;        // 用户友好的显示
  items: Cognition[];           // 认知数组
  total: number;                // 总数
  page: number;                 // 当前页
  size: number;                 // 页大小
  pages: number;                // 总页数
}

Detail 操作返回

{
  llmContent: string;           // 格式化的认知详情
  returnDisplay: string;        // 用户友好的显示
  cognition: Cognition;         // 完整的认知对象
}

时间过滤器

过滤器	说明
day	最近 24 小时
week	最近 7 天
month	最近 30 天
all	所有时间

排序方法

方法	说明
latest	按创建时间排序（最新的在前）
hot	按热度排序（综合考虑点赞、评论等）
most_liked	按点赞数排序（最多的在前）

错误处理

可能的错误情况：

1. 认证错误：

   • 缺少 SII 凭据
   • 认证失败
   • Token 过期

2. 参数错误：

   • 缺少必需参数
   • 参数值无效
   • 参数类型错误

3. API 错误：

   • 网络连接失败
   • API 请求失败
   • 认知不存在（detail 操作）

使用场景

1. 知识发现

搜索特定领域的认知，发现新知识和见解

2. 研究辅助

查找相关认知，辅助研究工作

3. 内容策划

浏览热门认知，策划内容创作

4. 学习资源

按主题浏览认知，作为学习资源

最佳实践

1. 使用具体的搜索词：

   • 使用专业术语获得更准确的结果
   • 组合多个关键词缩小范围

2. 合理使用过滤器：

   • 使用时间过滤器获取最新内容
   • 使用主题过滤器聚焦特定领域

3. 分页浏览：

   • 使用 skip 和 limit 实现分页
   • 避免一次加载过多数据

4. 选择合适的排序：

   • 查找最新内容：使用 latest
   • 查找热门内容：使用 hot
   • 查找高质量内容：使用 most_liked

与其他工具的集成

与 sii_web_search 结合

1. 使用 sii_web_search 搜索网络
2. 使用 sii_cognitions 搜索认知库
3. 综合两者结果获得全面信息

与 sii_hybrid_search 结合

使用 sii_hybrid_search 同时搜索网络和认知库

与 sii_cognition_extract_upload 结合

1. 使用 sii_cognitions 查找现有认知
2. 使用 sii_cognition_extract_upload 添加新认知

注意事项

1. 认证要求：必须设置有效的 SII 凭据
2. 结果限制：单次最多返回 100 个结果
3. 网络连接：需要稳定的网络连接
4. 数据更新：认知库持续更新，结果可能变化

相关工具

• sii_web_search: 网络搜索
• sii_hybrid_search: 混合搜索
• sii_cognition_extract_upload: 提取和上传认知
• sii_deep_research: 深度研究