知识实践：用 Webhook 与快捷指令收录资料

教学改绘示意；操作以实际界面为准。

我们把手机上看到的一条链接交给知识伙伴，让它读取、整理并返回结果位置。手机负责触发，云端负责执行，收录回执负责证明发生了什么。

先写清下游任务

我们把抖音视频、微信文章和网页分别接入知识库。视频路径包含下载、转写、抽帧、摘要与归档；文章路径包含读取全文、摘要、保存与关联。Webhook 只提供触发入口，不自动提供这些能力。

我们先选一个可访问的公开网页，确认 Bot 能读取全文、查重和写入自己的知识库，再扩展到视频。受限页面、无法下载的视频或不完整的转写，要明确失败与缺失项目。

请建立知识收录任务。输入为我们提交的链接或文本。
先检查知识库是否已有同一内容；已有则返回现有记录，不重复创建。
网页读取可获得的全文，保留原始链接、标题、时间和缺失部分。
视频只在访问和处理条件满足时下载、转写与抽帧，说明不清楚的片段。
整理要点，保存原始资料与笔记，建立相关记录的回链。
最后返回处理对象、文件位置、知识页链接、主要要点、实际可获得的用量或费用信息以及未完成项。不编造费用与成功状态。

创建一个事件触发 Routine

触发入口还可以是每天 8:30 的定时任务，或第三方 PR 事件；本课使用 Webhook。

在知识 Bot 中新建 Routine，选择当前界面的 Webhook 事件触发并保存。把自己的 URL、密钥和认证头存入私密入口，再核对输入字段与任务说明。

官方 Grok 文档确认 Routines 可按时间或连接事件启动，但当前公开文档没有给出本案例完整的 Webhook 请求字段规范。因此下面的 content 是我们教学示例约定的字段；只有 Routine 明确按它读取时才使用。实际页面提供了其他字段或认证方式，就按实际配置调整。

在 iPhone 创建“发送给知识库 Bot”

在快捷指令 App 点加号，添加“获取 URL 内容”。URL 填自己的 Webhook 地址，方法改为 POST。请求头使用当前 Routine 实际生成的认证方式；如果要求 Authorization，可按下面的占位示例配置：

Authorization: Bearer <自己的密钥>

Bearer 与密钥之间有一个空格；尖括号只是占位说明，不实际填写。密钥不得出现在公开分享的快捷指令、截图或课程里。

请求体选择 JSON，把字段 content 绑定为“快捷指令输入”变量：

{"content":"<快捷指令输入变量>"}

这里不是要求输入一段带尖括号的固定文字，而是在编辑器中选择变量。Apple 文档确认“获取 URL 内容”改为 POST 后可以发送 JSON、表单或文件，并使用变量；服务端接受什么仍由我们自己的 Routine 约定。

打开快捷指令详情，启用在共享表单中显示，接收类型选择 URL 与文本。Safari 等支持共享的地方，把链接分享给这条快捷指令。手机请求结束与云任务完成是两个时刻；Routine 显示 Running 时，我们去看运行记录，等待正式回执。

微信没有显示快捷指令时怎么收录

我们另外建一个入口快捷指令，用“从菜单中选取”显示“想打开什么？”，再使用“请求输入”取得文本，提示“请输入要收录的链接”，最后把“提供的输入”交给前一条“发送给知识库 Bot”。

动作名称可能随语言与系统版本变化。重点是菜单 → 文本输入 → 调用已有发送指令，避免维护两份请求配置。复制文章链接后，可以从已配置的快捷指令提交；设备按钮是否可用以自己的设置为准。

回执不能只写“已收到”

归档目标可以是自己的笔记、表格或资料库，无需为了练习更换工具。其他入口也可以复用同一输入约定，但每个入口都要保护认证信息。

练习交付：一条成功回执、一次重复链接测试和一次不可访问链接的失败记录。检查资料确实入库之后，再扩展到视频。