SuperAPI AI 工具集

notion

办公与效率

查看项目

更新于 10-21 12:51

技能介绍

用途

该技能用于 Notion 的搜索、获取以及有限的写入工作流,适合在用户要求查找文档、规格、笔记、会议记录、项目背景等场景下使用。

主要能力

  • 搜索 Notion 页面与数据源
  • 获取页面或数据源内容
  • 创建页面
  • 更新页面
  • 移动页面

在可用时优先使用上述允许列表中的操作。写入前需先发现当前可用的创建、更新或移动工具,并仅复制其实际 schema 支持的字段。若所需写入操作不可用,不得声称支持写入。即使发现更广泛的管理或破坏性操作,也不得使用。

使用方式

请求分类

先对请求进行分类:

  • 只读查找或摘要
  • 明确的创建、更新或移动

保持工具工作基本静默

  • 在 Notion 工具工作前最多发送一条简短确认。
  • 将中间的搜索/获取推理保持在内部。
  • 不要在工具仍在运行时逐步叙述“让我……”“我找到了……”或部分发现。
  • 一旦有足够证据,回复真实答案;若无法完成,说明实际阻碍。

搜索 Notion

先确定实际搜索短语。Notion 搜索偏向标题,因此应搜索可能的页面或数据源标题,而不是用户的完整句子。

  • 使用 1-3 个简短明确的搜索短语。
  • 好例子:deployment pipeline、launch tracker、incident review
  • 坏例子:how do we handle deployment pipelines for mobile releases

对于列表/报告/日历类请求,先搜索规范容器:

  • 页面标题:holidays、company holidays
  • 数据源标题:people calendar

最多进行一轮细化。如果第一次搜索已找到可能的规范页面或数据源,先获取它,再决定是否再次搜索。

高效获取

  • 搜索仅返回排序后的页面和数据源候选。选择最佳候选,然后使用返回的 URL 或 ID 获取内容。
  • 如果获取的页面明确指向内联数据源或数据库,下一步获取该数据源并基于它工作。
  • 如果获取的数据源已包含回答问题所需的行和字段,就此停止并基于该结果回答。
  • 当容器页面或数据源已暴露所需字段时,不要串行获取大量单独的行页面。
  • 仅在获取规范页面或数据源后仍缺少少量重要字段或存在歧义时,才获取单独的行。
  • 一旦有足够证据回答读取请求,停止获取并回复。

仅在用户明确要求时写入

  • 先通过搜索和获取解析目标或目标页面。
  • 更新或移动前先获取当前页面。
  • 将变更限制在用户请求的确切标题、父级、属性和内容范围内。
  • 优先使用部分更新而非完全重写。
  • 成功写入后,返回生成的 Notion 页面 URL 以及变更的简短摘要。
  • 如果已认证用户缺少访问权限,或写入操作不可用,明确说明并停止。

适用场景

  • 查找文档、规格、笔记、会议记录、项目背景
  • 对只读内容进行摘要
  • 在用户明确要求时创建、更新或移动 Notion 页面

限制与护栏

  • 除非用户明确要求创建、编辑或移动 Notion 内容,否则默认只读。
  • 不得虚构目标、父级、属性或超出请求范围的大量内容扩展。
  • 搜索结果可能是页面或数据源,不得将数据源视为不支持。
  • 对于“US holidays”或“2026 holidays”等限定范围的请求,读取获取内容时应用用户的范围;若来源混合多个地区或年份,说明所做的假设。
  • 如果搜索未返回可访问的匹配项,说明没有可访问的页面或数据源匹配,并指出内容可能超出用户的 Notion 权限或标题匹配不佳。
  • 如果顶部结果的内容获取失败,返回最佳匹配的 Notion URL,并说明该结果无法获取以进行摘要。
  • 数据库删除、schema 重新设计及其他广泛管理操作不在范围内。