> ## 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.

# Quip 集成

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

> [Quip](https://quip.com) 是一款面向移动端和网页的协作生产力软件套件。它允许多人以团队形式创建和编辑文档与电子表格，通常用于商业目的。

一个用于加载 `Quip` 文档的加载器。

请参阅 [Quip API 认证文档](https://quip.com/dev/automation/documentation/current#section/Authentication/Get-Access-to-Quip's-APIs) 以了解如何获取个人访问令牌。

指定一个 `folder_ids` 和/或 `thread_ids` 列表，以将相应的文档加载为 Document 对象。如果同时指定了两者，加载器将基于 `folder_ids` 获取属于该文件夹的所有 `thread_ids`，并与传入的 `thread_ids` 合并，返回两个集合的并集。

* 如何知道 folder\_id？
  前往 quip 文件夹，右键点击文件夹并复制链接，从链接中提取后缀作为 folder\_id。提示：`https://example.quip.com/<folder_id>`
* 如何知道 thread\_id？
  thread\_id 即文档 ID。前往 quip 文档，右键点击文档并复制链接，从链接中提取后缀作为 thread\_id。提示：`https://exmaple.quip.com/<thread_id>`

你还可以将 `include_all_folders` 设置为 `True`，这将获取 group\_folder\_ids。
你还可以指定一个布尔值 `include_attachments` 以包含附件，默认设置为 False。如果设置为 True，所有附件将被下载，QuipLoader 将从附件中提取文本并将其添加到 Document 对象中。目前支持的附件类型有：`PDF`、`PNG`、`JPEG/JPG`、`SVG`、`Word` 和 `Excel`。此外，你可以指定一个布尔值 `include_comments` 以包含文档中的评论，默认设置为 False。如果设置为 True，文档中的所有评论将被获取，QuipLoader 将它们添加到 Document 对象中。

在使用 QuipLoader 之前，请确保已安装最新版本的 quip-api 包：

```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
pip install -qU  quip-api
```

## 示例

### 个人访问令牌

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

loader = QuipLoader(
    api_url="https://platform.quip.com", access_token="change_me", request_timeout=60
)
documents = loader.load(
    folder_ids={"123", "456"},
    thread_ids={"abc", "efg"},
    include_attachments=False,
    include_comments=False,
)
```

***

<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/quip.mdx) 或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>