> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft OneNote 集成

> 使用 LangChain Python 与 Microsoft OneNote 文档加载器集成。

本笔记本介绍如何从 `OneNote` 加载文档。

## 前提条件

1. 根据 [Microsoft 身份平台](https://learn.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app) 的说明注册一个应用程序。
2. 注册完成后，Azure 门户会显示应用注册的“概述”窗格。您会看到应用程序（客户端）ID。此值也称为 `客户端ID`，它在 Microsoft 身份平台中唯一标识您的应用程序。
3. 在您将遵循的 **第 1 项** 步骤中，可以将重定向 URI 设置为 `http://localhost:8000/callback`。
4. 在您将遵循的 **第 1 项** 步骤中，在“应用程序密码”部分生成一个新的密码（`client_secret`）。
5. 按照此 [文档](https://learn.microsoft.com/en-us/azure/active-directory/develop/quickstart-configure-app-expose-web-apis#add-a-scope) 中的说明，为您的应用程序添加以下 `SCOPES`（`Notes.Read`）。
6. 您需要使用命令 `pip install msal` 和 `pip install beautifulsoup4` 安装 msal 和 bs4 包。
7. 在步骤结束时，您必须拥有以下值：

   * `CLIENT_ID`
   * `CLIENT_SECRET`

## 🧑 从 OneNote 摄入文档的说明

### 🔑 认证

默认情况下，`OneNoteLoader` 期望 `CLIENT_ID` 和 `CLIENT_SECRET` 的值分别存储在名为 `MS_GRAPH_CLIENT_ID` 和 `MS_GRAPH_CLIENT_SECRET` 的环境变量中。您可以通过应用程序根目录下的 `.env` 文件或在脚本中使用以下命令来传递这些环境变量。

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
os.environ['MS_GRAPH_CLIENT_ID'] = "YOUR CLIENT ID"
os.environ['MS_GRAPH_CLIENT_SECRET'] = "YOUR CLIENT SECRET"
```

此加载器使用一种称为 [*代表用户*](https://learn.microsoft.com/en-us/graph/auth-v2-user?context=graph%2Fapi%2F1.0\&view=graph-rest-1.0) 的认证方式。这是一种需要用户同意的两步认证。当您实例化加载器时，它会打印一个 URL，用户必须访问该 URL 以授予应用所需的权限。然后用户必须访问此 URL 并同意该应用程序。接着，用户必须复制生成的页面 URL 并将其粘贴回控制台。如果登录尝试成功，该方法将返回 True。

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from langchain_community.document_loaders.onenote import OneNoteLoader

loader = OneNoteLoader(notebook_name="NOTEBOOK NAME", section_name="SECTION NAME", page_title="PAGE TITLE")
```

认证完成后，加载器会将令牌（`onenote_graph_token.txt`）存储在 `~/.credentials/` 文件夹中。此令牌可用于后续认证，无需执行前面解释的复制/粘贴步骤。要使用此令牌进行认证，您需要在实例化加载器时将 `auth_with_token` 参数更改为 True。

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from langchain_community.document_loaders.onenote import OneNoteLoader

loader = OneNoteLoader(notebook_name="NOTEBOOK NAME", section_name="SECTION NAME", page_title="PAGE TITLE", auth_with_token=True)
```

或者，您也可以直接将令牌传递给加载器。当您想使用由另一个应用程序生成的令牌进行认证时，这很有用。例如，您可以使用 [Microsoft Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer) 生成一个令牌，然后将其传递给加载器。

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from langchain_community.document_loaders.onenote import OneNoteLoader

loader = OneNoteLoader(notebook_name="NOTEBOOK NAME", section_name="SECTION NAME", page_title="PAGE TITLE", access_token="TOKEN")
```

### 🗂️ 文档加载器

#### 📑 从 OneNote 笔记本加载页面

`OneNoteLoader` 可以加载存储在 OneDrive 中的 OneNote 笔记本中的页面。您可以指定 `notebook_name`、`section_name`、`page_title` 的任意组合，分别筛选特定笔记本下、特定分区下或具有特定标题的页面。例如，您想要加载存储在任何 OneDrive 笔记本中名为 `Recipes` 的分区下的所有页面。

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from langchain_community.document_loaders.onenote import OneNoteLoader

loader = OneNoteLoader(section_name="Recipes", auth_with_token=True)
documents = loader.load()
```

#### 📑 从页面 ID 列表加载页面

另一种可能性是提供要加载的每个页面的 `object_ids` 列表。为此，您需要查询 [Microsoft Graph API](https://developer.microsoft.com/en-us/graph/graph-explorer) 以找到您感兴趣的所有文档 ID。此 [链接](https://learn.microsoft.com/en-us/graph/onenote-get-content#page-collection) 提供了有助于检索文档 ID 的端点列表。

例如，要检索存储在您笔记本中的所有页面的信息，您需要向以下地址发出请求：`https://graph.microsoft.com/v1.0/me/onenote/pages`。一旦您拥有了感兴趣的 ID 列表，就可以使用以下参数实例化加载器。

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from langchain_community.document_loaders.onenote import OneNoteLoader

loader = OneNoteLoader(object_ids=["ID_1", "ID_2"], auth_with_token=True)
documents = loader.load()
```

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
```

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档连接](/use-these-docs)到 Claude、VSCode 等，通过 MCP 获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/python/integrations/document_loaders/microsoft_onenote.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>