Integração Vercel AI SDK

A Scavio é disponibilizada como um conjunto de ferramentas prontas para o Vercel AI SDK. Importe as ferramentas de @scavio/ai-sdk e passe-as para generateText ou streamText para dar a qualquer agente do AI SDK busca em tempo real no Google, YouTube, Reddit, Amazon, Walmart, TikTok e Instagram — um pacote, uma chave de API, sem código HTTP personalizado.

Pré-requisitos

1. Node.js 18 ou posterior.
2. Uma chave de API do Scavio de dashboard.scavio.dev.

Instalar

npm install @scavio/ai-sdk ai

ai e zod são dependências de par (peer dependencies); o SDK JS scavio é empacotado e chamado internamente.

Defina sua chave de API

export SCAVIO_API_KEY=sk_live_your_key

Cada fábrica de ferramenta lê SCAVIO_API_KEY do ambiente. Você também pode passá-la explicitamente: scavioSearch({ apiKey: "sk_live_..." }).

Início rápido

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 uma única ferramenta

Cada provedor também é exportado como sua própria fábrica, então você pode expor uma lista enxuta de ferramentas ao modelo:

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 fábrica aceita { apiKey?, maxResults?, ...ScavioConfig }. maxResults reduz arrays de results longos antes que cheguem ao modelo (padrão de 10), mantendo o uso de tokens baixo.

Ferramentas disponíveis

scavioTools() retorna cada ferramenta indexada por nome, pronta para ser espalhada na opção tools. Ou importe as fábricas individualmente.

Como funciona

Cada ferramenta é uma tool() padrão do AI SDK com um schema de entrada Zod tipado, então o modelo recebe dicas precisas de argumentos e o SDK valida as chamadas antes de executá-las. As chamadas passam pelo SDK JS scavio, que cuida da autenticação, da limitação de taxa e da formatação das requisições. Os resultados das ferramentas são retornados ao modelo como a resposta JSON bruta da Scavio.

Custos de crédito

A maioria das chamadas custa 1 crédito. O Reddit custa 2 créditos, e o Google custa 2 quando light_request=false. Consulte a referência de limites de taxa para os limites de plano e a referência de erros para orientação sobre nova tentativa.

Recursos

• @scavio/ai-sdk no npm
• Documentação do Vercel AI SDK
• SDK JS scavio no npm
• Início rápido da API Scavio
• Referência da API de Busca do Google