应用(App)

一个 App = 一个可发布的喵喵分身:它绑定自己的提示词(或人格)、模型、工具与知识库开关,并拥有专属的 App 级 API key。把那把 key 发给一台设备 / 一个产品 / 一个客户,对方调 /v1/agent 时拿到的就是这个分身——key 决定身份,请求体里什么都不用多传。

概念(30 秒)

三步发布一个分身

bash
# 1) 建 App(用租户通用 key)
curl -X POST "$BASE/v1/apps" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"name": "客服喵", "system_prompt": "你是 XX 产品的客服…", "kb_enabled": true}'
# → 201 {"id": "<app_id>", …}

# 2) 给它签 App 级 key(明文只回显这一次)
curl -X POST "$BASE/v1/apps/<app_id>/keys" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" -d '{}'
# → 201 {"key": "sk-meow-…", "app_id": "<app_id>", …}

# 3) 用 App key 对话——就是这个分身在说话
curl -N "$BASE/v1/agent" \
  -H "Authorization: Bearer <App key>" -H "Content-Type: application/json" \
  -d '{"text": "你好", "session_id": "device-001"}'

控制台「应用」区提供其中最常用的部分:新建、列表、删除、签发 key(建好就能 粘进试聊框体验)。改名/改 prompt/改模型覆盖/配工具白名单这几样,目前走 PUT /v1/apps/:id(或 /console/apps/:id)接口——UI 编辑卡在路上,接口先行。

配置回落(三级,逐字段)

App 级 key 的每个配置字段独立回落,App 配了用 App 的,没配承租户,租户也没配用平台默认:

字段App 配置② 租户(控制台「模型设置」等)③ 平台默认
提示词system_prompt > persona_id→人格库(请求级 persona_id/persona,见下)→ 租户默认人格默认人格「喵喵」
模型model租户模型设置MiniMax-M3
思考开关thinking租户思考开关关
温度temperature租户温度不传(provider 默认)
知识库kb_enabled(false = 该 App 恒关,与请求 kb:false 同效)—(租户有文档即默认开)开
工具tools_enabled 白名单([] = 全禁)—全部内置工具

提示词的完整优先级(产品语义:App 主人说了算):

code
app.system_prompt  >  app.persona_id→人格库  >  请求体 persona_id / persona  >  租户默认人格  >  平台默认喵喵

即:App 显式配置 > 请求级参数 > 默认——给 App 配了提示词后,调用方在请求体里传 persona 也覆盖不掉(防止终端用户改写你发布的分身);App 什么都没配时,请求级参数照常生效(与通用 key 行为一致)。App 引用的人格被删除后静默回落下一级,不报错。

最小权限(App 级 key 能干什么)

端点通用 keyApp 级 key
/v1/agent、/v1/sessions/*、/v1/tts*、/v1/asr、/v1/kb/*✓✓(对话按其 App 配置)
/v1/apps*(全部管理端点)✓403「App 级 key 无管理权」

注意:App 级 key 目前仍可读写本租户知识库(/v1/kb/*)——KB 是租户级资源,App 只有「注入开关」;若你要把 App key 发给不受信的终端,请评估这一点(更细的按 App 限权在路线图上)。

管理 API 一览(双面同形)

机器面 /v1/apps* 用 Bearer 租户通用 key;控制台面 /console/apps* 用登录会话,行为逐字节相同:

方法与路径作用
GET /v1/apps列本租户全部 App
POST /v1/apps新建(name 必填;其余字段可缺省 = 不覆盖)
GET /v1/apps/:id详情
PUT /v1/apps/:id整体更新(缺省字段 = 清回「不覆盖」,非逐字段 PATCH)
DELETE /v1/apps/:id删除:其全部 App key 同步撤销(立刻 401);会话历史保留(归租户)
POST /v1/apps/:id/keys签发 App 级 key(可带 rate_limit,口径同通用 key;明文只回一次)

与人格库 / 知识库 / 模型设置的关系

常见问题