Skip to main content
本笔记本简要概述了如何开始使用 DuckDuckGoSearch。有关所有 DuckDuckGoSearch 功能和配置的详细文档，请访问 API 参考。 DuckDuckGoSearch 提供了一个专为 LLM 代理设计的注重隐私的搜索 API。它与广泛的数据源无缝集成，优先考虑用户隐私和相关搜索结果。

​
概览

​
集成详情

类包PY 支持版本
DuckDuckGoSearch@langchain/community✅NPM - Version

​
设置

集成位于 @langchain/community 包中，同时还需要 duck-duck-scrape 依赖项： 
npm install @langchain/community @langchain/core duck-duck-scrape

​
凭据

设置 LangSmith 以获得一流的可观察性也很有帮助（但不是必需的）： 
process.env.LANGSMITH_TRACING="true"
process.env.LANGSMITH_API_KEY="your-api-key"

​
实例化

您可以像这样实例化 DuckDuckGoSearch 工具的一个实例： 
import { DuckDuckGoSearch } from "@langchain/community/tools/duckduckgo_search"

const tool = new DuckDuckGoSearch({ maxResults: 1 })

​
调用

​
直接使用参数调用

await tool.invoke("what is the current weather in sf?")

[{"title":"San Francisco, CA Current Weather | AccuWeather","link":"https://www.accuweather.com/en/us/san-francisco/94103/current-weather/347629","snippet":"<b>Current</b> <b>weather</b> <b>in</b> San Francisco, CA. Check <b>current</b> conditions in San Francisco, CA with radar, hourly, and more."}]

​
使用 ToolCall 调用

我们还可以使用模型生成的 ToolCall 来调用工具，在这种情况下，将返回一个 ToolMessage： 
// This is usually generated by a model, but we'll create a tool call directly for demo purposes.
const modelGeneratedToolCall = {
  args: {
    input: "what is the current weather in sf?"
  },
  id: "tool_call_id",
  name: tool.name,
  type: "tool_call",
  }
await tool.invoke(modelGeneratedToolCall)

ToolMessage {
  "content": "[{\"title\":\"San Francisco, CA Weather Conditions | Weather Underground\",\"link\":\"https://www.wunderground.com/weather/us/ca/san-francisco\",\"snippet\":\"San Francisco <b>Weather</b> Forecasts. <b>Weather</b> Underground provides local & long-range <b>weather</b> forecasts, weatherreports, maps & tropical <b>weather</b> conditions for the San Francisco area.\"}]",
  "name": "duckduckgo-search",
  "additional_kwargs": {},
  "response_metadata": {},
  "tool_call_id": "tool_call_id"
}

​
链式调用

我们可以通过先将工具绑定到 工具调用模型 然后调用它，来在链中使用我们的工具： 
// @lc-docs-hide-cell

import { ChatOpenAI } from "@langchain/openai"

const llm = new ChatOpenAI({
  model: "gpt-4.1-mini",
})

import { HumanMessage } from "@langchain/core/messages";
import { ChatPromptTemplate } from "@langchain/core/prompts";
import { RunnableLambda } from "@langchain/core/runnables";

const prompt = ChatPromptTemplate.fromMessages(
  [
    ["system", "You are a helpful assistant."],
    ["placeholder", "{messages}"],
  ]
)

const llmWithTools = llm.bindTools([tool]);

const chain = prompt.pipe(llmWithTools);

const toolChain = RunnableLambda.from(
  async (userInput: string, config) => {
    const humanMessage = new HumanMessage(userInput,);
    const aiMsg = await chain.invoke({
      messages: [new HumanMessage(userInput)],
    }, config);
    const toolMsgs = await tool.batch(aiMsg.tool_calls, config);
    return chain.invoke({
      messages: [humanMessage, aiMsg, ...toolMsgs],
    }, config);
  }
);

const toolChainResult = await toolChain.invoke("how many people have climbed mount everest?");

const { tool_calls, content } = toolChainResult;

console.log("AIMessage", JSON.stringify({
  tool_calls,
  content,
}, null, 2));

AIMessage {
  "tool_calls": [],
  "content": "As of December 2023, a total of 6,664 different people have reached the summit of Mount Everest."
}

​
代理

有关如何在代理中使用 LangChain 工具的指南，请参阅 LangGraph.js 文档。

​
API 参考

有关所有 DuckDuckGoSearch 功能和配置的详细文档，请访问 API 参考
在 GitHub 上编辑此页面 或 提交问题。
通过 MCP 将这些文档连接 到 Claude、VSCode 等，以获得实时解答。