Integrazione CrewAI

Scavio è disponibile come pacchetto di strumenti pronto all'uso per CrewAI, il framework per orchestrare agenti autonomi che interpretano ruoli. Installa crewai-scavio e affida qualsiasi strumento a un Agent di CrewAI per dargli ricerca in tempo reale su Google, Amazon, Walmart, YouTube, Reddit, TikTok e Instagram — un pacchetto, una chiave API, nessun codice HTTP personalizzato.

Prerequisiti

1. Python 3.10 o successivo.
2. Una chiave API Scavio da dashboard.scavio.dev.

Installazione

pip install crewai-scavio

Il framework crewai e l'SDK Python scavio vengono installati come dipendenze.

Imposta la tua chiave API

export SCAVIO_API_KEY=sk_live_your_key

Ogni strumento legge SCAVIO_API_KEY dall'ambiente. Puoi anche passarla esplicitamente: ScavioSearchTool(api_key="sk_live_...").

Guida rapida

from crewai import Agent, Crew, Task
from crewai_scavio import ScavioSearchTool

researcher = Agent(
    role="Research Analyst",
    goal="Find accurate, up-to-date information on any topic",
    backstory="An expert researcher who finds reliable sources.",
    tools=[ScavioSearchTool()],
    verbose=True,
)

task = Task(
    description="Research the top 3 trends in AI agents for 2026.",
    expected_output="A summary of the top 3 trends with sources.",
    agent=researcher,
)

crew = Crew(agents=[researcher], tasks=[task], verbose=True)
print(crew.kickoff())

Usa più provider

Importa solo gli strumenti di cui un agente ha bisogno — ogni provider è la propria classe di strumento:

from crewai_scavio import (
    ScavioSearchTool,          # Google web search
    ScavioAmazonSearchTool,    # Amazon product search
    ScavioYouTubeSearchTool,   # YouTube video search
    ScavioRedditSearchTool,    # Reddit post search
)

agent = Agent(
    role="Market Researcher",
    goal="Compare products and gather public sentiment",
    tools=[ScavioAmazonSearchTool(), ScavioRedditSearchTool()],
)

Strumenti disponibili

32 strumenti su 7 provider. Tutti seguono la convenzione di denominazione Scavio<Provider><Action>Tool.

Come funziona

Ogni strumento è un BaseTool di CrewAI con uno schema di argomenti tipizzato, così l'agente riceve suggerimenti accurati sugli argomenti e CrewAI valida le chiamate prima che vengano eseguite. Le chiamate passano attraverso l'SDK Python scavio, che gestisce autenticazione, limitazione della frequenza e formattazione delle richieste. I risultati vengono restituiti all'agente come dati strutturati.

Costi in crediti

La maggior parte delle chiamate costa 1 credito. Reddit costa 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

• crewai-scavio su PyPI
• crewai-scavio su GitHub
• Documentazione CrewAI
• Guida rapida API Scavio
• Riferimento API Google Search