ValyuContext

Valyu allows AI applications and agents to search the internet and proprietary data sources for relevant LLM ready information.

本笔记本介绍了如何在 LangChain 中使用 Valyu 上下文工具。

首先，获取一个Valyu API密钥并将其作为环境变量添加。通过在此处注册获得$10免费信用额度。

概览

集成详情

类	包	可序列化的	JS 支持	最新包裹
Valyu Search	langchain-valyu	✅	❌

设置

集成位于 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")

from langchain_valyu import ValyuSearchTool
from langgraph.prebuilt import create_react_agent

valyu_search_tool = ValyuSearchTool()

agent = create_react_agent(llm, [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 参考：create_react_agent

API 参考

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

相关

• 工具 概念指南
• 工具 如何使用指南