Skip to main content
Agent Model 用于给白名单 staff 账号单独指定 AI Agent 所用的 LLM —— 在不动默认模型的前提下，让指定用户走另一个模型（例如灰度试新模型）。Payload Global，slug agent-model，源 src/operation/AgentModel.ts。

​
功能入口

Admin 侧边栏 → Operation → Agent Model https://op.kira.art/admin/globals/agent-model

​
数据模型

overrides: Array<{
  userId: string,   // 必填。Supabase user_profiles.id（UUID）
  label?: string,   // 仅供自己参考的备注（姓名 / 邮箱）
  model?: string,   // 留空则回退到默认模型
}>
字段类型必填说明
userIdtext✓该 staff 的 Supabase user_profiles.id（UUID）
labeltext备注名 / 邮箱，仅供识别
modeltext（自定义下拉）目标模型 ID；留空表示该用户回退到默认模型
每行对应一个 staff 用户 ID。
覆盖只对同时位于 kira-be STAFF_USER_IDS 中的用户生效 —— 在此添加 userId 之外，该用户还必须是 staff。

​
model 字段下拉（AgentModelSelector）

model 字段用自定义组件 AgentModelSelector（src/components/AgentModelSelector.tsx）渲染：
  • 下拉选项实时来自 GET /api/ai-gateway-models，该路由抓取 Vercel AI Gateway 的模型列表（https://ai-gateway.vercel.sh/v1/models），并用正则过滤掉非对话 / 推理模型（embedding、rerank、图像 / 视频生成等）
  • 第一项固定为 “Use default” 占位（值为空字符串），表示回退默认模型
  • 选项标签格式为 <Provider> · <model>，可输入关键字过滤

​
生效方式

无缓存，即时生效。AgentModel Global 的 access.read 为 () => true，由 kira-be 在请求时直接读取；保存后立即对相应 staff 用户生效，不经 KV 缓存、不需要 ISR 等待。

​
运营 SOP

1

确认 staff 身份

确保目标用户的 ID 已在 kira-be STAFF_USER_IDS 中。
2

添加覆盖行

Admin → Globals → Agent Model → 添加一行，填入 userId（UUID）。
3

选择模型

在 model 下拉中选择目标模型；如需回退默认则保持 “Use default”（留空）。
4

保存

保存后即时生效，无需等待缓存刷新。

​
相关