LangChain es el marco de Python más utilizado para crear aplicaciones basadas en LLM. Agregar búsqueda web en tiempo real a una aplicación LangChain la transforma de depender de un límite de entrenamiento estático a acceder a información en vivo. El paquete langchain-scavio proporciona una herramienta ScavioSearch plug-and-play compatible con la interfaz de herramientas de LangChain, las cadenas LCEL y los ejecutores de agentes. Este tutorial cubre la instalación, configuración y tres patrones de integración comunes: llamada de herramienta independiente, cadena LCEL y agente ReAct.
Requisitos previos
- Python 3.10 o superior
- pip instalar langchain langchain-scavio langchain-openai
- Una clave API de Scavio
- Una clave API LLM compatible con LangChain
Guia paso a paso
Paso 1: Instalar langchain-scavio
Instale el paquete de integración. Proporciona ScavioSearch como una subclase de BaseTool con plataforma, país y recuento de resultados configurables.
pip install langchain langchain-scavio langchain-openaiPaso 2: Utilice ScavioSearch como herramienta independiente
Invoque ScavioSearch directamente sin un agente para verificar la integración e inspeccionar los datos devueltos.
from langchain_scavio import ScavioSearch
tool = ScavioSearch(api_key="your_scavio_api_key", platform="google", country_code="us")
result = tool.invoke("latest LLM releases 2026")
print(result[:500]) # Returns formatted string of top resultsPaso 3: Agregar a una cadena LCEL
Vincule ScavioSearch como un recuperador de contexto en una cadena LCEL que obtiene resultados de búsqueda antes de generar una respuesta.
from langchain_openai import ChatOpenAI
from langchain_core.prompts import ChatPromptTemplate
from langchain_core.output_parsers import StrOutputParser
llm = ChatOpenAI(model="gpt-4o")
prompt = ChatPromptTemplate.from_template("Answer using this context:\n{context}\n\nQuestion: {question}")
chain = ({"context": tool, "question": lambda x: x}) | prompt | llm | StrOutputParser()
result = chain.invoke("What are the best Python AI libraries in 2026?")Paso 4: Vincularse a un agente de llamada de herramientas
Registre ScavioSearch con un agente de llamadas de herramientas para que el LLM pueda decidir cuándo buscar.
llm_with_tools = ChatOpenAI(model="gpt-4o").bind_tools([tool])
response = llm_with_tools.invoke("What is the current price of gold?")
print(response.tool_calls)Ejemplo en Python
import os
from langchain_scavio import ScavioSearch
from langchain_openai import ChatOpenAI
from langchain_core.prompts import ChatPromptTemplate
from langchain_core.output_parsers import StrOutputParser
os.environ["OPENAI_API_KEY"] = "your_openai_key"
tool = ScavioSearch(api_key=os.environ["SCAVIO_API_KEY"], platform="google", country_code="us", max_results=5)
llm = ChatOpenAI(model="gpt-4o", temperature=0)
prompt = ChatPromptTemplate.from_template(
"Use the following search results to answer the question.\nResults: {context}\nQuestion: {question}"
)
chain = ({"context": tool, "question": lambda x: x}) | prompt | llm | StrOutputParser()
if __name__ == "__main__":
answer = chain.invoke("What are the top Python libraries for building AI agents in 2026?")
print(answer)Ejemplo en JavaScript
const { ChatOpenAI } = require("@langchain/openai");
const { DynamicTool } = require("@langchain/core/tools");
const API_KEY = process.env.SCAVIO_API_KEY;
// langchain-scavio is Python-only; use DynamicTool in JS
const scavioTool = new DynamicTool({
name: "scavio_google_search",
description: "Search Google for current information. Returns top organic results.",
func: async (query) => {
const res = await fetch("https://api.scavio.dev/api/v1/search", {
method: "POST",
headers: { "x-api-key": API_KEY, "Content-Type": "application/json" },
body: JSON.stringify({ query, country_code: "us" })
});
const data = await res.json();
return (data.organic_results || []).slice(0, 5)
.map(r => `${r.title}: ${r.snippet || ""}`).join("\n");
}
});
async function main() {
const result = await scavioTool.invoke("best Python AI libraries 2026");
console.log(result);
}
main().catch(console.error);Salida esperada
Answer: Based on 2026 search results, the top Python AI libraries include:
1. LangChain — agent orchestration and LLM chains
2. LlamaIndex — data framework for LLM apps
3. CrewAI — multi-agent coordination
4. Haystack — production RAG pipelines
5. Pydantic AI — structured output agents