>Valyu 允许 AI 应用程序和代理搜索互联网和专有数据源，获取相关的 LLM 就绪信息。

本笔记本介绍如何在 LangChain 中使用 Valyu context 工具。

首先，获取 Valyu API 密钥并将其添加为环境变量。通过 在此注册.

概述

集成详情

设置

该集成位于 langchain-valyu package.

pip install -qU langchain-valyu

为了使用该包，您还需要设置 VALYU_API_KEY 环境变量为您的 Valyu API 密钥。

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-5.5", 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?"

stream = agent.stream_events(
    {"messages": user_input},
    version="v3",
)
for snapshot in stream.values:
    snapshot["messages"][-1].pretty_print()

API 参考

有关所有 Valyu Context API 功能和配置的详细文档，请前往 API 参考： docs.valyu.network/overview