# 在 Grok Bot 中连接 Knowledge 这是软件维护的安装说明。先读取 https://knowledge.cyberflo.ai/setup/clients/grok-bot.json,复用有效连接并只修复缺少的步骤。 从机器说明下载对应版本的清单与压缩包,先按说明中的 SHA-256 核验清单,再核验压缩包及清单中每个文件。拒绝符号链接、越界路径、重复条目及多余文件。先检查内容,再写入明确的本地目录。不要覆盖同名的其他插件或已修改文件;保留旧版本和现有连接。 ## 授权前准备连接 1. 打开授权卡前先准备连接。先检查本账户现有 Knowledge 连接、实际原生 OAuth 控制与完整注册回调集合,复用有效连接。标准自动保存需要 `hive.read hive.work.append`;保留用户明确只读选择和已有效的更宽同意。仅改 scopes 或再次重连不会提高旧注册的范围上限,不要先让员工完成一次已知只有读取的授权。 2. 只有原生控制或本账户此前的原生注册确认桌面托管中转时,才使用已核验的完整组合:`https://www.cursor.com/agents/mcp/oauth/callback` 和 `http://localhost:8787/callback`。注册必须保留两者,实际 OAuth 请求与换码仍精确绑定所选托管回调;不能只复制授权链接中可见的托管地址。不能根据客户端名称推断回调,也不能把这个桌面组合套用到未观察的网页、其他系统或宿主。原生元数据不同、不可读取或控件不支持时,保留配置并报告准确缺口,先不要打开授权卡。 3. 仅在确需修复必需权限范围上限或已观察的回调集合,且宿主支持公开 PKCE 客户端配置时,通过本服务 `/register` 为本账户创建独立无密钥注册。提交前准备完整回调集合、预期范围、`token_endpoint_auth_method=none`、授权码和刷新令牌流程。核对注册响应中的完整 `redirect_uris`、预期 `scope`、无密钥方式及公开 `client_id`,不得漏掉已观察到的本机回调。通过原生工具更新同一连接,再回读实际生效的公开客户端标识与 scopes;不是只确认新注册创建成功。保留用户修改、未知配置、原生信任、已有有效连接和其他连接,不复制维护者标识、读取令牌或修改数据库。 4. 以上核对完成后,才打开一次新的授权卡,由员工完成本人的飞书登录和 Knowledge 同意。Knowledge 页面显示固定权限清单,只有“允许此连接”与“取消”,没有权限勾选框;不要让员工寻找读写复选框。该步骤不要求同事加入同一 Cursor 工作区;遵守实际团队连接限制,不绕过策略。 5. 若出现“浏览器阻止了返回智能体”,停止继续授权尝试。记录页面的客户端标识,保留失败注册不变;先按上述步骤修复不完整的注册及同一连接的配置,再进行一次新的原生流程。不要重放旧页面、反复点 Reopen、修改 CSP、扩大回调白名单或新增员工资格。未观察到完整修复时说明阻碍,不把重复授权当成解决方案。 6. 成功返回后,用同一连接检查实际工具并调用 `access_info`,核验本人身份和预期读取/工作记录能力。连接、完整技能加载、持久入口与自动保存分别验证;网页登录或授权码签发不等于连接成功。 连接核验后,继续下方持久工作流设置。 通过机器说明中的 `skill_url` 读取完整 Knowledge 指引并核验 `skill_sha256`;从同一已核验的包中读取指引所链接的参考资料。此步骤只是当前会话加载,不能证明后续会话自动加载。技能包可用于宿主支持的持久安装或团队分发;不声称 Grok Bot 支持任意 ZIP 导入。实际技能持久加载、自动行为、OAuth 与浏览器权限修复仍需分别核验。 核验:使用 `tools/list` 的实际工具定义,调用不带参数的 `access_info`。分别记录安装、实际加载、身份与权限、自动行为和可选浏览器操作;缺少证据就保持未验证。安装检查不读取公司业务资料、不创建共享记录。普通保存必需 `hive.read hive.work.append`,提议指引与导入来源为可选的单独能力,服务器仍检查员工资格。逐项核对实际返回的能力;只有读取权限时保存未就绪,可选导入未就绪不阻塞保存,不创建共享令牌或擅自扩大权限。需要验证真实检索时,使用已获准的选定资料,并区分工具成功与回答质量。 公司方法从同一中央目录发现和刷新;个人及软件开发任务不写入共享知识。导入资料仍未审核,人工审核与发布保持独立。MySQL、Snowflake 与 CCO 属于独立的 Autopilot Access 连接,需另行核验。 ## 标准自动业务保存 读取 https://knowledge.cyberflo.ai/setup/workflow.json 及当前宿主的 automatic_workflow。此软件维护的实时安装说明补充历史不可变包内 SETUP,不修改其字节、完整业务方法或原生信任。由智能体完成持久入口配置与核对,而不是让员工每次提醒保存。 普通 Knowledge 保存必需 read 与 work_append(hive.read hive.work.append)。guidance_propose、source_import 为可选能力,MySQL、Snowflake、CCO 的 Access 也为独立可选连接;这些可选业务能力不阻塞普通保存。权限资格与宿主实际请求的 OAuth 范围不同:保留所选不可变适配器的范围要求,仅在原生控制支持时选择最小同意;固定四项范围且员工拒绝的宿主仍需报告部分就绪,不能绕过验证。保留有效的更宽同意、明确窄权限、现有连接、禁用选择和用户修改。不为安装扩大员工资格、创建共享身份或重复登录。 ## 团队统一入口 受管理团队的标准设置包含一次管理员配置和每位员工自己的安装、连接。由获授权的团队管理员确认正确团队,在 Grok Bot 团队规则(Team Rules)中配置一个下列入口,范围仅选 Grok Bot;不是 Cursor 规则,也不是自动审批规则。创建或修改规则前,必须有明确的团队整体设置请求,并核验当前团队及管理员身份;个人安装请求本身不授权更改团队设置。先检查现有规则:准确匹配时复用,只更新已确认自身维护且名称和正文均完整匹配的版本;保留用户修改、停用选择和其他规则,不重复创建。保存后重新打开,回读名称、正文、启用状态与 Grok Bot 范围。不要更改授权、Auto-review、审批、其他团队策略或连接器权限。普通成员不修改管理设置;缺少此入口时只报告一次管理员步骤,并继续可独立完成的个人设置。 每位员工仍使用相同的私有入口技能、本人现有 Knowledge 连接及服务器权限;团队规则不分发连接或令牌,也不新增权限。核验团队入口前,先将名称与正文完整匹配的已知自身维护1.0.0/1.0.1/1.0.2私有入口,通过下方原生步骤更新为说明中选定的1.7.0引导;保留用户修改并完成本人连接设置,保留有效同意。没有 Team Rules 的个人账户只能依赖私有技能的尽力选择,不能保证新对话自动进入流程。已保存规则也不证明模型已收到指引或自动保存成功;仍需分别观察新业务对话及实际回执。 管理员应使用下列软件维护原文,不复制完整业务方法到团队规则: Autopilot business workflow / 公司业务工作流 ```text When Autopilot is enabled, before your first substantive answer to meaningful noncoding company work in every new chat, load the installed Autopilot automatic workflow private skill and follow its current shared instructions, even when the answer can be drafted from the prompt alone. Reuse fresh context and the same centrally authored methods. Preserve useful progress automatically only with existing sharing authorization and settled company audience and work; ask once if that choice is materially missing. Skip personal work, software development, secrets, private chats, transcripts and unchanged routine checks. A saved claim requires an actual receipt and exact readback; never recreate deleted records. If the workflow is unavailable, respect disabled choices, state the specific gap and continue independent work without a save. This entry rule grants no new access, consent or action authority and changes no approval controls. ``` SHA-256: `d10a8df2f83c47c36890ff12265540f83efc574f71ef3bc3e1ecb8fed5ecae94` 从 automatic_workflow.bootstrap 下载软件维护、独立版本和 SHA-256 固定的 JSON。用宿主原生私有技能工具,按其中的 skill_id、name、description、instructions 创建或复用本账户共享的引导技能,并完整回读内容与哈希。保留其他技能、用户修改和禁用状态;已有技能的名称、描述和正文都必须准确匹配当前版本或 previous_managed_skills 中同一旧版条目才可更新;仅正文哈希相同不授权覆盖用户修改的名称或描述。否则保留冲突并只问必要选择。此技能只是加载同一业务方法的宿主入口,不是个人业务规则变体,也不需要员工上传或发布手册。 连接器自定义说明只能作为附加入口:仅当为空或准确确认是自身维护内容时设置 connector_instructions;无法完整读取时保留已有说明。只设置连接器说明的原生测试曾漏记,不能代替私有技能。通过原生连接设置确认本账户的匹配连接对新 Bot 可用,再新建普通 Bot 验证自动技能选择;不能只在原对话说“记住”,也不能要求员工每次 /调用。技能库共享不保证每次模型选择,缺少真实行为证据仍标为未验证。 先复用当前本人的连接并调用 access_info。自动保存只需 hive.read hive.work.append;保留已有效的其他同意。若员工资格已满足、但原注册上限或令牌只有读取,重连或刷新不能增加范围:使用宿主支持的明确范围和公开 PKCE 客户端配置,通过本服务 /register 为本账户创建独立无密钥注册,然后仅处理缺少的本人同意。检查实际宿主回调并保持精确绑定;已核验的原生组合列于 consent_recovery,宿主变化不猜测或扩大列表。绝不复用维护者的客户端标识、共享令牌或改数据库;宿主不支持时报告准确缺口。 ## 使用时的兼容更新 本次标准安装设置智能体管理的兼容更新。下载并保留当前清单和专用交付目录,阅读新包内 references/client-updates.md。Claude、Cursor 与 DeepSeek 在使用时通过包内 Node 助手每日复用一次成功检查,校验固定来源、完整清单与不可变压缩包,再于安全任务边界通过原生生命周期应用。Grok 复用新业务对话原本要读取的宿主描述,检查 updates 与固定版本私有引导技能,使用原生私有技能工具更新完整匹配的自身条目。旧1.0.0需一次引导迁移;没有跨账户推送、隐藏任务或每次模型选择的保证。保留个人信任、有效连接、停用与用户修改;不为更新读取业务内容、创建记录或扩展授权。 分别核对:持久入口已配置、完整指引在新会话加载、同一连接具备读取和追加权限、该宿主原生入口实际执行、真实业务自动保存已观察。技术核对器、安装成功、技能可见或 work_append 为真,都不能合并为最后一项。没有真实任务时标为 awaiting_business_task,安装技术工作可以完成;安装检查不读取业务正文、不创建共享记录。 技术就绪后,用首次正常业务的新对话观察,开场不加入插件、Knowledge、技能或保存提醒。遵循既有共享授权与工作归属,个人、软件开发与无变化例行检查排除,没有记录配额。业务结束后再只读核对原请求的回执、准确记录、哈希和保存时间,确认早于任何后续审核提示;漏记保留为失败,不能先补记再报告自动成功。含糊归属只问一个有选项的问题,未回答不保存;未知或未同意权限保持部分就绪。详细结果保存在私有本地回执,最后只给简短就绪结果和一个必要下一步。 ## 同一个 Autopilot 先读取 https://knowledge.cyberflo.ai/autopilot.json。所有适配器使用同一个产品版本及 Knowledge、Autopilot、skill-builder、autopilot-update 四个完整技能;组件只负责宿主安装、连接和自动入口。按清单核验本机已安装和当前会话实际加载的版本,不能用下载或网页发布代替。 保留已有 hive-read 和 autopilot-access 连接;两者分别使用本人 OAuth 权限,不转发令牌。只有需要业务数据且缺少连接时,先读取 https://access.cyberflo.ai/setup.json;登录未就绪或宿主回调不支持时报告服务缺口,不反复要求同意,继续可用的 Knowledge 工作。客户端看到同一工具能力范围,实际权限、资料范围及服务是否启用由服务器决定。 旧版1.0.0、1.0.1和Grok私有引导1.0.2通过同一连接/更新流程迁移:校验已知自身文件及用户修改,只替换完整匹配的软件;缺少的新连接由本人单独同意,不阻止原有Knowledge使用。保留暂停、停用、退出、有效连接和原生信任。Codex使用已授权的每日更新;其他本机适配器使用每日实际使用时检查;Grok使用安全任务边界的私有技能维护,不宣称跨账户推送。