S.aiAI 工具实战课看图 · 照着做 · 卡住有办法
Grok · 课01 · 建议练习 90分钟

先分清 Grok、Grok Bot 与自建 API,再写任务说明

建议从这节开始:准备好本课虚构材料,先看下方图片,再照着步骤做。

入门普通 Grok 公开输入框;离线 Markdown;只核对是否有 Grok Bot 入口,不操作。完整课文、材料、练习和自检
学习记录与同步
未记录已阅读未记录练习已保存未记录小测自己逐项检查不等于认证
查看完整课文目录跟着做先这样问

这节要做成什么

完成 `00-scope.md`:分清四种产品,写好五项任务说明,并留下三条能回到虚构 brief 原文的行动项。

这节会打开:Grok Bot:先整理资料,再安全尝试 Bot 和本机 API · 普通 Grok 公开输入框;离线 Markdown;只核对是否有 Grok Bot 入口,不操作。

普通 Grok 网页对话、官方 Grok Bot、xAI Console/API,以及学习者自己写的本地 HTTP 服务是四种不同东西。自建 API 服务不是官方 Grok Bot,也不包括 Telegram、Discord、微信或 Slack 的第三方机器人。

官方 Bot 文档在 2026-10-21 显示:Bot 使用带浏览器、文件系统和终端的持久云端电脑。入口、套餐、桌面应用版本、连接器和组织控制会随账户不同;请以当前页面为准。
建议从这一课开始

先下载本节虚构材料,第一遍只看图片和步骤;确认自己找到入口后,再照着做。做不下去时,不要跳到高权限操作,直接用本页的“卡住怎么办”。

遇到不懂的词?点开看一句解释,不用先背概念
提示词
你交给 AI 的工作说明。写清要看什么、不能做什么、要留下什么;它不能替你打开权限,也不能替你确认结果。
上下文
这一次实际交给工具看的内容。聊天里提到文件名,不等于文件已经上传、被读到或理解正确。
项目 / 工作区
把同一件事的聊天、文件或设置放在一起的地方。不同产品叫法不同;不要假定它自动连上网盘、邮箱或所有旧聊天。
API
让程序调用服务的入口,常常和网页聊天是两套权限与收费。密钥像密码,不要放进提示词、网页前端或仓库。
命令行 / 终端
用文字命令操作电脑或工具的窗口,不是网页聊天。教材给出命令示例,不代表你的电脑已经安装、运行或通过测试。
连接器
把外部资料或工具接给 AI 的通道。看得到可连接的选项,不等于已经获准读取、写入或发送;先看范围和授权。
改动对比(Diff)/ 分支
改动对比会显示文件哪里变了;分支把新尝试放到单独副本,方便逐项看、测试和撤回。
试跑(dry-run)
先预览或模拟流程,不真实发送、付款、发布或改生产记录。试跑不是正式执行,也不是完成证明。
草稿 / 成品
草稿只是候选内容;有的产品把可展示内容叫 Artifact。文件能打开、来源能回查、人工检查通过后,才可以说它是可交付结果。
记忆(Memory)
有些产品会保存偏好或历史信息,开关和范围要按当前账号设置与官方说明核对。本课仍只使用明确给出的材料。
待确认
AI 可能写出听起来合理、却没有依据的话。找不到原始来源的数字、事实或结论,要写“待确认”,不能润色成肯定句。
检查与恢复
检查是按清单看文件、来源、公式或测试记录;恢复是回到可用的文件或版本。小测通过、多个 AI 答案相同,都不能代替这两步。

只准备这一节用得到的材料

先完成一个小动作

几分钟内获得三条可回查行动项,并将其与产品边界和停点保存到 A-course-source-map.md;这只是内部草稿,不证明已创建 Bot 或上传文件。

只依据这段虚构 brief:‘产品A入门课下周内测;负责人先核对资料来源;任何招生文案须人工批准。’输出三条行动项,每条附原句片段;不要发送、发布或假定看到了其他文件。

完成后回看来源。没有对应工具时,用同一小样本手工整理,并明确写“未在工具中执行”。

看清界面,再动手

先看图注中的产品、端和状态,再找相同文字或区域,然后才照下一步做。已登录实拍只证明图注写明的局部状态;官方参考不表示你的账号已连接、获权或执行。

公开应用状态实拍(未登录)同一端的定位参考,不证明本课已执行
图1 · Grok public web composer with Attach controlGrok web, unauthenticated public composer · 素材核验 2026-10-21

Real public application state captured in browser without sign-in. It establishes only the consumer-Grok composer and attachment location; it does not show a Grok Bot account, a completed upload, file reading, a Bot cloud computer, connector access, or a result.

查看原始来源 ↗
① 先找什么
中央空 composer、加号 Attach 和右上 Sign in/Sign up
② 正常会看到什么
能辨认这是普通 Grok 的未登录输入界面,尚无附件条目或任务结果。
③ 和图不一样怎么办
若当前账号跳入另一页面或没有 Attach,不猜测 Bot 权限;在 00-scope.md 记录页面入口和可见状态后走离线摘录路线。

现有画面只是一张普通 Grok 公开输入框;它能帮助定位消费者聊天入口,不能当作官方 Grok Bot 实拍。

分步跟做 · 完整课文

先确认自己打开的是哪一个产品和页面,再看图、读这一步、照着做。下方保留完整原课文、提示词和检查要求;找不到入口或结果不一样时,不要猜按钮,先用“卡住怎么办”。

**这节先做什么。**先新建一张范围卡,再写一段只让 AI 出计划的任务说明。这里的“任务契约”就是写清楚要 AI 做什么、能用哪些材料、不能做什么、做到哪里要停下的任务说明。

**完成后你能做什么。**你能分开说清 X 内 Grok、Grok.com、官方 Grok Bot 和 xAI API 自建应用,并写出不容易被误解的任务说明。不会编程也能开始;只要会查看本机目录和 Markdown 文件即可。今天不连接外部服务。

**先懂一句话。**Grok 是给人直接使用的 AI 助手。Grok Bot 有可持续使用的云端工作环境和具名角色。API 是程序接口;你的程序调用 API,只是 API 客户,不会因此拥有官方 Bot、连接器或云端电脑。1 3 所以“让机器人发消息”必须问清:是让它写草稿、等人审后发送,还是由你的程序调 API 返回一段文本。三种事的后果不同,检查方式也不同。

跟着做

  1. 在课程笔记新建 00-scope.md,先写四行:目标产品、账号入口、允许输入、禁止动作。先把“机器人”到底指什么说清,才不会一开始就交出秘密或碰生产数据。
  2. 打开本章开头的四个官方 URL,只记实际看得到的产品名、更新时间或版本、账户是否有入口。不要截图或记录令牌。能做什么,要以你当前账户为准,不能照搬旧教程。
  3. 在 practice/ 建立只读副本,例如 practice/raw/,把六个原始材料放进去。复制后计算文件哈希,或至少记下文件大小。这样原件和加工件分开,出错时有地方可回去。
  4. 建立 practice/outputs/ 与 practice/logs/。草稿只进 outputs;你做的决定写进 logs。这样不会让 AI 产物覆盖来源,也方便后来的人看懂发生过什么。
  5. 写任务说明的五项:成果、来源、计算规则、禁止项、停点。只要涉及发送、发布、删除、付款、改权限或生产修改,停点就要放在动作之前。官方也建议这类有后果的动作先获得批准。6
  6. 把下面的提示词放进官方 Grok 或 Grok Bot 的空对话,要求它只给计划。这叫 dry-run,也就是只预演、不执行。没有附件功能时就粘贴内容,不要说成已上传。

先这样问

你是青禾学习工作室的课程运营分析助理。
本次只做“任务计划”,不执行外部动作,不连接未明确授权的系统。
材料名称:brief.md、knowledge.md、acceptance.md。
目标:为产品A入门课提出一份可审核的资料整理方案。
请按以下顺序输出:
1. 你需要从每个文件提取的字段;
2. 事实、推断、待确认问题三栏;
3. 你不会做的动作清单;
4. 交付物文件名建议和人工复核点。
没有看到文件内容时,明确说“尚未看到材料”,不要补造内容。

**自己练一次。**为青禾的产品 A 入门课写一份不超过 180 字的任务说明。材料只能用 brief.md 和 knowledge.md;成果是 A-course-source-map.md;不能编造课程数据或发送招生消息;在“提交课程文案前”停下等待人确认。

**做完检查。**范围卡应明确写出“官方 Grok Bot”和“自建 API 服务”不是同一种产品。任务说明要有五项,并写明“没有看到材料时不推断”。

**容易卡住时。**把 X 的 @Grok、@bot 和第三方聊天平台账号混在一起时,回到官方入口,一项项记 URL 和产品名。只写“请处理一下”时,补上文件名、成果格式和停止位置。模型没见到附件却下结论时,要求它把结论改成“待材料验证”。

先照着做,再自己做一遍

先照着做

先对照上方图片和完整步骤,确认你输入了什么、看到了什么、在哪一步停下;不要只复制提示词。

换一小部分自己做

照四行范围卡分别写 Grok、Grok Bot、Console/API、自建本地服务的入口、能做什么和不能证明什么;再从教师给出的虚构 brief 摘录圈出一条原文依据。

自己独立完成

把虚构的“产品A开课需求”换成“产品C内训需求”,写一份不超过 180 字的任务说明,并在提交内训文案前停下等人确认。

这节要保存的文件

00-scope.mdA-course-source-map.md

这些文件名是本节的检查要求。只有你实际生成、保存并能打开,才算做成;下载的模板不是已经完成的结果。

文件不会上传。这个检查只看栏目,不会替你核对数字、事实、真实工具操作或组织批准。

自己逐项检查

勾选是你的自检记录,不是教师认证。最好请另一位人核对来源、公式或测试。

卡住怎么办

先停在当前步骤,记录页面上实际看到的文字和端别;不要为了和图一致而扩大权限、提交、发送或删除。

把 Grok 网页、Grok Bot 与 API Console 写成同一个产品。

回到四行边界卡,按入口、工作面、凭据和是否有云端电脑逐项重写。

模型在未见 brief 时仍给出行动项。

只保留能指向摘录的条目;其余标为“尚未看到材料/待确认”,不把它们写进成果。

确认自己真的分清了

每题都有解析,可以重复作答。答对概念题不等于已经在外部系统完成操作。

1. 未登录的 grok.com 空白输入框最能证明什么?
2. 哪一项应写在本课任务契约的停点?
3. 第一课最小的成果应该是什么?

记下这次,下次接着学

查看学习记录与同步 →

未登录时记录只留在当前浏览器。登录后,只有你确认合并并启用同步,状态和笔记才会同步;作业原文和文件不会上传。

按需阅读:本章概念、边界和原有流程图

05|Grok Bot:先把资料做成草稿,再安全尝试 Bot 和本机 API(12 × 90 分钟)

**先知道这章教什么。**这 12 课从一件很小的事开始:把一段虚构课程需求整理成三条有出处的行动项。接着,你会练习把资料、表格和会议纪要整理成内部草稿。后半段再讨论有资格时怎样使用官方 Grok Bot,以及怎样在自己的电脑上写一个只做测试的 xAI API 小服务。

**先把四个名字分开。**日常说“Grok”时,可能指四种不同东西:

  1. Grok.com 或 X 里的 Grok:用来对话、处理文件和查资料的消费者产品。X 帮助中心说明,Grok 可从 X 网页、iOS 或 Android 的导航区进入;它可能检索公开 X 帖子和实时网页,但也可能很有把握地说错。1
  2. 官方 Grok Bot:独立的桌面/移动端协作产品。xAI 文档把它描述为可长期工作的 AI 队友;每个 Bot 会在带浏览器、文件系统和终端的持久云端电脑上完成多步骤任务。3
  3. xAI API:让你自己的程序调用模型的接口。调用 API 不会自动给你官方 Grok Bot、连接器或云端电脑。2 7
  4. 你自己写的消息机器人:本章后半段会做一个本地 HTTP 小服务。它只是你的应用,不是官方 Grok Bot,也不是官方模型的私有部署。

**这章不做的事。**第三方 Telegram、Discord、微信、Slack 或网页插件即使叫“Grok bot”,也不能称为官方 Grok Bot。官方资料提到可以在 X 发帖或回复里标记 @bot,但要先连接 X 账户,而且不一定在所有地区开放。3 课堂不会登录、安装、创建密钥、连接账户,也不会调用外部系统。文中的路径、命令和提示词都只用来教学。

**上课前先看哪里。**分别打开 https://x.ai/bot、https://docs.x.ai/grok-bot/overview、https://grok.com/ 和 https://console.x.ai/。只记录你现在看得到的产品名称、版本或更新时间,以及账户有没有入口。不要记录令牌。入口、套餐、地区和应用版本都会变;如果没有看到教程里的区域或按钮,请按“创建 Bot / Connect apps / 设置 / API Keys / Models”等功能名找,不要猜测,更不要绕过限制。官方入门页也要求先有合格访问权限,才能下载、登录和创建第一个 Bot。4

**练习材料放哪里。**把 sales.csv、leads.csv、meeting.md、brief.md、knowledge.md、acceptance.md 放进课程 practice/ 目录,或作为课堂附件使用。不要假定 Grok 已连接你的网盘、邮箱、CRM 或本地文件。sales.csv 固定遵循:gross_revenue = units * unit_price,net_revenue = gross_revenue - refund_amount。这两个都是收入指标,不是净利润。其中有重复 order_id 和缺失 channel,要先保留、标记并单独说明影响,不能悄悄去重或补值。leads.csv 也有重复线索和缺失 email,所有联系方式都是课堂虚构数据。

这是教学示意,不是界面实拍。

任务说明 / 附件 → Bot 的草稿与过程 → 人来检查 → 保存到工作区或交付

真实界面会变化。看“任务、附件、工作区、审批、结果”这些功能区域,不要把这张示意当成截图。

Grok Bot 任务、复核与交付流程

本章的官方参考与版本核对