💬 AI ChatBot — 在 Scratch 中进行 AI 对话 #
AI ChatBot 扩展将 AI 对话功能带入 Scratch,同时支持 OpenAI 和 Gemini。
创建智能聊天机器人、制作互动故事项目、获得编程帮助、生成创意内容,还可以打造由 AI 驱动的助手—所有这些都可以通过连接 AI 提供商的简单积木完成。
非常适合正在探索 AI 的学生、教育工作者和创作者。 ✨

🌟 概述 #
- 真正的 AI 对话: 向 OpenAI 或 Gemini 提问并获得智能回答。
- 多个 AI 提供商: 可以在 OpenAI 和 Gemini 之间选择,每个提供商都有各自的 API Key 和模型列表。
- 可自定义 Persona: 设置助手名称、角色(teacher、storyteller、robot 等)和自定义性格。
- 上下文记忆: AI ChatBot 会记住对话历史,让交流更加自然流畅。
- 精细调整回答: 控制回答长度、创意程度、超时时间和回答风格。
- 设置简单: 添加你想使用的 AI 提供商的 API Key,就可以开始聊天!
✨ 主要特点 #
- 可以使用 OpenAI 和 Gemini 的聊天模型。
- 自动检测语言—使用用户所使用的语言回答。
- 6 种预设 Persona 角色:helper、robot、teacher、storyteller、kid、talking cat。
- 支持自定义 Persona 文本,创建独特的角色性格。
- 对话记忆—记住最近 10 个问题和回答,让对话更加自然。
- 可调整回答长度(max tokens)和创意程度(temperature)。
- 根据 AI 提供商显示对应模型—可以发现并使用 OpenAI 或 Gemini 的模型。
- 内置安全检查—自动阻止不适合儿童的内容。
- 默认设置安全、简短,并且适合儿童。
- 智能防错机制—帮助正确管理提供商的 API Key、模型和对话状态。
🚀 如何使用 #
- 前往: pishi.ai/play
- 打开扩展程序部分。
- 选择 AI ChatBot 扩展。
- 获取 API Key:
要使用 AI ChatBot,你需要为想使用的 AI 提供商准备一个 API Key。
学生:请让家长或老师帮助你创建账号。- 对于 OpenAI:前往 OpenAI Platform – API Keys.
- 对于 Gemini:前往 Google AI Studio – API Keys.
- OpenAI usage: Usage Dashboard.
- OpenAI billing: Billing.
- Gemini usage and billing: check Gemini pricing and your Google account billing settings.
- 登录或创建账号。
- 创建一个新的 API Key,并仔细复制。
- 复制时确保前后没有多余空格。
- 根据你的账号类型和 AI 提供商,可能会有费用或使用量限制。
- 为 [PROVIDER|rect] 设置 api 密钥:运行这个积木,然后选择要设置 API Key 的 AI 提供商。
- 使用 [MODEL] 回答:[MESSAGE|text]:使用这个积木向聊天机器人提出任何问题。
- 自定义(可选):设置助手名称、角色、Persona、模型和回答设置,创建最适合你的 AI 助手。
提示
- 可以先使用每个提供商的默认模型: {openai} gpt-4o-mini 用于 OpenAI, {gemini} gemini-2.5-flash-lite 用于 Gemini。
- 为了获得更好的回答,请让问题清晰、具体。
- 清除消息日志:使用此积木开始新的对话。
- 尝试不同的角色和 Persona,创建独特的角色。
- 留意你的 AI 提供商使用量,避免产生意外费用。
🧱 积木和函数 #
💬 主要交互 #
将问题或消息发送给所选的 AI 提供商,并以文本形式返回 AI 的回答。
这是与 AI 互动的核心积木—你可以提出任何问题并获得智能回答!
工作原理:
- 在 MESSAGE 输入框中输入你的问题或消息。
- 扩展会检查你的问题,确保内容适合儿童。
- 使用所选的 AI 提供商和模型生成回答。
- 聊天机器人会理解你的问题并创建回答。
- 回答也会经过检查,以确保适合儿童。
- 最终以文本形式返回回答—你可以让 sprite (角色) 说出来、显示在屏幕上,或用在任何你需要的地方!
- 对话会自动保存(最近 10 个问题和回答),让聊天机器人能够提供更连贯的回答。
示例:
- 使用 [{openai} gpt-4o-mini] 回答:[What is 5 + 3?|text] → AI ChatBot 回答:“8”
- 使用 [{gemini} gemini-2.5-flash-lite] 回答:[Tell me a joke|text] → AI ChatBot 会讲一个简短的笑话
- 使用 [{openai} gpt-4.1-mini] 回答:[What fun Scratch project should I make?|text] → AI ChatBot 会推荐一个项目创意
注意: 这个积木需要为所选 AI 提供商设置有效的 API Key。如果没有设置 API Key,它会返回一条易于理解的错误信息。
返回 AI ChatBot 最近一次生成的回答,而不会发起新的 API 请求。
如果你需要在项目中的多个地方使用上一次回答,这个积木非常有用。
工作原理:
- 返回最近一次 answer to: 积木生成的回答文本。
- 如果还没有生成过回答,则返回空字符串。
- 不会发起任何 API 请求—完全免费,而且立即返回!
- 每次使用 answer to: 积木后,这个值都会自动更新。
提示: 当你需要在项目中的多个地方使用同一个回答时,可以使用这个积木,避免不必要的 API 请求!
🎭 Persona 和角色自定义 #
设置 AI 助手显示的名称。
这会影响 AI 如何介绍自己,以及它在对话中的表现方式。
示例:
- 设置助手名称 [Scratch Helper|text]
- 设置助手名称 [Professor Bot|text]
- 设置助手名称 [Felix the Cat|text]
提示: 可以选择符合项目主题或角色设定的名称!
从预设菜单中设置 AI 的 Persona 角色。
不同角色会改变 AI 的表达和回答方式。
可用角色:
- helper — 友好的助手(默认)
- robot — 活泼有趣的机器人角色
- teacher — 耐心的 Scratch 老师
- storyteller — 富有创意的故事创作者
- kid — 使用友好的儿童式表达
- talking-cat — 来自 Scratch 项目的有趣猫咪角色
示例:
- 充当 [teacher] → AI 会像一位耐心的老师一样,清楚地解释概念
- 充当 [storyteller] → AI 会创作简短而有创意的故事
- 充当 [robot] → AI 会使用活泼有趣的机器人式语言
将自定义性格说明添加到 AI 的 system prompt (系统提示词) 中。
如果你想在预设角色之外进一步自定义角色,可以使用这个积木。
为了安全和性能,最多支持 500 个字符。
工作原理:
- 输入一段简短描述,说明你想要的性格或行为方式。
- 这段文本会加入 system instructions (系统指令),从而影响 AI 的回答方式。
- 保持简短清晰—AI 仍然会遵守安全规则和简短回答要求。
示例:
- 设置人设 [You are a pirate who loves treasure hunts|text]
- 设置人设 [You speak in rhymes and riddles|text]
- 设置人设 [You are enthusiastic about science experiments|text]
提示: 可以同时使用 set assistant name、act as 和 set persona,创建更丰富、更独特的角色!
🤖 AI 提供商和模型选择 #
模型直接通过以下积木进行选择: 使用 [MODEL] 回答:[MESSAGE|text].
模型下拉菜单会同时显示 AI 提供商和模型,因此选择一个模型时,也会同时选择对应的 AI 提供商。
默认模型:
- {openai} gpt-4o-mini — 快速、价格较低,适合大多数 OpenAI 项目(OpenAI 默认)
- {openai} gpt-4.1-mini — 较新的 OpenAI mini 模型
- {openai} gpt-4.1-nano — 速度非常快、规模较小的 OpenAI 模型
- {openai} gpt-4o — 功能更强的 OpenAI 模型,可以提供质量更高的回答
- {gemini} gemini-2.5-flash-lite — 快速、价格较低,适合大多数 Gemini 项目(Gemini 默认)
- {gemini} gemini-2.5-flash — 功能更强的 Gemini 模型,适合生成更详细的回答
注意: 这里显示的模型列表可能会发生变化。使用 update [PROVIDER] model list 积木时,扩展会使用该 AI 提供商最新的兼容聊天模型更新模型下拉菜单。
GPT-5 注意事项: GPT-5 模型会使用一部分 tokens 进行内部思考,因此扩展会自动为它们提供额外的 completion 空间,帮助回答完整结束。
如何选择:
- 对于日常聊天机器人和注重成本的项目,可以使用对应 AI 提供商的默认模型。
- 如果需要更深入的推理或更详细的解释,可以选择功能更强的模型。
- 如果想查看最新模型和价格,请查看对应 AI 提供商的官方文档。
注意: 每个模型的 token 价格不同—请留意使用量,以控制费用。
从所选 AI 提供商获取可用模型列表,并更新模型菜单。
返回符合筛选条件的模型列表,以逗号分隔,最多返回 50 个模型。
工作原理:
- 查询 AI 提供商的 API,获取可用模型。
- 过滤掉不适用于聊天的模型。
- 可以根据一段文字进行筛选(例如 gpt-4 或 gemini)。
- 以文本形式返回模型列表,同时更新模型下拉菜单。
示例:
- 更新 [openai|rect] 模型列表,过滤器:[gpt-4|text] → 列出 OpenAI 的 GPT-4 模型
- 使用 [gemini|rect] 模型列表,过滤器:[flash|text] → 列出 Gemini Flash 模型
- 使用 [openai|rect] 模型列表,过滤器:[openAI|text] → 列出 OpenAI 所有可用的聊天模型
提示: 可以在项目开始时使用这个积木,发现 AI 提供商新发布的模型!
返回 AI 提供商最近一次产生的错误信息;如果没有错误,则返回空字符串。
这个积木非常适合调试,也可以用于在项目中显示更友好的错误提示。
提示: 出现错误后,可以使用这个积木显示自定义信息,或判断请求是否失败。
⚙️ 回答设置 #
设置 AI ChatBot 回答的最大 token 数量。
Token 是单词的片段—大约 1 token = 0.75 words。
工作原理:
- 数值越高 = 回答越长、内容越详细。
- 数值越低 = 回答越短、更加简洁。
- 范围:1–2048 tokens(扩展会自动确保数值保持在安全范围内)。
- 默认值:360 tokens(~270 words)—让回答保持简短并适合儿童。
示例:
- 设置最大 tokens 数为 [50|text] → 非常简短的回答(1–2 句话)
- 设置最大 tokens 数为 [200|text] → 中等长度的回答(几句话)
- 设置最大 tokens 数为 [500|text] → 更长、更详细的解释
提示: 更短的回答速度更快、费用更低,也更方便儿童阅读!
控制 AI ChatBot 回答的创意程度和随机性(temperature 设置)。
可以从菜单中选择预设风格,也可以输入自定义值(0–2)。
选项:
- accurate (0) — 回答更专注、一致、可预测
- normal (1) — 在创意和准确度之间取得平衡(默认)
- creative (2) — 回答更加多样、有想象力,也更容易出现惊喜
示例:
- 回答类型:[accurate] → 适合数学、事实和需要保持一致的回答
- 回答类型:[creative] → 适合讲故事、头脑风暴和笑话
设置等待所选 AI 提供商回答的最长时间(单位:毫秒)。
如果请求超过这个时间,就会超时并返回错误。
默认值:30000(30 seconds)
示例:
- 设置超时时间 [60000|text] → 最多等待 60 seconds
- 设置超时时间 [15000|text] → 最多等待 15 seconds(网络较慢时可以更快发现失败)
提示: 对于复杂问题或速度较慢的网络连接,设置更长的 timeout 会更有帮助。
🗑️ 对话管理 #
清除与 AI ChatBot 的全部对话历史。
可以使用这个积木开始一段全新的对话,不带之前问题的上下文。
适合在以下情况使用:
- 开始新的话题或对话。
- 聊天机器人似乎弄混了,或仍在谈论之前的话题。
- 在测试或演示时,让助手“重新开始”。
- 对话已经持续很久(扩展会记住最近 10 个问题和回答,然后逐渐忘记更早的内容)。
注意: 助手的名称、角色、Persona、提供商和所选模型都会保持不变—只有对话记忆会被清除。
🔑 API Key 设置 #
打开输入窗口,以输入或更新所选提供商的 API Key。
你的密钥会保存在浏览器的会话存储中(关闭标签页时清除)。
使用方法:
- 点击这个积木。
- 选择要设置密钥的提供商。
- 屏幕上会出现文本输入窗口。
- 粘贴你的 API Key,然后点击 OK。
安全提示:
- API Key 只会暂时保存—仅在浏览器标签页打开期间保留。
- 关闭浏览器标签页后,密钥会被删除。
- 绝不要公开分享你的 API Key,也不要把它放进共享项目!
- 扩展会自动清理 API Key—删除复制时可能意外混入的不可见字符。
- 密钥只能包含普通英文字母和数字。如果粘贴了其他字符,你会看到一条易于理解的错误信息。
- 如果看到“无效字符”错误,请从提供商的控制台重新仔细复制密钥,再粘贴一次。
提示: 为不同项目分别创建 API Key,便于单独追踪使用量和费用。
🎓 教育用途 #
- AI 素养 —了解 AI 模型如何工作、提示词如何影响回答,以及如何负责任地使用 AI。
- 创造性学习 —制作互动导师、故事讲述者、角色扮演人物和教育聊天机器人。
- 语言能力 —与 AI 驱动的角色用不同语言练习真实对话。
- 理解 API —了解 Scratch 如何以简单直观的方式连接外部服务。
- 实体计算 + AI:
- 用自然语言控制机器人 —用“绕着正方形行驶”或“挥手打招呼”这样的语句指挥机器人。
- AI 决策 —将传感器与聊天机器人结合,让机器人决定下一步做什么。
- 表演故事的机器人 —聊天机器人编写场景,机器人用动作或 LED 将其表演出来。
🎮 示例项目 #
— 屏幕上的项目 #
- 互动故事讲述者 —AI ChatBot 根据玩家的选择创作新的故事章节。
- AI 问答生成器 —在游戏过程中即时生成源源不断的趣味问答。
- 创意写作伙伴 —几秒钟内获得角色、世界和情节转折的创意。
- AI 地牢主持人 —由聊天机器人担任完整的文字冒险游戏讲述者。
— 实体计算 + AI ChatBot #
- AI 机器人助手 —输入或说出“慢慢向前移动”或“像舞者一样旋转”等指令,让机器人执行。
- 能感知情绪的机器人 —聊天机器人理解用户消息,机器人用动作或 LED 情绪灯光做出反应。
- 互动宠物机器人 —聊天机器人负责性格和对话,机器人则配合移动或做出动画动作。
- 冒险机器人 —聊天机器人讲述故事,机器人用灯光或动作演绎故事情节。
- AI 任务转换器 —将“巡视房间”或“画一个正方形”等总体指令转换成一步步的机器人动作。
🧩 自己试试看: pishi.ai/play
🔧 提示和故障排除 #
💬 AI ChatBot 专属提示 #
- 出现“Enter the api key”错误? 需要先设置所选提供商的 API Key—点击“set api key for [PROVIDER]”积木,再粘贴从提供商控制台获取的密钥。
- 出现“API key contains invalid characters”错误? 复制粘贴时,有时会混入不可见字符!扩展会自动检查。回到提供商网站,仔细重新复制密钥并粘贴即可。
- 出现“Insufficient quota”错误或账单问题? 你的提供商账号可能已用完额度,或遇到了账单问题。可以充值,或试用其他提供商或模型。
- 出现“Let’s talk about coding and creativity instead!”? 这表示你的问题或 AI 的回答被判定为不适合儿童。别担心—换个关于编程、艺术、游戏或故事的问题试试!
- 出现“The answer was too long. Raise the max tokens and try again.”? 聊天机器人还有更多内容想说,却没有足够的输出空间!提高 max tokens 设置,就能获得更长的回答。
- 回答很慢? 试用所选提供商速度更快的模型,并检查网络连接。
- 回答太长? 降低 max tokens(简短回答可试用 50–120)。
- 回答太短? 提高 max tokens(详细回答可试用 200–500)。
- AI 没有按指令回答? 换一种方式提问,或清除对话记录后重新开始。
- 产生了意外费用? 在提供商的控制台查看使用量,并使用较小的模型来降低项目费用。
- 聊天机器人弄混了上下文? 提高超时时间,或检查网络连接。复杂的问题可能需要更长时间。
- 出现超时错误? 将 answers type 设置为“creative”,或提高 temperature。
- 想要更有创意的回答? 将 answers type 设置为“accurate”,或降低 temperature。
- 想要更稳定、更注重事实的回答? Set answers type to “accurate” or lower temperature.
- 同样的问题得到同样的回答? 如果连续两次提出完全相同的问题,扩展会重复使用上一次的回答,以节省时间和费用。对于简短问题(不超过 3 个单词),这一机制持续 2 秒;对于较长问题,则会持续到你提出不同的问题或更改设置。
- 还想使用上一次的回答? 使用“last answer”积木获取上一次的回答,无需再次调用 API—免费且立即返回!
❓ 为什么 AI 不能总是回答实时问题? #
由于 pishi.ai 使用专业的 AI 技术,它遵循与其他大型语言模型相同的设计原则。下面解释为什么它有时会回答“我不知道”:
- 固定的知识范围: AI 模型使用截至某个特定日期的大量信息进行训练。它们并未实时连接互联网,因此不知道此刻正在发生的事件。
- 独立工作空间的隐私保护: 你的 Scratch 项目是一个私密、独立的工作空间。为保护你的隐私,AI 不会自动获取电脑的位置信息、实时搜索结果或个人数据。
- 专注儿童与创意: 助手的设置旨在围绕编程、游戏、艺术和故事提供简短、适合儿童的回答。它并不是用来查询实时天气等详细的现实世界数据的。
🔒 隐私与安全 #
- 你的 API Key 会暂时保存在浏览器中—关闭标签页后就会消失。
- 所有对话都会发送到所选提供商的服务器进行处理—使用前请阅读其隐私政策。
- 除非你在账号设置中选择退出,否则提供商可能会使用对话数据来改进模型。
- 自动安全检查:你的问题和聊天机器人的回答都会经过检查,确保内容适合儿童。不合适的内容会被自动拦截—你只会看到一条建议改聊编程和创意话题的消息!
- 默认情况下,扩展会提供简短、安全且适合儿童的回答。
- 扩展只会记住最近 10 个问题和回答,避免对话变得太长或太混乱。
- 使用 AI 工具时,最好有家长或老师在身边—AI 虽然聪明,但仍可能犯错!
- 绝不要向 AI 聊天机器人分享个人信息(姓名、地址或密码)。
- 费用会从你的提供商账号扣除—请查看使用量,避免产生意外账单。
- API Key 可以用来访问你的提供商账号—绝不要公开分享,也不要把它放进共享的 Scratch 项目!
💰 费用与使用量 #
- 提供商按 token(输入 + 输出)收费请在 OpenAI 和 Gemini 的价格页面查看当前价格。
- 较小的模型通常更便宜—适合教育项目和实验。
- 在提供商的控制台查看使用量。
- 在账号设置中设定使用量上限,避免超支。
- 缩短 max tokens 设置,降低每次请求的费用。
- 可能提供教育优惠或赠送额度—请查看提供商的相关计划。
🧪 技术信息 #
- API: OpenAI 或 Gemini 聊天 API,以及共用的本地安全检查
- 默认模型列表: OpenAI 和 Gemini 中可用于聊天的模型
- 默认模型: OpenAI 默认为 gpt-4o-mini,Gemini 默认为 gemini-2.5-flash-lite
- 提供商: OpenAI 和 Gemini
- 对话记忆: 自动记住最近 10 个问题和回答
- 回答缓存: 重复的问题会立即返回缓存的回答—简短问题(≤3 个单词)缓存 2 秒,较长的问题缓存到内容发生变化为止
- 最大 token 数范围: 1–2048(默认值:360)
- temperature 范围: 0–2(默认值:1 / “normal”)
- 超时时间: 默认为 30 秒(可调整)
- 语言识别: 自动识别—AI ChatBot 会使用你提问时使用的语言回答
- 安全设置: 内置规则让回答简短、安全且适合儿童
- 安全检查: 自动检查你的问题和 AI 的回答
- API Key 存储: 暂时保存在浏览器中(关闭标签页时删除)
- 智能清理密钥: 自动删除复制粘贴时可能意外混入的不可见字符
- 智能重复使用回答: 如果连续两次提出同样的问题,你会立即得到上一次的回答(节省时间和费用!)
- 需要联网: 是—所有请求都会发送到所选提供商的服务器
🔗 相关扩展 #
- 🎤 语音识别 —将语音转换成文字,再发送给 AI ChatBot
- 🔊 文字朗读 —朗读 AI ChatBot 的回答
- 📝 翻译 —在不同语言之间翻译 AI ChatBot 的回答
- 🖼️ 图像训练器 —直接在 Scratch 中训练自定义模型
📚 了解更多 #
- pishi.ai 上的 AI 扩展帮助
- OpenAI API Keys
- OpenAI API 文档
- OpenAI 使用量控制台
- OpenAI 账单
- Gemini API Key
- Gemini API 文档
- OpenAI 价格
- Gemini 价格
- Scratch 创意
