Integracion con Vercel AI SDK

Scavio se distribuye como un conjunto de herramientas listas para usar con el Vercel AI SDK. Importa las herramientas desde @scavio/ai-sdk y pasalas a generateText o streamText para dar a cualquier agente del AI SDK busqueda en tiempo real en Google, YouTube, Reddit, Amazon, Walmart, TikTok e Instagram — un solo paquete, una sola clave API, sin codigo HTTP personalizado.

Requisitos previos

1. Node.js 18 o posterior.
2. Una clave API de Scavio obtenida en dashboard.scavio.dev.

Instalacion

npm install @scavio/ai-sdk ai

ai y zod son dependencias peer; el SDK de JavaScript scavio viene incluido y se invoca internamente.

Configura tu clave API

export SCAVIO_API_KEY=sk_live_your_key

Cada fabrica de herramientas lee SCAVIO_API_KEY del entorno. Tambien puedes pasarla explicitamente: scavioSearch({ apiKey: "sk_live_..." }).

Inicio rapido

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

Usar una sola herramienta

Cada proveedor tambien se exporta como su propia fabrica, de modo que puedes exponer al modelo una lista de herramientas mas reducida:

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

Cada fabrica acepta { apiKey?, maxResults?, ...ScavioConfig }. maxResults recorta los arreglos results largos antes de que lleguen al modelo (por defecto 10), reduciendo el consumo de tokens.

Herramientas disponibles

scavioTools() devuelve todas las herramientas indexadas por nombre, listas para esparcir en la opcion tools. O importa las fabricas de forma individual.

Como funciona

Cada herramienta es una tool() estandar del AI SDK con un esquema de entrada tipado en Zod, de modo que el modelo recibe sugerencias precisas de argumentos y el SDK valida las llamadas antes de ejecutarlas. Las llamadas pasan por el SDK de JavaScript scavio, que se encarga de la autenticacion, el rate limiting y el formato de las peticiones. Los resultados de las herramientas se devuelven al modelo como la respuesta JSON sin procesar de Scavio.

Costo en creditos

La mayoria de las llamadas cuesta 1 credito. Reddit cuesta 2 creditos, y Google cuesta 2 cuando light_request=false. Consulta la referencia de limites de tasa para conocer los limites por plan y la referencia de errores para orientacion sobre reintentos.

Recursos

• @scavio/ai-sdk en npm
• Documentacion del Vercel AI SDK
• SDK de JavaScript scavio en npm
• Inicio rapido de la API de Scavio
• Referencia de la API de Google Search