aindex

async langchain_core.indexing.api.aindex(docs_source: BaseLoader | Iterable[Document] | AsyncIterator[Document], record_manager: RecordManager, vector_store: VectorStore | DocumentIndex, *, batch_size: int = 100, cleanup: Literal['incremental', 'full', None] = None, source_id_key: str | Callable[[Document], str] | None = None, cleanup_batch_size: int = 1000, force_update: bool = False, upsert_kwargs: dict[str, Any] | None = None) → IndexingResult

Async index data from the loader into the vector store.

Indexing functionality uses a manager to keep track of which documents are in the vector store.

This allows us to keep track of which documents were updated, and which documents were deleted, which documents should be skipped.

For the time being, documents are indexed using their hashes, and users

are not able to specify the uid of the document.

Important

if auto_cleanup is set to True, the loader should be returning the entire dataset, and not just a subset of the dataset. Otherwise, the auto_cleanup will remove documents that it is not supposed to.

Parameters:

• docs_source (BaseLoader | Iterable[Document] | AsyncIterator[Document]) – Data loader or iterable of documents to index.

• record_manager (RecordManager) – Timestamped set to keep track of which documents were updated.

• vector_store (VectorStore | DocumentIndex) – VectorStore or DocumentIndex to index the documents into.

• batch_size (int) – Batch size to use when indexing. Default is 100.

• cleanup (Literal['incremental', 'full', None]) –

  How to handle clean up of documents. Default is None. - Incremental: Cleans up all documents that haven’t been updated AND

  that are associated with source ids that were seen during indexing. Clean up is done continuously during indexing helping to minimize the probability of users seeing duplicated content.

  • Full: Delete all documents that haven to been returned by the loader.

    Clean up runs after all documents have been indexed. This means that users may see duplicated content during indexing.

  • None: Do not delete any documents.

• source_id_key (str | Callable[[Document], str] | None) – Optional key that helps identify the original source of the document. Default is None.

• cleanup_batch_size (int) – Batch size to use when cleaning up documents. Default is 1_000.

• force_update (bool) – Force update documents even if they are present in the record manager. Useful if you are re-indexing with updated embeddings. Default is False.

• upsert_kwargs (dict[str, Any] | None) –

  Additional keyword arguments to pass to the aadd_documents

  method of the VectorStore or the aupsert method of the DocumentIndex. For example, you can use this to specify a custom vector_field: upsert_kwargs={“vector_field”: “embedding”}

  Added in version 0.3.10.

Returns:

Indexing result which contains information about how many documents were added, updated, deleted, or skipped.

Raises:

• ValueError – If cleanup mode is not one of ‘incremental’, ‘full’ or None

• ValueError – If cleanup mode is incremental and source_id_key is None.

• ValueError – If vectorstore does not have “adelete” and “aadd_documents” required methods.

• ValueError – If source_id_key is not None, but is not a string or callable.

Return type:

IndexingResult