# 通过在线演示了解 Kaeso 如何工作

demo.kaeso.app 一键打开一个真实的 Kaeso 控制台，里面是一个示例组织，无需账户，也无需安装。本文介绍看点、演示的行为方式，以及如何自建演示。

网页：https://kaeso.app/zh-CN/articles/kaeso-demo
其他语言：[English](https://kaeso.app/articles/kaeso-demo.md) · [Deutsch](https://kaeso.app/de/articles/kaeso-demo.md)

作者：Kaeso Team · 6 November 2026

在此之前，想看到 Kaeso 的控制台，只能先安装 Kaeso。对于只想先看看它长什么样的人来说，这个要求太高了。所以现在 [demo.kaeso.app](https://demo.kaeso.app) 上有了一个在线演示：一个真实的 Kaeso 实例，运行最新版本，带有示例数据，对所有人开放。

打开它，选择**浏览演示**，就进去了。不用创建账户，不用确认邮箱，也不用安装任何东西。

## 里面有什么

您会以 Ada Okafor 的身份进入。她是 Northwind Labs 的所有者，这是一家虚构的公司，通过 Kaeso 运行自己的 AI 功能。您看到的一切都来自开发控制台时使用的示例数据：

- **5 个项目**：Checkout assistant、Support triage、Search ranking、Research agent 和 Internal tools，各有自己的模型、密钥和用量。
- **6 个人**，角色各不相同，从所有者、管理员到开发者和成员。
- **Anthropic 和 OpenAI 的服务商密钥**。它们只是占位符，从不会发到服务商。
- **70 天的用量**，总是截止到昨天，所以图表看起来就像一个每天都在使用的实例。

![演示中组织的概览：最近 30 天的请求、Token、费用和错误，各自与之前 30 天比较，下方是每天请求和错误的图表](https://kaeso.app/articles/kaeso-demo/overview-light.png "Northwind Labs 的概览，这是演示中的示例组织。")

## 值得一看的地方

几个页面就能展示 Kaeso 的大部分功能。

**概览。** 整个组织的请求、Token、费用和错误，各自与上一时段比较，下面是按天的图表。可以在顶部更改时间范围，或在侧边栏打开一个项目，查看它自己的数字。

**请求日志。** 在项目中，每个请求占一行，显示模型、服务商、状态、Token 和费用。打开一行，就能看到发送了什么、返回了什么、用了多长时间，以及由哪个密钥发送。失败的请求也在其中，例如服务商错误或速率限制，每个都注明了原因。

**模型。** **目录**列出项目可以调用的模型，价格和上下文窗口来自 [KPMR](https://kpmr.kaeso.app)，即 Kaeso Provider & Model Registry。**别名**是应用代替模型发送的名称，由 Kaeso 决定由哪个模型来回答。

**限额。** Checkout assistant 设有每月 1,500 美元的硬性支出预算和每分钟 600 个请求的速率限制，它的服务账号 `checkout-worker` 还有一个每天的软性 Token 预算。每个限额都显示已用多少、何时重置。

**成员**和**审计日志。** 每个项目中谁可以做什么，以及什么时候、由谁改了什么。

### 一个别名，逐步来看

Checkout assistant 中的别名 `support` 展示了 Kaeso 中的路由是怎样读的。在项目中依次打开**模型**、**别名**和 `support`。应用只发送 `"model": "support"`，其余的交给路由：

- 带有请求头 `x-plan: enterprise` 的请求，或输入至少 100,000 个 Token 的请求，会发给 Claude Sonnet 5.5。如果 Anthropic 不可用、请求遇到速率限制，或模型无法处理请求中的某些内容，就改由 GPT-6 Sol 回答。
- 其他请求按调用方分流。每个调用方（通常是一个 API 密钥）固定在一个分支上：大约五分之四使用 Claude Haiku 5.5，以 GPT-5.4 mini 作为回退，其余的直接使用 GPT-5.4 mini。

另外三个别名展示了更简单的形式：`fast` 只指定一个模型，`sturdy` 是一串回退，`per-user` 按请求头 `x-user-id` 分流。

![编辑器中别名 support 的路由：一个基于 x-plan 的条件把企业请求发给 Claude Sonnet 5.5，以 GPT-6 Sol 作为回退；按调用方分流把其余请求发给 Claude Haiku 5.5 或 GPT-5.4 mini](https://kaeso.app/articles/kaeso-demo/alias-route-light.png "别名 support，从上往下读：一个条件、一次按调用方分流和几个回退。")

## 演示的行为方式

演示就是您自己会运行的那个控制台，只有一处不同：里面什么都改不了。

- **每次更改都会被拒绝。** 创建项目、添加服务商密钥、邀请他人或编辑路由，最后都会得到同一条消息：“此演示为只读；安装 Kaeso 后即可更改。”对话框和表单会像在您自己的实例中一样打开，每一步都看得到；只有保存时才会停下。
- **从不调用任何模型。** 演示的模型 API 和 MCP 服务器都已关闭。试验场对每个提示都回复只读消息，不会有任何内容发往 Anthropic 或 OpenAI。
- **每个人都是 Ada。** 所有访客都以同一个示例用户登录，任何人的操作都不会被保存。
- **每晚重新开始。** 演示会恢复到示例数据，并把所有日期往后移，所以用量的最后一天总是昨天。
- **运行最新版本。** 同一个夜间任务会把演示更新到 Kaeso 的最新版本，包括预发布版本，但会先检查该版本经过签名的构建来源证明，只安装 Kaeso 自己的发布工作流构建的内容。撰写本文时，这个版本是 0.6.0-rc.4。

会更改内容的请求在到达网关之前就会被拦下，而且网关本身也会拒绝它们。每位访客的请求还有速率限制，所以一个人无法拖慢所有人的演示。

![演示中的创建项目：对话框已填好，底部的消息写着“This demo is read-only; install Kaeso to change it.”](https://kaeso.app/articles/kaeso-demo/read-only-light.png "表单的用法和您自己的实例中一样，演示到保存这一步为止。")

## 演示展示不了什么

只读的控制台无法展示一切：

- **您自己的请求。** 想看到一个请求发出后片刻出现在请求日志里，需要您自己的实例。[Kaeso 的 README](https://github.com/logicplanes/kaeso) 顶部的录屏从头到尾展示了这个过程。
- **登录。** 邮件登录链接、密码、双重验证和单点登录（SSO）都被跳过，演示会直接为您登录。
- **速度。** 演示在一台共享服务器上以有限的资源运行，因此无法说明 Kaeso 的开销。请在您自己的实例中，通过网关的指标来测量。

## 运行您自己的演示

演示模式是一项设置，不是单独的构建，所以您可以把自己的一个实例变成演示。先在其中填入一个组织、若干项目和用量，再指定其中一个用户作为演示用户：

```bash
echo "KAESO_AUTH_DEMO_USER=owner@example.com" >> .env
docker compose up -d --wait
```

之后登录页会提供**浏览演示**，让每位访客都以这个用户的身份登录。Kaeso 会拒绝所有更改，并提示该实例是只读演示；它还会关闭模型 API 和 MCP，所以无法通过它发送任何内容。删除这项设置，实例就能恢复正常使用。

请为演示单独准备一个只含示例数据的实例。每位访客都能看到演示用户能看到的一切，包括请求日志及其内容。

在接入真实的服务商密钥之前想让同事先看看，或者想向别人展示 Kaeso 又不想为其创建账户时，自己的演示会很有用。演示模式是 Kaeso 0.6.0 的新功能，预发布版本从 0.6.0-rc.4 起就已包含。

## 试试看

[demo.kaeso.app](https://demo.kaeso.app) 现已开放。想看到自己的请求时，就在您的服务器上[安装 Kaeso](https://docs.kaeso.app/zh-CN/self-hosting/installation)。如果您从 LiteLLM 迁移过来，[迁移指南](https://kaeso.app/zh-CN/articles/migrate-from-litellm)会带您完成整个过程。如果您觉得演示中缺了什么或有不清楚的地方，[请告诉我们](https://kaeso.app/zh-CN/contact)。