如何让GPT获取Notion知识？GPT Actions搭建知识库及API问题求助

一、如何让GPT从Notion获取知识 #

• 直接调用Notion API拉取：先在Notion后台创建内部集成，生成API密钥，将需要获取知识的页面/数据库共享给该集成；之后调用Notion的pages/retrieve或blocks/children/list接口获取页面内容，再将内容作为上下文传入GPT对话。
• 同步内容到GPT自定义知识库：将Notion内容导出为Markdown或纯文本格式，导入到ChatGPT的自定义GPT知识库中，让GPT直接基于导入的内容作答。
• 通过ChatGPT Actions自动拉取：即下文提到的Actions功能，配置后GPT可在需要时主动调用Notion API获取指定内容。

二、用ChatGPT Actions打造Notion领域知识库 #

1. 准备Notion集成：在Notion开发者平台创建集成，获取API密钥；将目标领域知识库的Notion页面/数据库共享给该集成（确保集成有读取权限）。
2. 编写合规的OpenAPI定义：定义清晰的API接口（比如获取指定页面、查询数据库内容），要符合OpenAPI 3.0规范，包含认证方式、请求头、参数、响应结构等。
3. 配置ChatGPT Actions：在ChatGPT的自定义GPT设置中，上传编写好的OpenAPI定义，配置Bearer认证（填入Notion API密钥），并设置触发规则（比如当用户询问领域相关问题时，自动调用接口拉取Notion内容）。
4. 调试优化：测试对话场景，确保GPT能正确调用API并基于返回的Notion内容生成回答，根据实际需求调整API定义和触发逻辑。

三、你的OpenAPI代码问题排查与修正 #

你提供的OpenAPI定义存在多个格式和逻辑错误，导致ChatGPT无法正常解析和调用API，进而中断交互，具体问题及修正如下：

问题点 #

1. YAML格式严重错误：所有层级的缩进完全混乱，OpenAPI对YAML缩进要求严格，错误的缩进会导致定义无法被解析。
2. 路径参数硬编码：路径中{pageIdEx1234567890987654321}是固定的页面ID，应该改为通用参数名（如{page_id}），让GPT能动态传入需要查询的页面ID。
3. 响应Schema不符合Notion实际返回结构：Notion API返回的页面内容并非直接的content字符串，而是由blocks数组组成，你的Schema定义与实际返回不匹配，会导致GPT处理响应时出错。
4. 缺少必要请求头：Notion API要求必须携带Notion-Version请求头（如2022-06-28），否则请求会失败。

修正后的OpenAPI代码 #

openapi: 3.0.0
info:
  title: Notion Page Retrieval API
  description: API for retrieving a specific page and its content from Notion.
  version: 1.0.0
servers:
  - url: https://api.notion.com/v1
    description: Notion API server
paths:
  /pages/{page_id}:
    get:
      operationId: retrieveNotionPage
      summary: Retrieves a specific Notion page and its blocks
      description: Fetches the specified Notion page and its child blocks (content).
      parameters:
        - name: page_id
          in: path
          required: true
          description: The ID of the Notion page to retrieve
          schema:
            type: string
      security:
        - BearerAuth: []
      responses:
        '200':
          description: Successful response with Notion page details
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                  id:
                    type: string
                  created_time:
                    type: string
                  last_edited_time:
                    type: string
                  properties:
                    type: object
                  children:
                    type: array
                    items:
                      type: object
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

额外注意事项 #

• 确保在ChatGPT Actions配置中，将Bearer认证的密钥设置为你的Notion API密钥。
• 如果需要获取页面的完整内容，可能需要递归调用blocks/children/list接口（Notion API单次返回最多100个块），你可以在OpenAPI中添加对应的接口定义，让GPT能自动获取完整内容。

内容的提问来源于stack exchange，提问作者Sebastian