Txtai

TxtaiReader

Bases: BaseReader

txtai 阅读器。

通过现有的内存中 txtai 索引检索文档。这些文档随后可在下游 LlamaIndex 数据结构中使用。如果您希望将 txtai 本身用作组织、插入文档并对其执行查询的索引，请配合 TxtaiVectorStore 使用 VectorStoreIndex。

参数

名称	类型	描述	默认值
txtai_index	ANN	一个 txtai 索引对象 (必需)	必需

源代码位于 llama-index-integrations/readers/llama-index-readers-txtai/llama_index/readers/txtai/base.py

class TxtaiReader(BaseReader):
    """
    txtai reader.

    Retrieves documents through an existing in-memory txtai index.
    These documents can then be used in a downstream LlamaIndex data structure.
    If you wish use txtai itself as an index to to organize documents,
    insert documents, and perform queries on them, please use VectorStoreIndex
    with TxtaiVectorStore.

    Args:
        txtai_index (txtai.ann.ANN): A txtai Index object (required)

    """

    def __init__(self, index: Any):
        """Initialize with parameters."""
        import_err_msg = """
            `txtai` package not found. For instructions on
            how to install `txtai` please visit
            https://neuml.github.io/txtai/install/
        """
        try:
            import txtai  # noqa
        except ImportError:
            raise ImportError(import_err_msg)

        self._index = index

    def load_data(
        self,
        query: np.ndarray,
        id_to_text_map: Dict[str, str],
        k: int = 4,
        separate_documents: bool = True,
    ) -> List[Document]:
        """
        Load data from txtai index.

        Args:
            query (np.ndarray): A 2D numpy array of query vectors.
            id_to_text_map (Dict[str, str]): A map from ID's to text.
            k (int): Number of nearest neighbors to retrieve. Defaults to 4.
            separate_documents (Optional[bool]): Whether to return separate
                documents. Defaults to True.

        Returns:
            List[Document]: A list of documents.

        """
        search_result = self._index.search(query, k)
        documents = []
        for query_result in search_result:
            for doc_id, _ in query_result:
                doc_id = str(doc_id)
                if doc_id not in id_to_text_map:
                    raise ValueError(
                        f"Document ID {doc_id} not found in id_to_text_map."
                    )
                text = id_to_text_map[doc_id]
                documents.append(Document(text=text))

        if not separate_documents:
            # join all documents into one
            text_list = [doc.get_content() for doc in documents]
            text = "\n\n".join(text_list)
            documents = [Document(text=text)]

        return documents

load_data

load_data(query: ndarray, id_to_text_map: Dict[str, str], k: int = 4, separate_documents: bool = True) -> List[Document]

从 txtai 索引载入数据。

参数

名称	类型	描述	默认值
query	ndarray	一个 2D numpy 查询向量数组。	必需
id_to_text_map	Dict[str, str]	一个从 ID 到文本的映射。	必需
k	int	要检索的最近邻数量。默认为 4。	4
separate_documents	Optional[bool]	是否返回单独的文档。默认为 True。	True

返回

类型	描述
List[Document]	List[Document]: 文档列表。

源代码位于 llama-index-integrations/readers/llama-index-readers-txtai/llama_index/readers/txtai/base.py

def load_data(
    self,
    query: np.ndarray,
    id_to_text_map: Dict[str, str],
    k: int = 4,
    separate_documents: bool = True,
) -> List[Document]:
    """
    Load data from txtai index.

    Args:
        query (np.ndarray): A 2D numpy array of query vectors.
        id_to_text_map (Dict[str, str]): A map from ID's to text.
        k (int): Number of nearest neighbors to retrieve. Defaults to 4.
        separate_documents (Optional[bool]): Whether to return separate
            documents. Defaults to True.

    Returns:
        List[Document]: A list of documents.

    """
    search_result = self._index.search(query, k)
    documents = []
    for query_result in search_result:
        for doc_id, _ in query_result:
            doc_id = str(doc_id)
            if doc_id not in id_to_text_map:
                raise ValueError(
                    f"Document ID {doc_id} not found in id_to_text_map."
                )
            text = id_to_text_map[doc_id]
            documents.append(Document(text=text))

    if not separate_documents:
        # join all documents into one
        text_list = [doc.get_content() for doc in documents]
        text = "\n\n".join(text_list)
        documents = [Document(text=text)]

    return documents