mintlify__docs/zh/agent/notion.mdx

---
title: "将 Notion 连接到 agent"
description: "将 Notion 连接到 Mintlify agent，使其在创建文档更新时能够引用工作区页面和数据库作为上下文。"
keywords: ["Notion", "integration", "knowledge base", "context"]
---

将你的 Notion 工作区连接到 agent，使其能够搜索你的 Notion 内容，并在创建文档更新时将其用作上下文。来自团队知识库、产品规格说明和存储在 Notion 中的内部文档的额外上下文，有助于 agent 创建更准确、更完整的文档。

<div id="connect-your-notion-workspace">
  ## 连接你的 Notion 工作区
</div>

1. 在控制台中进入 [Agent](https://dashboard.mintlify.com/products/agent) 页面。
2. 在 "Agent settings" 部分，点击 **Install Notion app**。
  <Frame>
    <img src="/images/agent/install-apps-light.png" alt="应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。" className="block dark:hidden" />
    <img src="/images/agent/install-apps-dark.png" alt="应用设置区域，包含 Slack、Linear 和 Notion 安装按钮。" className="hidden dark:block" />
  </Frame>
3. 按照提示授权 Mintlify 访问你的 Notion 工作区。
4. 在 Notion 的授权页面上，选择要与 Mintlify 共享的页面和数据库。

<div id="what-the-agent-can-do-with-notion">
  ## agent 可以用 Notion 做什么
</div>

Notion 集成使用 Notion 的 [MCP 工具](https://developers.notion.com/guides/mcp/mcp-supported-tools#mcp-tools) 来搜索和读取你工作区中的内容。

你在 Notion 中的内容将成为 agent 生成文档时可使用的额外上下文。

当 agent 可以访问你的 Notion 工作区时，它可以：

- **搜索 Notion**：根据你请求的上下文，在已连接的 Notion 工作区中查找相关页面和数据库。
- **阅读 Notion 页面**：访问 Notion 页面的内容，将其作为生成文档时的参考资料。
- **查询数据库**：从 Notion 数据库中提取结构化数据，为文档更新提供依据。

<div id="use-cases">
  ## 使用场景
</div>

- **将产品规格同步到文档**：在编写功能文档时，引用存储在 Notion 中的产品需求文档和设计规格。
- **根据会议记录编写文档**：将 agent 指向 Notion 中的会议记录或决策日志，基于团队讨论起草文档。
- **利用内部知识库**：将 Notion 中的内部 wiki 和知识库作为面向公众的文档的素材来源。

<div id="best-practices">
  ## 最佳实践
</div>

- **谨慎控制访问范围**：仅授予 agent 对包含与你文档相关信息的 Notion 页面和数据库的访问权限。
- **提供具体引用**：在给 agent 下达指令时，提及你希望它参考的具体 Notion 页面或数据库，以获得最佳效果。
- **审查生成的内容**：始终审查拉取请求，确保来自 Notion 的信息已被恰当地调整，适用于你的公开文档。