必须显式注入知识库ID才能启用MiniMax Agent引用内部文档，需通过Minimax Data Platform上传文件生成kb_abc123xyz类ID，并在API请求body中以数组形式传入knowledge_base_ids字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让 MiniMax Agent 在回答用户问题时自动引用企业内部文档、FAQ 或产品手册，必须将知识库 ID 显式注入 API 请求体，而非依赖模型默认记忆或后台自动关联。
创建并获取知识库 ID
Minimax Data Platform 是唯一支持直接上传文档并生成可调用知识库 ID 的官方通道，不经过此步骤，后续 API 调用将无法绑定私有知识源。
登录 Minimax 控制台 → 进入【知识库管理】→ 点击【新建知识库】→ 类型选“文档” → 填写名称（如“售后知识库”）→ 点击【下一步】。
点击【上传文件】，支持 PDF/TXT/MD 格式，单次最多 10 个文件，总大小 ≤200MB；【注意：上传后系统需 30～120 秒完成解析与索引，此时知识库状态为“处理中”，不可立即调用】。
状态变为“已就绪”后，在知识库详情页复制 knowledge_base_id，格式类似 kb_abc123xyz —— 这是后续 API 中唯一有效的知识标识符。
在 Agent API 请求中启用知识库
MiniMax Agent 接口不支持全局绑定知识库，必须在每次 chatcompletion 请求的 JSON Body 中显式传入 knowledge_base_ids 字段，否则模型完全无视私有资料。
构造 POST 请求至 https://api.minimax.chat/v1/text/chatcompletion，Header 必须包含：
Authorization: Bearer {your_api_key}
Content-Type: application/json
x-group-id: {your_group_id}
Body 中添加字段 "knowledge_base_ids": ["kb_abc123xyz"]，该字段必须为字符串数组，即使只用一个知识库也要写成数组形式；【若写成 "knowledge_base_ids": "kb_abc123xyz"（非数组），API 将静默忽略该参数，且不报错】。
确保 messages 数组至少含一条 user 消息，例如 [{"role":"user","content":"如何更换电池？"}]，其他字段如 agent_id、model 可按需补充。
验证知识库是否生效
发送请求后，检查响应中 choices[0].message.content 是否出现明显基于上传文档内容的回答；若回答泛泛而谈或答非所问，说明知识库未命中。
第一步：确认知识库内含关键词“更换电池”的原文段落，且该段落在上传后被成功切片并索引（可在知识库详情页的“文档分块预览”中查看）。
第二步：在请求 Body 中临时增加 system 角色消息：“请严格依据参考资料作答；若参考资料未提及，请回答‘未找到相关信息’。”这能强制模型不自由发挥。
第三步：对比两次响应——加了 system 指令后若返回“未找到相关信息”，说明检索失败，需检查文档格式（如扫描版 PDF 不可被解析）或文本块长度（超 512 字符会被截断）。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
