跳至主要内容

NeuralDB

NeuralDB 是由 ThirdAI 开发的 CPU 友好且可微调的检索引擎。

初始化​

有两种初始化方法

  • 从头开始：基本模型
  • 从检查点：加载之前保存的模型

对于以下所有初始化方法，如果设置了 THIRDAI_KEY 环境变量，则可以省略 thirdai_key 参数。

可以从 https://www.thirdai.com/try-bolt/ 获取 ThirdAI API 密钥。

from langchain_community.retrievers import NeuralDBRetriever

# From scratch
retriever = NeuralDBRetriever.from_scratch(thirdai_key="your-thirdai-key")

# From checkpoint
retriever = NeuralDBRetriever.from_checkpoint(
    # Path to a NeuralDB checkpoint. For example, if you call
    # retriever.save("/path/to/checkpoint.ndb") in one script, then you can
    # call NeuralDBRetriever.from_checkpoint("/path/to/checkpoint.ndb") in
    # another script to load the saved model.
    checkpoint="/path/to/checkpoint.ndb",
    thirdai_key="your-thirdai-key",
)
API 参考：NeuralDBRetriever

插入文档源​

retriever.insert(
    # If you have PDF, DOCX, or CSV files, you can directly pass the paths to the documents
    sources=["/path/to/doc.pdf", "/path/to/doc.docx", "/path/to/doc.csv"],
    # When True this means that the underlying model in the NeuralDB will
    # undergo unsupervised pretraining on the inserted files. Defaults to True.
    train=True,
    # Much faster insertion with a slight drop in performance. Defaults to True.
    fast_mode=True,
)

from thirdai import neural_db as ndb

retriever.insert(
    # If you have files in other formats, or prefer to configure how
    # your files are parsed, then you can pass in NeuralDB document objects
    # like this.
    sources=[
        ndb.PDF(
            "/path/to/doc.pdf",
            version="v2",
            chunk_size=100,
            metadata={"published": 2022},
        ),
        ndb.Unstructured("/path/to/deck.pptx"),
    ]
)

检索文档​

要查询检索器，可以使用标准的 LangChain 检索器方法 get_relevant_documents，该方法返回 LangChain 文档对象的列表。每个文档对象代表索引文件中的一段文本。例如，它可能包含索引的 PDF 文件中的一段。除了文本之外，文档的元数据字段还包含文档 ID、此文档的来源（来自哪个文件）以及文档的分数等信息。

# This returns a list of LangChain Document objects
documents = retriever.invoke("query", top_k=10)

微调​

NeuralDBRetriever 可以针对用户行为和特定领域知识进行微调。它可以通过两种方式进行微调

  1. 关联：检索器将源短语与目标短语相关联。当检索器看到源短语时，它也会考虑与目标短语相关的结果。
  2. 点赞：检索器会为特定查询提高文档的分数。当您想针对用户行为微调检索器时，这很有用。例如，如果用户搜索“汽车是如何制造的”并且喜欢 ID 为 52 的返回文档，那么我们可以为查询“汽车是如何制造的”点赞 ID 为 52 的文档。
retriever.associate(source="source phrase", target="target phrase")
retriever.associate_batch(
    [
        ("source phrase 1", "target phrase 1"),
        ("source phrase 2", "target phrase 2"),
    ]
)

retriever.upvote(query="how is a car manufactured", document_id=52)
retriever.upvote_batch(
    [
        ("query 1", 52),
        ("query 2", 20),
    ]
)

此页面是否有帮助？


您也可以在 GitHub 上留下详细反馈.