AI教案生成配置：从零搭建可用的自动备课流程

知识分享

2026-10-26 02:40

16 阅读

想用AI自动生成教案，核心是把模型接口、提示词模板和输出格式这三件事配置对。
下面按零基础也能照做的顺序，从准备到验证一步步说明。

开始前需要准备什么

你需要一个支持API调用的AI模型服务（例如OpenAI、DeepSeek或通义千问等），并获取对应的API Key。
同时准备一台能运行Python或Node.js的电脑，或者直接使用支持自定义API的客户端工具（如Cherry Studio、Chatbox）。
如果使用代码方式，建议安装Python 3.9以上版本。

关键检查项：

API Key是否有效、余额是否充足
网络能否正常访问模型服务地址（部分服务需要配置代理）
是否明确教案的学科、年级、课时长度和输出格式要求

配置API连接与基础参数

以Python环境为例，先安装官方SDK（以OpenAI兼容接口为例）：

pip install openai

然后创建配置文件 config.py，填入你的API Key和服务地址：

# config.py
API_KEY = "sk-你的实际密钥"
BASE_URL = "https://api.openai.com/v1"  # 换成你所用服务的地址
MODEL = "gpt-4o-mini"  # 按服务商支持的模型名填写

如果使用图形客户端，在设置中找到“API密钥”和“自定义接口地址”两栏，分别粘贴密钥和地址，保存后测试连接。

注意： 不要把API Key直接写进公开的代码仓库，建议用环境变量读取：

import os
API_KEY = os.getenv("AI_API_KEY")

编写教案生成提示词模板

提示词决定输出质量。
一个可用的模板应包含角色设定、任务描述、输出结构和约束条件。
例如：

你是一位有10年经验的小学数学教师。请为[年级][学科]生成一份[课时长度]的教案，包含以下部分：
1. 教学目标（知识、能力、情感三个维度）
2. 教学重难点
3. 教学准备
4. 教学过程（导入、新授、练习、小结，每步注明时间）
5. 板书设计
6. 课后作业
要求：语言简洁，环节时间总和不超过40分钟，输出使用Markdown格式。

将模板保存为 prompt_template.txt，代码中读取后替换变量：

with open("prompt_template.txt", "r", encoding="utf-8") as f:
    template = f.read()
prompt = template.replace("[年级]", "三年级").replace("[学科]", "数学").replace("[课时长度]", "40分钟")

调用生成并处理返回结果

使用以下代码发起请求并保存教案：

from openai import OpenAI
from config import API_KEY, BASE_URL, MODEL

client = OpenAI(api_key=API_KEY, base_url=BASE_URL)
response = client.chat.completions.create(
    model=MODEL,
    messages=[{"role": "user", "content": prompt}],
    temperature=0.7,
    max_tokens=2000
)
lesson_plan = response.choices[0].message.content
with open("教案输出.md", "w", encoding="utf-8") as f:
    f.write(lesson_plan)
print("教案已生成，请查看 教案输出.md")

参数说明： temperature 控制随机性，教案场景建议0.5~0.7；max_tokens 根据教案长度调整，一般1500~2500足够。

常见报错与避坑

401 鉴权失败：检查API Key是否复制完整、是否有多余空格，确认服务地址与Key匹配。
429 请求过多：降低调用频率，或检查账户余额和速率限制。
输出内容截断：调大 max_tokens，或让模型分段生成。
格式不符合预期：在提示词中明确“只输出Markdown，不要额外解释”，并给出示例结构。
中文乱码：保存文件时统一使用UTF-8编码。

重要提醒： 生成后的教案需要教师人工复核，特别是知识点准确性和课时分配，不要直接用于课堂而不检查。

验证配置是否生效

运行脚本后，检查三点：

终端是否打印“教案已生成”且无报错；
打开 教案输出.md，确认包含教学目标、重难点、教学过程等完整板块；
随机抽取一个环节，核对时间加总是否与设定课时一致。

如果输出缺少板块，回到提示词模板补充对应条目；
如果内容过于简略，在模板中增加“每个环节至少写2句话”之类的细化要求。

关于模板复用与调整

同一份模板可以复用于不同年级和学科，只需替换变量。
建议为每个学科单独保存一份模板文件，避免频繁修改主模板。
如果后续需要批量生成，可以在代码外层加一个循环，读取Excel中的课题列表，逐个替换变量并保存为独立文件。

配置完成后，你就有了一条可重复使用的AI教案生成流程。
遇到异常时，优先检查API连接和提示词结构，这两处是大多数问题的来源。

AI作业批改配置：从零搭建自动批改服务的完整步骤

AI试题生成配置：从零搭建可用的题目自动生成服务