Integração CrewAI

A Scavio é distribuída como um pacote de ferramentas pronto para o CrewAI, o framework para orquestrar agentes autônomos que interpretam papéis. Instale crewai-scavio e entregue qualquer ferramenta a um Agent do CrewAI para dar a ele busca em tempo real no Google, Amazon, Walmart, YouTube, Reddit, TikTok e Instagram — um pacote, uma chave de API, nenhum código HTTP personalizado.

Pré-requisitos

1. Python 3.10 ou posterior.
2. Uma chave de API do Scavio de dashboard.scavio.dev.

Instalar

pip install crewai-scavio

O framework crewai e o SDK Python scavio são trazidos como dependências.

Defina sua chave de API

export SCAVIO_API_KEY=sk_live_your_key

Cada ferramenta lê SCAVIO_API_KEY do ambiente. Você também pode passá-la explicitamente: ScavioSearchTool(api_key="sk_live_...").

Início rápido

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

Usar mais provedores

Importe apenas as ferramentas de que um agente precisa — cada provedor é sua própria classe de ferramenta:

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()],
)

Ferramentas disponíveis

32 ferramentas em 7 provedores. Todas seguem a convenção de nomenclatura Scavio<Provider><Action>Tool.

Como funciona

Cada ferramenta é uma BaseTool do CrewAI com um esquema de argumentos tipado, então o agente recebe dicas precisas de argumentos e o CrewAI valida as chamadas antes de executá-las. As chamadas passam pelo SDK Python scavio, que cuida da autenticação, da limitação de taxa e da formatação das requisições. Os resultados são retornados ao agente como dados estruturados.

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

• crewai-scavio no PyPI
• crewai-scavio no GitHub
• Documentação do CrewAI
• Início rápido da API Scavio
• Referência da API de Busca do Google