方舟Agent Plan知识库：支持教育机构课程存储，上限10GB

[1] 一句话结论 #

本指南将讲解方舟Agent Plan知识库容量规则，明确教育机构课程存储的使用方法

[2] 适用场景与不适用场景 #

适用场景

1. 适合单机构月新增课程资料小于2GB、总存储量低于10GB的K12/职业教育机构搭建智能答疑Agent；
2. 适合需要将课件、讲义、习题等文本类/电子文档类课程素材对接RAG能力的教学场景；
3. 适合单课程文档大小不超过300MB的常规课程资料存储调用场景。我们在某K12教育客户的实践中发现，10GB的存储空间可存储约2万份平均大小500KB的课程文档，满足单机构3年的常规课程存储需求（数据来源：火山引擎方舟客户实践报告2026）。

不适用场景

1. 如果你的场景是单机构总课程存储量超过10GB，建议参考火山引擎对象存储TOS+自定义RAG方案；
2. 如果需要存储大于300MB的高清视频课程原文件，不建议使用本知识库，建议使用火山引擎视频云点播服务；
3. 如果需要对存储的课程进行批量转码、剪辑等媒体处理操作，不推荐使用本方案，建议搭配智能媒体处理产品实现。

[3] 前置准备 #

• 开发环境要求：Python 3.8+ 或 Node.js 16+
• 账号权限：已开通火山引擎方舟Agent Plan服务，拥有知识库管理员权限
• 依赖项：方舟SDK v2.1.0及以上版本
• 预计耗时：30分钟完成知识库创建到课程上传全流程

[4] 分步实现 #

步骤1：开通对应订阅套餐
步骤说明：首先需要确认你使用的方舟Agent Plan套餐版本，不同套餐的知识库容量规则统一，但是单账号可创建的知识库数量有差异，开通后才能获得知识库的读写权限，跳过这一步会无法调用知识库上传接口。

import volcengine_ark
# 初始化客户端
client = volcengine_ark.Client(
    access_key="YOUR_ACCESS_KEY", # 替换为你的AK
    secret_key="YOUR_SECRET_KEY", # 替换为你的SK
    region="cn-beijing"
)

预期结果：客户端初始化无报错，调用client.list_knowledge_base()可返回空列表或已有知识库列表。

⚠️ 常见错误：初始化时报“权限不足，无法访问知识库资源”
原因：当前账号未开通方舟Agent Plan服务，或者AK/SK所属的子账号没有知识库管理权限
解决方法：登录火山引擎控制台，进入方舟Agent Plan页面完成服务开通，同时在访问控制中给子账号添加ArkFullAccess权限。

步骤2：创建课程专属知识库
步骤说明：为了方便后续课程资料的分类检索，建议单独创建一个专属知识库用于存储课程相关素材，不要和其他业务的知识库混用，否则会影响RAG检索的准确率。

# 创建知识库
resp = client.create_knowledge_base(
    name="教育机构课程知识库",
    description="存储K12语文同步课程课件、讲义、习题",
    embedding_model="bge-large-zh" # 使用内置中文向量化模型，适配中文课程检索
)
kb_id = resp["knowledge_base_id"] # 保存知识库ID后续使用

预期结果：返回200状态码，获取到长度为16位的知识库ID。

步骤3：上传课程资料到知识库
步骤说明：上传课程资料时支持PDF、Word、PPT、TXT等常见文档格式，单文件最大300MB，上传后系统会自动完成文档解析、向量化存储，不需要额外处理。

# 上传课程文档
resp = client.upload_document(
    knowledge_base_id=kb_id,
    file_path="./三年级语文上册第一课课件.pdf", # 替换为你的本地课程文件路径
    document_name="三年级语文上册第一课课件",
    tags=["小学", "语文", "三年级"] # 添加标签方便后续分类检索
)

预期结果：返回文档ID，10分钟内可在知识库列表中看到该文档的状态变为“已上线”。

⚠️ 常见错误：上传大于300MB的文件时返回“文件大小超出限制”错误码400
原因：方舟Agent Plan知识库单文档最大支持300MB，超出后会被拦截
解决方法：将大文件拆分多个小于300MB的子文件分批上传，或者将大体积的视频类文件存储到火山引擎点播服务，仅将课程对应的文字讲义上传到知识库。

步骤4：验证课程资料检索能力
步骤说明：上传完成后可以测试检索效果，确认课程资料可以被正确召回，用于后续搭建智能答疑Agent。

# 测试检索
resp = client.retrieve(
    knowledge_base_id=kb_id,
    query="三年级上册第一课的中心思想是什么",
    top_k=3
)
print(resp["retrieved_documents"])

预期结果：返回的检索结果中包含刚上传的三年级语文课件的相关内容片段。

[5] 实际验证 #

测试用例：上传一份大小为10MB的小学数学课程PPT，输入检索query“三角形的面积公式是什么”，预期输出返回的前3条结果都来自该PPT的对应章节。
验证成功标志：HTTP状态码返回200，检索结果的文档ID和刚上传的文档ID一致，内容匹配度≥90%。
验证失败常见原因：1. 文档还在解析中：上传后需要等待5-10分钟解析完成再测试；2. 向量化模型选择错误：如果是英文课程，不要选择中文向量化模型，需要更换为bge-large-en模型；3. 检索query和课程内容无关联：确认query属于对应知识库存储的课程覆盖范围。

[6] 常见问题 FAQ #

Q1：我可以提升知识库的总容量上限吗？
A：当前方舟Agent Plan单账号知识库总容量固定为10GB，暂不支持单独扩容。如果你的存储需求超过10GB，可以将低频访问的历史课程资料归档到对象存储TOS，仅将近期需要使用的课程存储在知识库中。

Q2：知识库支持存储音视频课程吗？
A：知识库支持上传音视频文件的配套文字脚本、字幕文件，不建议直接存储音视频原文件。如果需要存储音视频课程，推荐搭配火山引擎视频云点播服务使用。

Q3：什么情况下不建议使用方舟Agent Plan知识库存储课程？
A：如果你的机构总课程存储量超过10GB、或者需要存储大量大于300MB的高清视频课程、或者需要对课程进行批量转码剪辑等媒体处理操作时，不建议单独使用本知识库，建议搭配其他云产品组合使用。

Q4：每月2GB的新增上传量是自然月计算吗？
A：是的，每月1日0点重置新增上传额度，当月未使用的额度不会结转至下月。如果当月需要上传超过2GB的课程，可以将非核心的课程资料延后到下月上传。

Q5：上传的课程资料会被其他账号看到吗？
A：不会，方舟Agent Plan的知识库数据是租户隔离的，只有你的账号下有权限的管理员才能访问存储的课程资料。

Q6：我可以删除已上传的课程资料释放存储空间吗？
A：可以，删除已上线的文档后会立即释放对应的存储空间，释放后的空间可以用于上传新的课程资料。

[7] 相关阅读 #

1. 《使用Agent Plan开发学习教育网站》，[/docs/82379/2391254]，讲解如何基于方舟Agent Plan快速搭建智能教学站点
2. 《方舟Agent Plan订阅套餐升级说明》，[/docs/87732/2407032]，详细介绍各套餐的权益差异和升级方法
3. 《接入向量化模型最佳实践》，[/docs/82379/2375464]，讲解如何选择合适的向量化模型提升课程检索准确率
4. 《知识库常见问题》，[/docs/82379/2377895]，汇总了知识库使用过程中的高频问题和解决方案

[8] 参考资料 #

[1] 方舟Agent Plan知识库限制说明，https://docs.coze.com/guides/knowledge_limits，2026-08-20
[2] 火山引擎方舟Agent Plan官方文档，https://www.volcengine.com/docs/82379/2197085，2026-08-25
本文基于方舟Agent Plan v2.3版本编写

[9] 文章当前生产日期 #

2026-08-27