> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/zh/manage-your-site/install-an-integration.md).

# 安装并管理集成

在单个分区中安装集成，或在组织中的所有分区中安装

GitBook 中有 [许多不同的集成](https://www.gitbook.com/integrations#custom-experiences) 可供使用。从交互式内容块到高级分析工具，只需点击几下，即可将你喜爱的工具集成到 GitBook 中。

你可以在单个部分、多个部分或整个组织的所有部分中安装集成。

如果你在单个部分中安装集成，它将只在该特定部分中生效。通过在多个部分中安装集成，你就可以在这些部分中执行操作。

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-0d7f6a72e44075bfe935e8fe021bac70e84b910f%2F26_01_06_integrations%402x.png?alt=media" alt="A GitBook screenshot showing the integration library"><figcaption><p>浏览 GitBook 的内置集成库。</p></figcaption></figure>

### 安装集成

#### 1. 打开集成界面

在版块或站点中启用集成之前，你需要先在组织中安装它。返回组织的 **主页** ，然后点击侧边栏中的 **集成** 。你可以按类别浏览集成，也可以搜索所需的集成。

在组织中安装集成后，你还可以在站点级别使用它——点击站点侧边栏中 **扩展**下方的 **集成** 。已添加到站点的集成会显示在 **已安装的集成**.

#### 2. 选择集成并安装

接下来，点击你想安装的集成。某些集成可以安装到你的各个部分，而其他则可用于你已发布的文档。

在此屏幕上，你可以选择要将集成安装到的区域。

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-930e29d18c8ce2257769ef5e37e562a744b519dc%2F25_01_10_install_integration.svg?alt=media" alt="A GitBook screenshot showing where you can install an integration"><figcaption><p>选择一个区域来安装集成。</p></figcaption></figure>

#### 3. 配置你的集成

{% hint style="info" %}
分析类集成——例如 Google Analytics、Segment 或 Fathom——是针对整个站点配置的。如果你的站点包含多个部分，你无法按部分分别收集分析数据；一个配置会应用于整个站点。
{% endhint %}

现在你可以使用你的集成了。某些集成可能需要额外配置。如果是这样，你会看到一条消息，要求你在你的部分或站点中配置集成。

查看该集成的说明，了解如何为你的团队进行配置。

### 常见问题

<details>

<summary>我该如何配置我的集成？</summary>

每个集成都有自己的配置选项。你可以在每个集成的安装页面上找到其具体的配置说明。

</details>

<details>

<summary>我可以请求一个集成吗？</summary>

可以—— [提交集成申请](https://survey.refiner.io/e61q1m-dp057m)，也可以前往 [GitBook 社区](https://github.com/GitbookIO/community) 讨论你希望在 GitBook 中看到的内容。

</details>

<details>

<summary>我可以自己构建集成吗？</summary>

任何拥有 GitBook 账号的用户都可以使用集成平台。请参阅 [我们的集成页面](https://www.gitbook.com/integrations) 或 [开发者文档](https://developer.gitbook.com/) 以开始使用。

</details>

<details>

<summary>GitBook 支持 Google Tag Manager 吗？</summary>

不支持。Google Tag Manager 允许注入 CSS 和 JavaScript，这可能会破坏网站并带来安全隐患，因此 GitBook 不与其集成。

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/zh/manage-your-site/install-an-integration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
