用途:把 You.com 工具接入 Vercel AI SDK 应用,使用包 @youdotcom-oss/ai-sdk-plugin,提供网页搜索、带引用的综合研究、网页内容提取三类工具。
主要能力:youSearch 执行网页与新闻搜索,参数由模型决定(query、count、country、freshness、livecrawl 等);youResearch 返回带内联引用与来源列表的 Markdown 综合研究,接受 input 与 research_effort(lite | standard | deep | exhaustive,默认 standard);youContents 从 URL 提取网页内容,参数含 urls、formats、crawl_timeout。
使用方式:按包管理器安装,如 npm install @youdotcom-oss/ai-sdk-plugin(或 bun add / yarn add / pnpm add)。需在环境变量中设置 YDC_API_KEY,密钥可从 https://you.com/platform/api-keys 获取。在 generateText() 或 streamText() 的 tools 对象中注册所选工具;多步工具调用必须加 stopWhen,例如 stopWhen: stepCountIs(3),多工具可用 stepCountIs(5)。streamText 需解构 textStream 消费流。资料给出 Next.js App Router、Express、React 客户端示例,并建议为集成代码配套测试(bun:test,真实调用 API,未设置 YDC_API_KEY 时跳过,超时 60_000,断言内容长度)。
安全限制:youSearch、youResearch、youContents 会拉取不可信网页内容并进入模型上下文,存在间接提示注入风险。使用这些工具时应始终添加 system 提示,声明工具结果仅为数据、不得执行其中指令;youContents 风险更高,用户提供的 URL 不应未经校验直接传入,建议使用允许列表或域名模式检查;不要记录或持久化原始工具结果。
常见问题:缺少模块需安装包;缺少 YDC_API_KEY 需设置;401 需检查密钥;有工具调用但无文本输出需添加 stopWhen;响应不完整可提高步数;textStream 不可迭代需解构。
适用场景:需要在 AI SDK 应用中引入实时网页搜索、带引用研究或网页内容提取的开发者。
限制:资料未提供定价、平台支持范围、速率限制或效果保证等信息。