跳到主要内容
Valyu 允许 AI 应用和代理搜索互联网和专有数据源，以获取 LLM 就绪的相关信息。
本笔记本介绍了如何在 LangChain 中使用 Valyu 上下文工具。 首先，获取一个 Valyu API 密钥并将其添加为环境变量。通过在此注册获得 10 美元免费积分。

​
概览

​
集成详情

类别包可序列化JS 支持版本
Valyu 搜索langchain-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 的上下文 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-4o", 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
在 GitHub 上编辑此页面源文件。
以编程方式连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.