Skip to main content

BoxLoader

This notebook provides a quick overview for getting started with Box document loader. For detailed documentation of all BoxLoader features and configurations head to the API reference.

Overview​

The BoxLoader class helps you get your unstructured content from Box in Langchain's Document format. You can do this with either a List[str] containing Box file IDs, or with a str containing a Box folder ID.

You must provide either a List[str] containing Box file Ids, or a str containing a folder ID. If getting files from a folder with folder ID, you can also set a Bool to tell the loader to get all sub-folders in that folder, as well.

info

A Box instance can contain Petabytes of files, and folders can contain millions of files. Be intentional when choosing what folders you choose to index. And we recommend never getting all files from folder 0 recursively. Folder ID 0 is your root folder.

Files without a text representation will be skipped.

Integration details​

ClassPackageLocalSerializableJS support
BoxLoaderlangchain_box✅❌❌

Loader features​

SourceDocument Lazy LoadingAsync Support
BoxLoader✅❌

Setup​

In order to use the Box package, you will need a few things:

  • A Box account — If you are not a current Box customer or want to test outside of your production Box instance, you can use a free developer account.
  • A Box app — This is configured in the developer console, and for Box AI, must have the Manage AI scope enabled. Here you will also select your authentication method
  • The app must be enabled by the administrator. For free developer accounts, this is whomever signed up for the account.

Credentials​

For these examples, we will use token authentication. This can be used with any authentication method. Just get the token with whatever methodology. If you want to learn more about how to use other authentication types with langchain-box, visit the Box provider document.

import getpass
import os

box_developer_token = getpass.getpass("Enter your Box Developer Token: ")
Enter your Box Developer Token:  ········

If you want to get automated tracing of your model calls you can also set your LangSmith API key by uncommenting below:

# os.environ["LANGSMITH_API_KEY"] = getpass.getpass("Enter your LangSmith API key: ")
# os.environ["LANGSMITH_TRACING"] = "true"

Installation​

Install langchain_box.

%pip install -qU langchain_box

Initialization​

Load files​

If you wish to load files, you must provide the List of file ids at instantiation time.

This requires 1 piece of information:

  • box_file_ids (List[str])- A list of Box file IDs.
from langchain_box.document_loaders import BoxLoader

box_file_ids = ["1514555423624", "1514553902288"]

loader = BoxLoader(
    box_developer_token=box_developer_token,
    box_file_ids=box_file_ids,
    character_limit=10000,  # Optional. Defaults to no limit
)
API Reference:BoxLoader

Load from folder​

If you wish to load files from a folder, you must provide a str with the Box folder ID at instantiation time.

This requires 1 piece of information:

  • box_folder_id (str)- A string containing a Box folder ID.
from langchain_box.document_loaders import BoxLoader

box_folder_id = "260932470532"

loader = BoxLoader(
    box_folder_id=box_folder_id,
    recursive=False,  # Optional. return entire tree, defaults to False
    character_limit=10000,  # Optional. Defaults to no limit
)
API Reference:BoxLoader

Load​

docs = loader.load()
docs[0]
Document(metadata={'source': 'https://dl.boxcloud.com/api/2.0/internal_files/1514555423624/versions/1663171610024/representations/extracted_text/content/', 'title': 'Invoice-A5555_txt'}, page_content='Vendor: AstroTech Solutions\nInvoice Number: A5555\n\nLine Items:\n    - Gravitational Wave Detector Kit: $800\n    - Exoplanet Terrarium: $120\nTotal: $920')
print(docs[0].metadata)
{'source': 'https://dl.boxcloud.com/api/2.0/internal_files/1514555423624/versions/1663171610024/representations/extracted_text/content/', 'title': 'Invoice-A5555_txt'}

Lazy Load​

page = []
for doc in loader.lazy_load():
    page.append(doc)
    if len(page) >= 10:
        # do some paged operation, e.g.
        # index.upsert(page)

        page = []

API reference​

For detailed documentation of all BoxLoader features and configurations head to the API reference

Help​

If you have questions, you can check out our developer documentation or reach out to use in our developer community.

Was this page helpful?