Skip to main content
Valyu 允许 AI 应用程序和代理搜索互联网及专有数据源，以获取适用于 LLM 的相关信息。
本 notebook 介绍如何在 LangChain 中使用 Valyu context 工具。 首先，获取 Valyu API 密钥并将其设置为环境变量。通过在此注册可获得 $10 免费额度。

​
概述

​
集成详情

ClassPackageSerializableJS supportVersion
Valyu Searchlangchain-valyu✅❌PyPI - Version

​
设置

集成位于 langchain-valyu 包中。 
pip install -qU langchain-valyu
使用该包前，您还需要将 VALYU_API_KEY 环境变量设置为您的 Valyu API 密钥。 
import getpass
import os

if not os.environ.get("VALYU_API_KEY"):
    os.environ["VALYU_API_KEY"] = getpass.getpass("Valyu API key:\n")

​
实例化

此处展示如何实例化 Valyu 搜索工具。该工具允许您通过 Valyu 的 Context API 端点完成搜索查询。 
from langchain_valyu import ValyuSearchTool

tool = ValyuSearchTool()

​
调用

​
直接传参调用

Valyu 搜索工具在调用时接受以下参数：
  • query（必填）：自然语言搜索查询
  • search_type（可选）：搜索类型，例如 “all”
  • max_num_results（可选）：返回结果的最大数量
  • similarity_threshold（可选）：结果的相似度阈值
  • query_rewrite（可选）：是否重写查询
  • max_price（可选）：搜索的最高费用
出于可靠性和性能原因，某些参数可能是必填或受限的。详情请参阅 Valyu API 文档。 
search_results = tool._run(
    query="What are agentic search-enhanced large reasoning models?",
    search_type="all",
    max_num_results=5,
    similarity_threshold=0.4,
    query_rewrite=False,
    max_price=20.0,
)

print("Search Results:", search_results)

​
在代理中使用

我们可以通过将工具绑定到代理来直接在代理执行器中使用工具。这使代理能够动态设置 Valyu 搜索工具的可用参数。 
if not os.environ.get("OPENAI_API_KEY"):
    os.environ["OPENAI_API_KEY"] = getpass.getpass("OPENAI_API_KEY:\n")

# | output: false
# | echo: false

# !pip install -qU langchain langchain-openai
from langchain.chat_models import init_chat_model

model = init_chat_model(model="gpt-4.1", model_provider="openai", temperature=0)

from langchain_valyu import ValyuSearchTool
from langchain.agents import create_agent


valyu_search_tool = ValyuSearchTool()

agent = create_agent(model, [valyu_search_tool])

user_input = "What are the key factors driving recent stock market volatility, and how do macroeconomic indicators influence equity prices across different sectors?"

for step in agent.stream(
    {"messages": user_input},
    stream_mode="values",
):
    step["messages"][-1].pretty_print()

​
API 参考

有关所有 Valyu Context API 功能和配置的详细文档，请访问 API 参考：docs.valyu.network/overview
Edit this page on GitHub or file an issue.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.