Integrazione Vercel AI SDK

Scavio è distribuito come un set di strumenti pronti all'uso per il Vercel AI SDK. Importa gli strumenti da @scavio/ai-sdk e passali a generateText o streamText per dare a qualsiasi agente AI SDK la ricerca in tempo reale su Google, YouTube, Reddit, Amazon, Walmart, TikTok e Instagram — un solo pacchetto, una sola chiave API, nessun codice HTTP personalizzato.

Prerequisiti

1. Node.js 18 o successivo.
2. Una chiave API Scavio da dashboard.scavio.dev.

Installazione

npm install @scavio/ai-sdk ai

ai e zod sono dipendenze peer; l'SDK JS scavio è incluso e richiamato internamente.

Imposta la tua chiave API

export SCAVIO_API_KEY=sk_live_your_key

Ogni factory di strumenti legge SCAVIO_API_KEY dall'ambiente. Puoi anche passarla esplicitamente: scavioSearch({ apiKey: "sk_live_..." }).

Guida rapida

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);

Usa un singolo strumento

Ogni provider è esportato anche come factory a sé stante, così puoi esporre al modello un elenco di strumenti ridotto:

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",
});

Ogni factory accetta { apiKey?, maxResults?, ...ScavioConfig }. maxResults riduce gli array results lunghi prima che raggiungano il modello (valore predefinito 10), contenendo l'uso dei token.

Strumenti disponibili

scavioTools() restituisce ogni strumento indicizzato per nome, pronto da inserire nell'opzione tools. Oppure importa le factory singolarmente.

Come funziona

Ogni strumento è un normale tool() dell'AI SDK con uno schema di input Zod tipizzato, così il modello riceve suggerimenti accurati sugli argomenti e l'SDK convalida le chiamate prima che vengano eseguite. Le chiamate passano attraverso l'SDK JS scavio, che gestisce autenticazione, limitazione della velocità e formattazione delle richieste. I risultati degli strumenti vengono restituiti al modello come risposta JSON Scavio grezza.

Costi in crediti

La maggior parte delle chiamate costa 1 credito. Reddit costa 2 crediti e Google costa 2 quando light_request=false. Consulta il riferimento sui limiti di velocità per i limiti dei piani e il riferimento agli errori per indicazioni sui tentativi.

Risorse

• @scavio/ai-sdk su npm
• Documentazione Vercel AI SDK
• SDK JS scavio su npm
• Guida rapida API Scavio
• Riferimento API Google Search