Integração Composio

A Scavio é distribuída como um toolkit personalizado para o Composio, a camada de ferramentas que conecta seus agentes a serviços externos em todos os principais frameworks. Construa o toolkit Scavio, vincule-o a uma sessão do Composio, e qualquer agente alimentado pelo Composio ganha busca em tempo real no Google, YouTube, Amazon, Walmart, Reddit, TikTok e Instagram — um toolkit, uma chave de API. Disponível tanto para Python quanto para TypeScript.

Pré-requisitos

1. Python 3.9+ ou Node.js 18+.
2. Uma chave de API do Scavio de dashboard.scavio.dev.
3. Uma chave de API do Composio de app.composio.dev.

Instalar

# Python
pip install composio composio-scavio

# TypeScript
npm install @composio/core composio-scavio

Ambos os pacotes envolvem o SDK oficial da Scavio e expõem cada endpoint como uma ferramenta personalizada do Composio, agrupada sob um único toolkit SCAVIO.

Defina suas chaves de API

export SCAVIO_API_KEY=sk_live_your_key
export COMPOSIO_API_KEY=your_composio_key

O toolkit lê SCAVIO_API_KEY do ambiente. Você também pode passá-la explicitamente ao construir o toolkit.

Início rápido (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)

Início rápido (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);

Habilite apenas os provedores de que você precisa

Todos os provedores estão habilitados por padrão. Cada um é controlado por um indicador, então você pode expor uma lista de ferramentas enxuta ao modelo:

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

Passe all=True (Python) ou { all: true } (TypeScript) para registrar todas as ferramentas independentemente dos indicadores individuais.

Slugs das ferramentas

As ferramentas são agrupadas sob o toolkit SCAVIO. O slug exposto ao agente é o slug do toolkit mais o nome da ferramenta. Em Python o slug é SCAVIO_GOOGLE_SEARCH; em TypeScript o Composio adiciona seu prefixo reservado LOCAL_ para ferramentas personalizadas, então a mesma ferramenta é LOCAL_SCAVIO_GOOGLE_SEARCH. Use a forma correspondente ao chamar session.execute(...).

Ferramentas disponíveis

Cada endpoint da Scavio é exposto como uma ferramenta prefixada pelo provedor (32 no total). Os slugs abaixo omitem o prefixo SCAVIO_ / LOCAL_SCAVIO_ por brevidade.

Como funciona

Cada ferramenta retorna a resposta da Scavio como um objeto JSON que o modelo pode ler diretamente. As chamadas passam pelo SDK oficial da Scavio, que cuida da autenticação, da limitação de taxa e da formatação das requisições. Como as ferramentas são executadas no próprio processo, você fornece sua própria chave de API do Scavio — o Composio não faz proxy da requisição.

Custos de crédito

A maioria das chamadas custa 1 crédito. O Reddit e o Instagram custam 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

• Documentação do Composio
• composio-scavio no GitHub (Python)
• composio-scavio no GitHub (TypeScript)
• Início rápido da API Scavio
• Referência da API de Busca do Google