深入研究
这个包提供了代理调查,学术搜索,刮取,汇总搜索,趋势发现和迭代研究工具. 用这个 axios 用于搜索和内容 API, DuckDuckGo HTML 搜索,以及 OpenAI 兼容的聊天完成端点,用于查询分解和报告合成.
安装
npm install @framers/agentos-ext-deep-research
同伴依赖 : @framers/agentos 有范围 >=0.10.40。 。 。 .
使用量
import { AgentOS } from '@framers/agentos';
const agentos = await AgentOS.create({
extensionManifest: {
packs: [
{
package: '@framers/agentos-ext-deep-research',
options: {
serperApiKey: process.env.SERPER_API_KEY,
braveApiKey: process.env.BRAVE_API_KEY,
serpApiKey: process.env.SERPAPI_API_KEY,
openaiApiKey: process.env.OPENAI_API_KEY,
openrouterApiKey: process.env.OPENROUTER_API_KEY,
},
},
],
},
});
配置
| 选项 | 秘密编号 | 环境变量 | 需求 | 默认 |
|---|---|---|---|---|
serperApiKey | serper.apiKey | SERPER_API_KEY | 是, 显示 | 空字符串 |
braveApiKey | brave.apiKey | BRAVE_API_KEY | 没有 | 未设置 |
serpApiKey | serpapi.apiKey | SERPAPI_API_KEY | 没有 | 未设置 |
openaiApiKey | openai.apiKey | OPENAI_API_KEY,则 OPENROUTER_API_KEY 在共享密钥链中 | 没有 | 共享密钥链, 然后空出字符串 |
openrouterApiKey | openrouter.apiKey | OPENAI_API_KEY,则 OPENROUTER_API_KEY 在共享密钥链中 | 没有 | 共享密钥链, 然后空出字符串 |
primaryProvider | 无 | 无 | 没有 | openai |
smallModel | 无 | 无 | 没有 | gpt-4o-mini |
synthesisModel | 无 | 无 | 没有 | gpt-4o |
secrets | 秘密地图 | 无 | 没有 | A. 背景情况 secrets空对象 |
| 无 | 无 | DEBUG | 没有 | 未设置 |
从选项中搜索密钥解析,然后是选中的秘密地图,然后是环境 . options.secrets 替换上下文 secrets。 LLM 密钥解析自 openaiApiKey, (中文(简体) ), openai.apiKey, (中文(简体) ), openrouterApiKey, (中文(简体) ), openrouter.apiKey, (中文(简体) ), OPENAI_API_KEY,则 OPENROUTER_API_KEY。 。 。 .
primaryProvider 选择 openai, (中文(简体) ), openrouter 或者说 ollama。一个 OpenRouter 选项或环境键也会选择 OpenRouter 的终点,当 openaiApiKey 缺席。 奥拉马终点是本地的. 无空 DEBUG 允许控制台进度记录,除非每个调用进度回调优先.
工具
| 工具 | 它会做什么 |
|---|---|
researchInvestigate | 调查一个跨网络,学术,社会和新闻的有交叉参考的话题. |
researchAcademic | 在arXiv,谷歌学者或语义学者上搜索学术论文. |
researchScrape | 取自YouTube,维基百科,博客和通用网页的内容. |
researchAggregate | 搜索Serper,Brave和SerpAPI并返回由引擎分组的结果. |
researchTrending | 从Twitter,Reddit,YouTube或Hacker News中检索趋势. |
deep_research | 分解一个查询,搜索并提取出源,分析漏洞并用引用来合成一个报告. |
researchInvestigate
| 参数 | 类型 | 需求 | 说明 |
|---|---|---|---|
query | 字符串 | 对 | 研究查询或调查专题 |
sources | 字符串阵列, enum : web, (中文(简体) ), academic, (中文(简体) ), social, (中文(简体) ), news | 没有 | 要搜索的源( 默认值 : web, (中文(简体) ), academic, (中文(简体) ), news(中文(简体) ) |
maxResults | 编号 | 没有 | 每个源的最大结果( 默认) 10(中文(简体) ) |
researchAcademic
| 参数 | 类型 | 需求 | 说明 |
|---|---|---|---|
query | 字符串 | 对 | 学术搜索查询(关键词、纸张标题、作者名称) |
source | 字符串, enum : arxiv, (中文(简体) ), scholar, (中文(简体) ), semantic | 没有 | 要搜索的学术来源( 默认 ): arxiv(中文(简体) ) |
maxResults | 编号 | 没有 | 返回的最大纸张数量( 默认) 10(中文(简体) ) |
researchScrape
| 参数 | 类型 | 需求 | 说明 |
|---|---|---|---|
url | 字符串 | 对 | 要从中刮取内容的 URL |
type | 字符串, enum : youtube, (中文(简体) ), wikipedia, (中文(简体) ), blog, (中文(简体) ), generic | 没有 | 平台特定提取的内容类型( 默认 : generic(中文(简体) ) |
researchAggregate
| 参数 | 类型 | 需求 | 说明 |
|---|---|---|---|
query | 字符串 | 对 | 搜索查询 |
engines | 字符串阵列, enum : serper, (中文(简体) ), brave, (中文(简体) ), serpapi | 没有 | 要查询的搜索引擎( 默认 ): serper(中文(简体) ) |
maxResults | 编号 | 没有 | 每个引擎的最大结果( 默认) 10(中文(简体) ) |
researchTrending
| 参数 | 类型 | 需求 | 说明 |
|---|---|---|---|
platform | 字符串, enum : twitter, (中文(简体) ), reddit, (中文(简体) ), youtube, (中文(简体) ), hackernews | 没有 | 发现趋势的平台( 默认 ): hackernews(中文(简体) ) |
category | 字符串 | 没有 | 分类或子编辑以过滤趋势( 可选) |
deep_research
| 参数 | 类型 | 需求 | 说明 |
|---|---|---|---|
query | 字符串 | 对 | 研究问题或待调查的专题 |
depth | 字符串, enum : quick, (中文(简体) ), moderate, (中文(简体) ), deep; 默认 : moderate | 没有 | 研究深度:快速(30000 女士们, 10 搜索),中度(120000 女士们, 20 搜索),深度(540000 女士们, 50 搜索) |
maxIterations | 最小整数 1最大值 10 | 没有 | 最大搜索- 提取- 分析重迭 |
sources | 字符串阵列, enum : web, (中文(简体) ), academic, (中文(简体) ), news, (中文(简体) ), social | 没有 | 要搜索的源类型 |
focusAreas | 字符串数组 | 没有 | 需要重点关注的具体方面 |
页:1
名单要求 serper.apiKey,但工厂不拒绝 丢失的钥匙。 没有它, deep_research 使用 DuckDuckGo HTML 搜索。 有了它,引擎使用聚合搜索;空的提供者结果不会触发 DuckDuckGo. 勇者与 SerpAPI 在键缺失时被跳过 。 调查和汇总搜索跳过失败的源或引擎.
服务辅助工具需要激活. deep_research 声明 capability:web_search 并验证 query 至少已经 3 字符键。 内容 sources 输入会传递到搜索方法,但不会过滤搜索。 没有 LLM 密钥,引擎会搜索原始查询;当它收集内容并保留 LLM 预算时,它的No-op 合成返回一个空摘要. 已配置的 LLM 调用将研究提示和源证据发送到选定的端点.
YouTube 刮取返回 oEmbed 元数据,而不是记录誊本. 维基百科刮取使用英语摘要终点. 调查交叉引用匹配共享标题词. 趋势 category 影响 Reddit; 其他提供者忽略它 .
服务 HTTP 请求使用 a 30000 ms 超时; 通用刮取和引擎页面提取使用 15000 m. 将文本切换到 10000 字符键。 引擎跟踪搜索、提取、 LLM 和过时预算,默认重复限制为 1 页:1 quick, (中文(简体) ), 3 页:1 moderate 财务报告和审定财务报表 6 页:1 deep。这些检查不会取消飞行中搜索或LLM请求.
Firecrawl支持存在于引擎中,但包工厂并没有将Firecrawl设置传递给它.
许可证
阿帕奇 - 2.0