sii_deep_research - SII 深度研究

概述

sii_deep_research 工具用于使用 SII 后端的 Engineer Deep Research API 进行全面的研究。它支持自动启动研究会话、里程碑跟踪、实时阶段分析、会话历史记录以及阶段特定信息提取。支持中英文研究输出。仅在通过 SII 认证时可用。

工具名称

• 内部名称: sii_deep_research
• 显示名称: SII Deep Research
• 图标: 灯泡 (LightBulb)

前置条件

使用此工具需要：

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

参数

必需参数（根据操作不同）

参数名	类型	说明
action	string	要执行的操作。可选值见下表。

操作类型

操作	说明	必需参数
start	创建并自动启动新研究会话	research_question
health	检查服务健康状态	无
history	获取会话历史记录（带里程碑组织）	session_id
phase_analysis	分析当前执行阶段	session_id
extract_phase_info	提取阶段特定信息	session_id, target_phase
monitor	监控研究进度（带里程碑跟踪）	session_id
milestone_summary	获取快速里程碑摘要（带内容预览）	session_id
save_results	保存完整研究结果到本地文件（研究完成时）	session_id

可选参数

参数名	类型	说明
research_question	string	要深入研究的研究问题（用于 start 操作）。
language	string	研究输出的语言（zh 中文或 en 英文）。默认：zh。
research_params	object	研究配置选项。
research_params.web_search_enabled	boolean	启用网络搜索。默认：true。
research_params.cognition_search_enabled	boolean	启用认知库搜索。默认：true。
research_params.max_iterations	number	最大研究迭代次数。默认：2。
session_id	string	会话 ID（用于需要现有会话的操作）。
target_phase	string	目标阶段（用于 extract_phase_info 操作）。
limit	number	历史记录检索限制（默认：100，最大：1000）。
metadata	object	研究会话的自定义元数据。

研究阶段

研究过程包含以下阶段：

阶段	说明
initialization	初始化阶段
planning	规划研究策略
web_search	网络搜索阶段
browsing	浏览网页内容
writing	撰写研究报告
completion	研究完成
session_end	会话结束

里程碑类型

类型	说明
plan	研究计划
web_search_results	网络搜索结果
web_browsing_result	网页浏览结果
writing_end	写作完成
research_completion	研究完成
session_end	会话结束

使用示例

启动新研究

{
  "action": "start",
  "research_question": "人工智能在医疗领域的最新应用",
  "language": "zh",
  "research_params": {
    "web_search_enabled": true,
    "cognition_search_enabled": true,
    "max_iterations": 3
  }
}

检查服务健康

{
  "action": "health"
}

获取会话历史

{
  "action": "history",
  "session_id": "abc123xyz",
  "limit": 50
}

分析当前阶段

{
  "action": "phase_analysis",
  "session_id": "abc123xyz"
}

提取阶段信息

{
  "action": "extract_phase_info",
  "session_id": "abc123xyz",
  "target_phase": "web_search"
}

监控研究进度

{
  "action": "monitor",
  "session_id": "abc123xyz"
}

获取里程碑摘要

{
  "action": "milestone_summary",
  "session_id": "abc123xyz"
}

保存研究结果

{
  "action": "save_results",
  "session_id": "abc123xyz"
}

返回结果

Start 操作

{
  session_id: string;              // 会话 ID
  status: 'created';               // 状态
  created_at: string;              // 创建时间
  auto_started: boolean;           // 是否自动启动
  action?: string;                 // 执行的操作
  action_result?: any;             // 操作结果
}

Health 操作

{
  status: 'healthy' | 'unhealthy'; // 健康状态
  version: string;                 // 版本
  timestamp: string;               // 时间戳
  dependencies: {
    conversation_manager: 'healthy' | 'unhealthy';
  };
  sessions_count: number;          // 会话数量
}

History 操作

{
  session_id: string;              // 会话 ID
  total_count: number;             // 总数
  organized_history: {
    milestones: Milestone[];       // 里程碑数组
  };
  research_summary: {
    total_messages: number;        // 总消息数
    total_queries: number;         // 总查询数
    session_duration: number;      // 会话持续时间
  };
}

Phase Analysis 操作

{
  session_id: string;              // 会话 ID
  current_phase: string;           // 当前阶段
  phase_progress: number;          // 阶段进度（0-100）
  next_expected_phase: string;     // 下一个预期阶段
  phase_details: {
    [phase: string]: {
      completed: boolean;          // 是否完成
      timestamp: string | null;    // 时间戳
      milestone_type: string;      // 里程碑类型
    };
  };
  completion_estimate: {
    estimated_minutes: number;     // 预计剩余分钟数
    confidence: 'low' | 'medium' | 'high';
  };
  recommendations: string[];       // 建议
}

工作流程

典型研究流程

1. 启动研究：

   使用 start 操作创建新研究会话

2. 监控进度：

   定期使用 phase_analysis 检查进度
   或使用 monitor 获取实时更新

3. 查看里程碑：

   使用 milestone_summary 查看关键进展

4. 获取详细历史：

   使用 history 获取完整的研究历史

5. 保存结果：

   研究完成后使用 save_results 保存报告

重要行为准则

1. 时间预期：

   • 深度研究通常需要 5-10 分钟完成
   • 必须在启动时告知用户预期时长
   • 建议用户在等待时处理其他任务

2. 进度检查：

   • 不要自动检查进度
   • 等待用户明确请求状态更新
   • 每次用户请求只检查一次
   • 告知用户后停止

3. 自然完成：

   • 等待自然完成，不要强制提前终止
   • 除非用户明确要求

4. 状态更新示例：

   "这项研究大约需要 5-10 分钟。如果需要，我会等待您询问更新。
   您可以在此期间处理其他任务。"

5. 用户请求进度时：

   • 执行单次阶段分析检查
   • 如果检查显示完成（phase_progress = 100 或 current_phase = "completion"/"session_end"）
   • 自动调用 save_results 工具
   • 显示工具的确认 UI
   • 尊重用户的确认结果

错误处理

可能的错误情况：

1. 认证错误：

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

2. 参数错误：

   • 缺少必需参数
   • 参数值无效
   • 会话 ID 不存在

3. 研究错误：

   • 研究问题无效
   • 网络连接失败
   • API 请求失败
   • 研究超时

研究配置

网络搜索

启用或禁用网络搜索：

{
  "research_params": {
    "web_search_enabled": true
  }
}

认知库搜索

启用或禁用认知库搜索：

{
  "research_params": {
    "cognition_search_enabled": true
  }
}

迭代次数

控制研究的深度：

{
  "research_params": {
    "max_iterations": 3
  }
}

输出语言

中文输出

{
  "language": "zh"
}

英文输出

{
  "language": "en"
}

最佳实践

1. 明确研究问题：

   • 使用具体、清晰的研究问题
   • 避免过于宽泛或模糊的问题

2. 合理设置参数：

   • 根据研究需求调整迭代次数
   • 选择合适的搜索选项

3. 耐心等待：

   • 深度研究需要时间
   • 不要频繁检查进度

4. 保存结果：

   • 研究完成后及时保存结果
   • 结果保存在本地文件中

5. 查看里程碑：

   • 使用 milestone_summary 快速了解进展
   • 使用 history 获取详细信息

使用场景

1. 学术研究

深入研究特定学术主题，获取全面的文献综述

2. 技术调研

调研新技术、框架或工具，了解最佳实践

3. 市场分析

分析市场趋势、竞争对手和行业动态

4. 问题解决

深入研究复杂问题，寻找解决方案

注意事项

1. 时间投入：深度研究需要 5-10 分钟
2. 网络要求：需要稳定的网络连接
3. 认证要求：必须设置有效的 SII 凭据
4. 结果保存：研究结果保存在本地文件系统

相关工具

• sii_web_search: 网络搜索
• sii_cognitions: 认知库搜索
• sii_hybrid_search: 混合搜索
• sii_cognition_extract_upload: 提取和上传认知