Vercel AI SDK 통합

Scavio는 Vercel AI SDK를 위한 즉시 사용 가능한 도구 모음으로 제공됩니다. @scavio/ai-sdk에서 도구를 가져와 generateText 또는 streamText에 전달하면 모든 AI SDK 에이전트에 Google, YouTube, Reddit, Amazon, Walmart, TikTok, Instagram 전반의 실시간 검색 기능을 추가할 수 있습니다 — 하나의 패키지, 하나의 API 키로, 별도의 HTTP 코드 없이 사용할 수 있습니다.

전제 조건

1. Node.js 18 이상.
2. dashboard.scavio.dev에서 발급한 Scavio API 키.

설치

npm install @scavio/ai-sdk ai

ai와 zod는 피어 의존성이며, scavio JS SDK는 내부에 번들로 포함되어 자동으로 호출됩니다.

API 키 설정

export SCAVIO_API_KEY=sk_live_your_key

각 도구 팩토리는 환경에서 SCAVIO_API_KEY를 읽습니다. 다음과 같이 명시적으로 전달할 수도 있습니다: scavioSearch({ apiKey: "sk_live_..." }).

빠른 시작

import { generateText, stepCountIs } from "ai";
import { openai } from "@ai-sdk/openai";
import { scavioTools } from "@scavio/ai-sdk";

const { text } = await generateText({
  model: openai("gpt-4o-mini"),
  tools: scavioTools(),
  stopWhen: stepCountIs(3),
  prompt: "Find the official GitHub repo of the Agno framework and summarize it",
});

console.log(text);

단일 도구 사용

모든 제공자는 각자의 팩토리로도 내보내지므로, 모델에 간결한 도구 목록만 노출할 수 있습니다:

import { generateText, stepCountIs } from "ai";
import { openai } from "@ai-sdk/openai";
import { scavioSearch, scavioAmazonSearch } from "@scavio/ai-sdk";

const { text } = await generateText({
  model: openai("gpt-4o-mini"),
  tools: {
    scavio_search: scavioSearch({ maxResults: 5 }),
    scavio_amazon_search: scavioAmazonSearch(),
  },
  stopWhen: stepCountIs(3),
  prompt: "Compare prices for a mechanical keyboard on Amazon",
});

각 팩토리는 { apiKey?, maxResults?, ...ScavioConfig }를 받습니다. maxResults는 긴 results 배열이 모델에 도달하기 전에 잘라내어(기본값 10) 토큰 사용량을 줄입니다.

사용 가능한 도구

scavioTools()는 이름을 키로 하는 모든 도구를 반환하므로, tools 옵션에 바로 펼쳐 넣을 수 있습니다. 또는 팩토리를 개별적으로 가져올 수도 있습니다.

작동 방식

각 도구는 타입이 지정된 Zod 입력 스키마를 갖춘 표준 AI SDK tool()이므로, 모델은 정확한 인수 힌트를 받고 SDK는 호출이 실행되기 전에 이를 검증합니다. 호출은 인증, 속도 제한, 요청 형식을 처리하는 scavio JS SDK를 거칩니다. 도구 결과는 가공되지 않은 Scavio JSON 응답 그대로 모델에 반환됩니다.

크레딧 비용

대부분의 호출은 1크레딧입니다. Reddit은 2크레딧이며, Google은 light_request=false일 때 2크레딧입니다. 플랜별 제한은 속도 제한 참조를, 재시도 지침은 오류 참조를 확인하세요.

리소스

• npm의 @scavio/ai-sdk
• Vercel AI SDK 문서
• npm의 scavio JS SDK
• Scavio API 빠른 시작
• Google Search API 참조