API 参考
知识库
LMU AI 知识库接口。向知识库写入问答数据(index / qa 两种模式),以及对应用关联的知识库做向量检索。
知识库(kb)是可挂载到应用上的向量化数据集,用于检索增强(RAG)。kbId 可在控制台进入知识库后从浏览器地址栏获取。
写入数据
POST https://ai.lmuai.com/api/openapi/kb/pushData请求头使用 apikey(注意是单独的请求头,非 Authorization):
| 参数 | 类型 | 说明 |
|---|---|---|
kbId | string | 知识库 ID |
mode | string | index 或 qa |
prompt | string | qa 拆分引导词,只需告诉模型「这是什么」;index 模式可忽略 |
data | array | 问答数据,每项含 q、a |
模式与 token 限制:
| 模式 | 行为 | token 限制 |
|---|---|---|
index | 直接将 q 转成向量存储,a 原样入库。 | q + a 总量建议不超过 3000 token,否则对话时易超限。 |
qa | 只关注 q,交给大模型按 prompt 拆分成问答对(已默认套用输出格式)。 | q 不要超过 3300 token。 |
curl https://ai.lmuai.com/api/openapi/kb/pushData \
-H "apikey: sk-v45kgtllywo9kol9io3eic04" \
-H "Content-Type: application/json" \
-d '{
"kbId": "64663f451ba1676dbdef0499",
"mode": "index",
"prompt": "qa 拆分引导词,index 模式下可忽略",
"data": [
{ "q": "什么是基金投资?", "a": "基金投资是……" },
{ "q": "什么是股票投资?", "a": "股票投资是……" }
]
}'响应:
{
"code": 200,
"statusText": "",
"message": "共插入 2 条数据",
"data": 2
}应用知识库检索(Beta)
仅检索、不对话,返回命中的知识库结果。目前仅检索最后一个问题(prompts[prompts.length - 1])。
POST https://ai.lmuai.com/api/openapi/kb/appKbSearch| 参数 | 类型 | 说明 |
|---|---|---|
appId | string | 应用 ID |
similarity | number | 向量相似度阈值,0~1,越大越相似 |
limit | number | 返回条数 |
prompts | array | 提问列表,每项含 obj(Human)与 value |
curl https://ai.lmuai.com/api/openapi/kb/appKbSearch \
-H "apikey: sk-v45kgtllywo9kol9io3eic04" \
-H "Content-Type: application/json" \
-d '{
"appId": "642adec15f01d67d4613efdb",
"similarity": 0.8,
"limit": 5,
"prompts": [
{ "obj": "Human", "value": "导演是谁" }
]
}'响应:
{
"code": 200,
"data": {
"code": 200,
"rawSearch": [
{ "id": "19339", "q": "电影《铃芽之旅》的导演是谁?", "a": "电影《铃芽之旅》的导演是新海诚。" }
],
"userSystemPrompt": { "obj": "System", "value": "知识库:……" },
"quotePrompt": { "obj": "System", "value": "知识库:……" }
}
}| 字段 | 说明 |
|---|---|
rawSearch | 命中的知识库原始数据。 |
userSystemPrompt | 拼接后的系统提示词。 |
quotePrompt | 知识库相关的引用提示词。 |