Skip to content

Connect Notion

Add pages from your Notion workspace to the knowledge base, allowing the Agent to reference your documents and knowledge base content.

Prerequisites

Before starting, please understand the basic concepts and folder structure of the knowledge base. If you haven't created a knowledge base folder yet, please refer to Knowledge Base Overview.

Applicable Scenarios

After adding Notion pages to the knowledge base, you can:

  • Let the Agent reference your technical documentation
  • Search and cite knowledge base content
  • Integrate product specifications, design documents, and other materials

Connection Steps

Step 1: Enter Knowledge Base and Select Folder

  1. Enter Knowledge Base Page

    • In your workspace, click "Knowledge Base" in the left menu
    • Select the "Folders" tab

  2. Select or Create Folder

    • Select an existing folder or create a new folder
    • Folders are used to organize and categorize your documents

  1. Click "Add File"

    • In the folder, click the "Add File" button
    • You'll see menu options

  2. Select "Link Another Notion Workspace"

    • If this is your first time linking a Notion workspace, the authorization process will start directly
    • If you've already linked a Notion workspace, you can:
      • Click the "×" next to the linked workspace to link another workspace
      • Or directly click the linked workspace to select pages

Workspace Limitation

  • Each account can only link one Notion workspace.
  • If you want to link a different Notion workspace, you need to go to the "External Connections" tab to delete the existing connection first, or click the "×" next to the linked workspace to link another workspace.

Step 3: Authorize Notion

After selecting "Link Another Notion Workspace," you'll be directed to Notion's authorization page:

  1. Log in to your Notion account (if not already logged in)
  2. Confirm the workspace you want to authorize to Codeer.ai
  3. Click "Allow access" to complete authorization

Security Notice

Codeer.ai will only read the page content you authorize and will not modify or delete any Notion data.

Step 4: Select Pages

After authorization completes, Notion's page picker will open:

  1. Browse Your Notion Workspace

    • Including regular pages and Database pages

  2. Select Pages You Want to Add to Knowledge Base

    • You can select multiple pages at once
    • It's recommended to only select pages relevant to the Agent's purpose

  3. Click Confirm to Complete Selection

    • Selected pages will immediately be added to the knowledge base folder you just selected
    • Pages will appear as files in the folder list

Page Selection Recommendation

It's recommended to only select pages relevant to the Agent's purpose, avoiding adding too much irrelevant content, which can improve the accuracy of Agent responses.

Usage

After pages are added to the knowledge base, you need to configure the knowledge base tool in the Agent first before the Agent can use these pages.

Configure Knowledge Base Tool

  1. Enter Agent Editor
  2. Click "Add Tool" in the "Tools" section
  3. Select "Knowledge Base"
  4. Select the knowledge base folder containing Notion pages
  5. Set "When to Use" instructions

→ Detailed Setup Steps

Use in Conversations

After configuration, when asking questions in conversations, the Agent will automatically reference your Notion pages:

You: According to our API documentation, what is the user authentication process?

AI: According to your Notion page "API Design Specification" in your knowledge base, the user authentication process is as follows...
[Shows citation source: Knowledge Base > API Design Specification]

Common Questions

Can I only add specific pages?

Yes. After authorization and opening the page picker, you can select specific pages to add to the knowledge base without needing to add the entire workspace.

It's recommended to only select pages relevant to the Agent's purpose, avoiding adding too much irrelevant content.

Will the knowledge base automatically update after Notion content is updated?

No. Data in the knowledge base is a static snapshot and will not automatically sync with Notion updates.

If you update a page in Notion, you need to:

  1. Go to the knowledge base page
  2. Find the old version of the page file and click delete
  3. Again go through "Add File" → "Link Another Notion Workspace" (or click the linked workspace)
  4. In the page picker, reselect the updated page

This way, the Agent can reference the latest content.

Can databases (Database) be added to the knowledge base?

Yes. Notion database pages can also be added to the knowledge base.

When you select a database page, the system will process its content together, allowing the Agent to query information in the database.

Note

Each entry in a Notion Database will be processed as a "separate page, separate file." If a Notion Database has 100 entries, it's equivalent to selecting 100 pages at once and adding 100 files to the knowledge base.

It's recommended to confirm the number of entries before selecting a Database page to avoid affecting performance by adding too many files at once.

Can I add content from both Notion and Google Drive simultaneously?

Yes. You can add Notion pages and Google Drive files to the same knowledge base folder simultaneously, or configure multiple different knowledge base tools in the Agent.

It's recommended to create different folders and knowledge base tools for different purposes, for example:

  • Product Documentation Knowledge Base (mainly Notion)
  • Technical Documentation Knowledge Base (mainly Google Drive)

Next Steps