Intégration Vercel AI SDK

Scavio est fourni sous forme d'outils prêts à l'emploi pour le Vercel AI SDK. Importez les outils depuis @scavio/ai-sdk et passez-les à generateText ou streamText pour donner à n'importe quel agent de l'AI SDK une recherche en temps réel sur Google, YouTube, Reddit, Amazon, Walmart, TikTok et Instagram — un seul package, une seule clé API, aucun code HTTP personnalisé.

Prérequis

1. Node.js 18 ou ultérieur.
2. Une clé API Scavio depuis dashboard.scavio.dev.

Installation

npm install @scavio/ai-sdk ai

ai et zod sont des dépendances de pair ; le SDK JS scavio est intégré et appelé en coulisses.

Définir votre clé API

export SCAVIO_API_KEY=sk_live_your_key

Chaque fabrique d'outil lit SCAVIO_API_KEY depuis l'environnement. Vous pouvez aussi la passer explicitement : scavioSearch({ apiKey: "sk_live_..." }).

Démarrage rapide

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

Utiliser un seul outil

Chaque fournisseur est également exporté comme sa propre fabrique, vous pouvez donc exposer au modèle une liste d'outils épurée :

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

Chaque fabrique accepte { apiKey?, maxResults?, ...ScavioConfig }. maxResults raccourcit les longs tableaux results avant qu'ils n'atteignent le modèle (par défaut 10), réduisant ainsi la consommation de jetons.

Outils disponibles

scavioTools() renvoie chaque outil indexé par son nom, prêt à être intégré dans l'option tools. Vous pouvez aussi importer les fabriques individuellement.

Comment ça fonctionne

Chaque outil est un tool() standard de l'AI SDK avec un schéma d'entrée Zod typé, de sorte que le modèle obtient des indications d'arguments précises et que le SDK valide les appels avant leur exécution. Les appels passent par le SDK JS scavio, qui gère l'authentification, la limitation de débit et le formatage des requêtes. Les résultats des outils sont renvoyés au modèle sous forme de réponse JSON brute de Scavio.

Coûts en crédits

La plupart des appels coûtent 1 crédit. Reddit coûte 2 crédits, et Google coûte 2 lorsque light_request=false. Consultez la référence des limites de débit pour les limites de plan et la référence des erreurs pour les conseils de réessai.

Ressources

• @scavio/ai-sdk sur npm
• Documentation du Vercel AI SDK
• SDK JS scavio sur npm
• Démarrage rapide de l'API Scavio
• Référence de l'API Google Search