API 参考
应用管理
用 API 创建、列出、修改、删除 LMU AI 应用(智能体)。应用承载提示词、对话模型、关联知识库等配置。
应用(在接口中称为 model)是一个智能体实例。以下接口用于以编程方式管理应用。
本组接口为账户级操作,鉴权只需 apiKey(不含 appId):Authorization: Bearer {apiKey}。
创建应用
POST https://ai.lmuai.com/api/model/create请求体:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 是 | 应用名称 |
import requests
def create_app(api_key: str, name: str):
resp = requests.post(
"https://ai.lmuai.com/api/model/create",
headers={
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json",
},
json={"name": name},
)
resp.raise_for_status()
return resp.json()["data"] # 返回新应用的 appId
print(create_app("sk-v45kgtllywo9kol9io3eic04", "我的客服助手"))响应 data 字段即为新应用的 appId:
{ "data": "657045ffdf7ecc9d3ab8885c" }单个账户最多创建 10000 个应用。
应用列表
GET https://ai.lmuai.com/api/model/listimport requests
def list_apps(api_key: str):
resp = requests.get(
"https://ai.lmuai.com/api/model/list",
headers={"Authorization": f"Bearer {api_key}"},
)
resp.raise_for_status()
return [(m["_id"], m["name"]) for m in resp.json()["data"]["myModels"]]
print(list_apps("sk-v45kgtllywo9kol9io3eic04"))
# [('65704d53431e4498edd42ee7', '应用1'), ('657045ffdf7ecc9d3ab8885c', '应用2')]响应结构:
{
"data": {
"myModels": [
{ "_id": "657045ffdf7ecc9d3ab8885c", "name": "应用2", "avatar": "/icon/logo.png", "intro": "" }
],
"myCollectionModels": []
}
}| 字段 | 说明 |
|---|---|
myModels | 我创建的应用。 |
myCollectionModels | 我收藏的、由他人共享的应用。 |
修改应用
POST https://ai.lmuai.com/api/model/update?modelId={appId}modelId 通过查询参数传入;请求体为应用配置:
| 字段 | 说明 |
|---|---|
name | 应用名称 |
avatar | 头像路径 |
intro | 简介 |
chat.systemPrompt | 系统提示词 |
chat.chatModel | 对话使用的模型 |
chat.temperature | 采样温度 |
chat.maxToken | 最大 token |
chat.relatedKbs | 关联的知识库 ID 列表 |
chat.searchSimilarity | 知识库检索相似度阈值(0~1) |
chat.searchLimit | 知识库检索条数 |
share.isShare | 是否公开共享 |
import requests
def update_app(api_key: str, app_id: str):
resp = requests.post(
f"https://ai.lmuai.com/api/model/update?modelId={app_id}",
headers={
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json",
},
json={
"name": "客服助手",
"avatar": "/icon/logo.png",
"intro": "",
"chat": {
"relatedKbs": [],
"searchSimilarity": 0.8,
"searchLimit": 5,
"searchEmptyText": "",
"systemPrompt": "你是一个专业的客服,请礼貌回答用户问题。",
"limitPrompt": "",
"maxToken": 4000,
"temperature": 0,
"chatModel": "gpt-3.5-turbo-16k",
},
"share": {"isShare": False, "isShareDetail": False, "intro": ""},
},
)
resp.raise_for_status()
return resp.json()
update_app("sk-v45kgtllywo9kol9io3eic04", "657045ffdf7ecc9d3ab8885c")删除应用
POST https://ai.lmuai.com/api/model/del?modelId={appId}import requests
def del_app(api_key: str, app_id: str):
resp = requests.post(
f"https://ai.lmuai.com/api/model/del?modelId={app_id}",
headers={"Authorization": f"Bearer {api_key}"},
)
resp.raise_for_status()
return resp.json()["data"]
del_app("sk-v45kgtllywo9kol9io3eic04", "657045ffdf7ecc9d3ab8885c")