以编程方式使用文档

这将帮助您开始使用 VectorStoreToolkit 工具包。有关所有 VectorStoreToolkit 功能和配置的详细文档,请前往 API 参考文档.

VectorStoreToolkit 是一个工具包,它接收一个向量存储,并将其转换为一个可调用的工具,然后可将其传递给 LLM、代理等。

设置

如果您想从各个工具的运行中获得自动追踪,您还可以设置您的 LangSmith API 密钥,方法如下面的注释所示:

process.env.LANGSMITH_TRACING="true"
process.env.LANGSMITH_API_KEY="your-api-key"

安装

此工具包位于 langchain package:

npm install langchain @langchain/core
yarn add langchain @langchain/core
pnpm add langchain @langchain/core

实例化

现在我们可以实例化我们的工具包。首先,我们需要定义将在工具包中使用的 LLM。

// @lc-docs-hide-cell


const llm = new ChatOpenAI({
  model: "gpt-5.4-mini",
  temperature: 0,
})
// Load a text file to use as our data source.
const text = fs.readFileSync("../../../../../examples/state_of_the_union.txt", "utf8");

// Split the text into chunks before inserting to our store
const textSplitter = new RecursiveCharacterTextSplitter({ chunkSize: 1000 });
const docs = await textSplitter.createDocuments([text]);

const vectorStore = await MemoryVectorStore.fromDocuments(docs, new OpenAIEmbeddings());

const vectorStoreInfo: VectorStoreInfo = {
  name: "state_of_union_address",
  description: "the most recent state of the Union address",
  vectorStore,
};

const toolkit = new VectorStoreToolkit(vectorStoreInfo, llm);

工具

在这里,我们可以看到它将我们的向量存储转换为一个工具:

const tools = toolkit.getTools();

console.log(tools.map((tool) => ({
  name: tool.name,
  description: tool.description,
})))
[
  {
    name: 'state_of_union_address',
    description: 'Useful for when you need to answer questions about state_of_union_address. Whenever you need information about the most recent state of the Union address you should ALWAYS use this. Input should be a fully formed question.'
  }
]

在代理中使用

首先,确保您已安装 LangGraph:

npm install @langchain/langgraph
yarn add @langchain/langgraph
pnpm add @langchain/langgraph

然后,实例化代理:

const agentExecutor = createAgent({ llm, tools });
const exampleQuery = "What did biden say about Ketanji Brown Jackson is the state of the union address?"

const stream = await agentExecutor.streamEvents(
  { messages: [["user", exampleQuery]] },
  { version: "v3" },
);

for await (const snapshot of stream.values) {
  const lastMsg = snapshot.messages[snapshot.messages.length - 1];
  if (lastMsg.tool_calls?.length) {
    console.dir(lastMsg.tool_calls, { depth: null });
  } else if (lastMsg.content) {
    console.log(lastMsg.content);
  }
}
[
  {
    name: 'state_of_union_address',
    args: {
      input: 'What did Biden say about Ketanji Brown Jackson in the State of the Union address?'
    },
    type: 'tool_call',
    id: 'call_glJSWLNrftKHa92A6j8x4jhd'
  }
]
In the State of the Union address, Biden mentioned that he nominated Circuit Court of Appeals Judge Ketanji Brown Jackson, describing her as one of the nation’s top legal minds who will continue Justice Breyer’s legacy of excellence. He highlighted her background as a former top litigator in private practice, a former federal public defender, and noted that she comes from a family of public school educators and police officers. He also pointed out that she has received a broad range of support since her nomination.
In the State of the Union address, President Biden spoke about Ketanji Brown Jackson, stating that he nominated her as one of the nation’s top legal minds who will continue Justice Breyer’s legacy of excellence. He highlighted her experience as a former top litigator in private practice and a federal public defender, as well as her background coming from a family of public school educators and police officers. Biden also noted that she has received a broad range of support since her nomination.

API 参考文档

有关所有 VectorStoreToolkit 功能和配置的详细文档,请前往 API 参考文档.