Integrazione Composio

Scavio è disponibile come toolkit personalizzato per Composio, il livello di strumenti che collega i tuoi agenti a servizi esterni in tutti i principali framework. Costruisci il toolkit Scavio, collegalo a una sessione Composio e qualsiasi agente basato su Composio ottiene ricerca in tempo reale su Google, YouTube, Amazon, Walmart, Reddit, TikTok e Instagram — un toolkit, una chiave API. Disponibile sia per Python che per TypeScript.

Prerequisiti

1. Python 3.9 o successivo, oppure Node.js 18 o successivo.
2. Una chiave API Scavio da dashboard.scavio.dev.
3. Una chiave API Composio da app.composio.dev.

Installazione

# Python
pip install composio composio-scavio

# TypeScript
npm install @composio/core composio-scavio

Entrambi i pacchetti incapsulano l'SDK Scavio ufficiale ed espongono ogni endpoint come strumento personalizzato Composio, raggruppato sotto un unico toolkit SCAVIO.

Imposta le tue chiavi API

export SCAVIO_API_KEY=sk_live_your_key
export COMPOSIO_API_KEY=your_composio_key

Il toolkit legge SCAVIO_API_KEY dall'ambiente. Puoi anche passarla esplicitamente quando costruisci il toolkit.

Guida rapida (Python)

from composio import Composio
from composio_scavio import build_scavio_toolkit

composio = Composio()
scavio = build_scavio_toolkit()  # reads SCAVIO_API_KEY

session = composio.create(
    user_id="user_1",
    experimental={"custom_toolkits": [scavio]},
)

# Hand the tools to your agent, or call one directly:
result = session.execute(
    "SCAVIO_GOOGLE_SEARCH",
    arguments={"query": "best search API for AI agents", "light_request": True},
)
print(result)

Guida rapida (TypeScript)

import { Composio } from "@composio/core";
import { buildScavioToolkit } from "composio-scavio";

const composio = new Composio();
const scavio = buildScavioToolkit(); // reads SCAVIO_API_KEY

const session = await composio.create("user_1", {
  experimental: { customToolkits: [scavio] },
});

const out = await session.execute("LOCAL_SCAVIO_GOOGLE_SEARCH", {
  query: "best search API for AI agents",
  light_request: true,
});
console.log(out);

Abilita solo i provider di cui hai bisogno

Ogni provider è abilitato per impostazione predefinita. Ciascuno è controllato da un flag, così puoi esporre al modello un elenco di strumenti ridotto:

# Python: web-only toolkit (Google, YouTube, Reddit)
scavio = build_scavio_toolkit(
    enable_google=True,
    enable_youtube=True,
    enable_reddit=True,
    enable_amazon=False,
    enable_walmart=False,
    enable_tiktok=False,
    enable_instagram=False,
)

// TypeScript: same idea
const scavio = buildScavioToolkit({
  enableGoogle: true,
  enableYoutube: true,
  enableReddit: true,
  enableAmazon: false,
  enableWalmart: false,
  enableTiktok: false,
  enableInstagram: false,
});

Passa all=True (Python) o { all: true } (TypeScript) per registrare ogni strumento indipendentemente dai singoli flag.

Slug degli strumenti

Gli strumenti sono raggruppati sotto il toolkit SCAVIO. Lo slug esposto all'agente è lo slug del toolkit più il nome dello strumento. In Python lo slug è SCAVIO_GOOGLE_SEARCH; in TypeScript Composio antepone il suo prefisso riservato LOCAL_ per gli strumenti personalizzati, quindi lo stesso strumento è LOCAL_SCAVIO_GOOGLE_SEARCH. Usa la forma corrispondente quando chiami session.execute(...).

Strumenti disponibili

Ogni endpoint di Scavio è esposto come uno strumento con prefisso del provider (32 in totale). Gli slug riportati di seguito omettono il prefisso SCAVIO_ / LOCAL_SCAVIO_ per brevità.

Come funziona

Ogni strumento restituisce la risposta di Scavio come un oggetto JSON che il modello può leggere direttamente. Le chiamate passano attraverso l'SDK Scavio ufficiale, che gestisce autenticazione, limitazione della frequenza e formattazione delle richieste. Poiché gli strumenti vengono eseguiti nello stesso processo, fornisci la tua chiave API Scavio — Composio non fa da proxy per la richiesta.

Costi in crediti

La maggior parte delle chiamate costa 1 credito. Reddit e Instagram costano 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 sugli errori per indicazioni sui tentativi.

Risorse

• Documentazione Composio
• composio-scavio su GitHub (Python)
• composio-scavio su GitHub (TypeScript)
• Guida rapida API Scavio
• Riferimento API Google Search