Box 集成

使用 LangChain Python 集成 Box。

Box是智能内容云，一个单一平台，帮助企业协作、管理内容全生命周期、保护关键内容，并通过企业级AI重塑业务流程。自2005年成立以来，Box为AstraZeneca、JLL、摩根士丹利和全国保险等全球领先机构简化工作。

本套件提供多种方式将Box内容集成到您的AI工作流中。

安装与配置

pip

pip install -U langchain-box

langchain-box

本包包含LangChain与Box的集成。如需了解Box详情，请查阅开发者文档。

预先条件

要集成Box，需准备以下内容：

• Box实例——若您尚未是Box客户，请注册免费开发者账户。
• Box应用——如何创建应用的详情请查看
• 应用在您的Box实例中已获审批——由管理员完成。若使用免费开发者账户，您即管理员角色，请授权应用

认证

box-langchain包提供多种认证灵活性。最基础的认证方式是通过开发者令牌。该令牌可在Box开发者控制台的配置页面获取。此令牌为短期有效（1小时），专用于开发环境。您可将它添加到环境变量BOX_DEVELOPER_TOKEN，直接传递给加载器，或使用BoxAuth认证辅助类。

下文将演示如何直接将令牌传递给加载器。

BoxAuth辅助类

BoxAuth支持以下认证方式：

• Token——开发者令牌或通过Box SDK生成的任何令牌
• JWT服务账户凭证
• JWT指定用户凭证
• CCG服务账户凭证
• CCG指定用户凭证

若使用JWT认证，需从Box开发者控制台下载配置文件（需在生成公钥/私钥对后），将其放置在应用目录结构中。使用BoxAuth辅助类时，需提供该文件的路径。

更多详情请参考如何配置Box应用，并查阅Box认证指南了解不同认证选项。

示例：

Token认证

from langchain_box.document_loaders import BoxLoader
from langchain_box.utilities import BoxAuth, BoxAuthType

auth = BoxAuth(
    auth_type=BoxAuthType.TOKEN,
    box_developer_token=box_developer_token
)

loader = BoxLoader(
    box_auth=auth,
    ...
)

JWT服务账户认证

from langchain_box.document_loaders import BoxLoader
from langchain_box.utilities import BoxAuth, BoxAuthType

auth = BoxAuth(
    auth_type=BoxAuthType.JWT,
    box_jwt_path=box_jwt_path
)

loader = BoxLoader(
    box_auth=auth,
    ...

JWT指定用户认证

from langchain_box.document_loaders import BoxLoader
from langchain_box.utilities import BoxAuth, BoxAuthType

auth = BoxAuth(
    auth_type=BoxAuthType.JWT,
    box_jwt_path=box_jwt_path,
    box_user_id=box_user_id
)

loader = BoxLoader(
    box_auth=auth,
    ...

CCG服务账户认证

from langchain_box.document_loaders import BoxLoader
from langchain_box.utilities import BoxAuth, BoxAuthType

auth = BoxAuth(
    auth_type=BoxAuthType.CCG,
    box_client_id=box_client_id,
    box_client_secret=box_client_secret,
    box_enterprise_id=box_enterprise_id
)

loader = BoxLoader(
    box_auth=auth,
    ...

CCG指定用户认证

from langchain_box.document_loaders import BoxLoader
from langchain_box.utilities import BoxAuth, BoxAuthType

auth = BoxAuth(
    auth_type=BoxAuthType.CCG,
    box_client_id=box_client_id,
    box_client_secret=box_client_secret,
    box_user_id=box_user_id
)

loader = BoxLoader(
    box_auth=auth,
    ...

如需使用OAuth2授权码流程，请使用BoxAuthType.TOKEN并传入已获取的令牌。

文档加载器

BoxLoader

查看使用示例

from langchain_box.document_loaders import BoxLoader

检索器

BoxRetriever

查看使用示例

from langchain_box.retrievers import BoxRetriever

Blob加载器

BoxBlobLoader

查看使用示例

from langchain_box.blob_loaders import BoxBlobLoader

---

官方原文：src/oss/python/integrations/providers/box.mdx · 非官方翻译，译文由 AI 生成，以英文原文为准。