Vercel · AI SDK · Connect

让你的 Vercel 应用用上实时网页资料

为 AI SDK agent 添加搜索、新闻和网页阅读工具。需要在运行时获取用户授权的 Search1API 凭证时，可以使用 Vercel Connect。

选择你的 Vercel 集成

构建 AI SDK agent，可以从工具包开始；通过 Vercel 管理授权凭证，可以从连接器开始。

Vercel AI SDK 工具

给 agent 接上现成的联网工具。

使用 @search1api/ai-sdk 搜索网页、查找新闻和读取网页正文。

支持 AI SDK 的 generateText 和 streamText，包括 Next.js 应用。

安装 npm 包，在服务端配置 Search1API API key。

Vercel Connect

在运行时获取 Search1API 凭证。

连接 Search1API 账号，通过 @vercel/connect 请求授权访问。

适用于 Vercel 项目，可按项目和环境管理访问权限。

创建 Search1API 连接器，完成账号授权，再为用户请求 token。

搜索、阅读与引用最新资料

实时联网研究

在应用运行时查找最新文档、新闻和公开资料。

现成的 agent 工具

AI SDK 工具包处理工具 schema 和执行，让 agent 能搜索与阅读网页。

按需获取凭证

Vercel Connect 为已授权的用户按需获取访问凭证。

用实时信息构建应用

为 Next.js 聊天应用添加搜索与网页阅读。

研究近期新闻，返回带来源链接的回答。

在 Vercel 应用中使用已授权的 Search1API 账号。

开始接入

工具调用使用 AI SDK 包。Connect 命令在需要连接器的 Vercel 项目中执行；授权流程与运行时代码见 Vercel 接入指南。

AI SDK 工具：安装与配置 — bash
npm install @search1api/ai-sdk ai zod
export SEARCH1API_API_KEY="your-api-key"

AI SDK 工具：让 agent 搜索与阅读 — ts
import { gateway, generateText, stepCountIs } from 'ai';
import { search1apiTools } from '@search1api/ai-sdk';
const result = await generateText({
  model: gateway('openai/gpt-5-mini'),
  tools: search1apiTools({ only: ['search', 'crawl'] }),
  stopWhen: stepCountIs(5),
  prompt: 'Find the AI SDK tool calling docs, read them, and cite the URLs you used.',
});
console.log(result.text);

Vercel Connect：创建连接器 — bash
npm install @vercel/connect
vercel link
vercel connect create search1api --name acme-search1api
vercel env pull

运行前须知

API key 和 Connect token 均在服务端使用。

AI SDK 工具包使用 Search1API API key；模型提供商需要单独配置凭证。

Vercel Connect 需要关联项目、启用对应环境，并完成用户授权。

Search1API 请求使用所连接账号的积分，计费详情见接入指南。

常见问题

应该选择哪个集成？

需要现成的 AI SDK 工具时，使用 @search1api/ai-sdk；需要 Vercel 管理已授权 Search1API 账号的运行时访问时，使用 Vercel Connect。

AI SDK 工具包必须部署在 Vercel 吗？

不必。可以在兼容的服务端 JavaScript 环境中运行 AI SDK 应用。

Connect 会提供 AI SDK 工具吗？

Connect 提供运行时凭证；@search1api/ai-sdk 提供 search、news 和 crawl 的工具定义与执行。