ウェブ検索

概要

WebSearchを使用すると、エージェントがReActループ中にウェブを検索できます。2つのモードがあります。

• Schift Cloud（デフォルト） — Schiftを通じてプロキシされ、使用量に応じて請求されます
• BYOK — 自分のAPIキーを使用してTavily、Serper、またはBraveに直接呼び出します

Schift Cloudモード

import { Schift, WebSearch } from "@schift-io/sdk";

const schift = new Schift({ apiKey: "sch_..." });
const webSearch = new WebSearch({}, schift.transport);

const results = await webSearch.search("AI regulations 2026");
// [{ title, url, snippet }, ...]

BYOKモード

Tavily

const webSearch = new WebSearch({
  provider: "tavily",
  providerApiKey: "tvly-xxx",
  maxResults: 10,
});

Serper

const webSearch = new WebSearch({
  provider: "serper",
  providerApiKey: "serper-xxx",
});

Brave

const webSearch = new WebSearch({
  provider: "brave",
  providerApiKey: "brave-xxx",
});

エージェントツールとして

const agent = new Agent({
  name: "Researcher",
  instructions: "最新の情報が必要なときにウェブを検索します。",
  tools: [webSearch.asTool()],
  transport: schift.transport,
});

このツールはweb_searchとして登録されます。LLMはリアルタイムの情報が必要なときにこれを呼び出します。

設定

オプション	型	デフォルト	説明
maxResults	number	5	検索ごとの結果数
provider	"schift" | "tavily" | "serper" | "brave"	"schift"	検索プロバイダー
providerApiKey	string	—	BYOKプロバイダー用のAPIキー