基础设施,不是聊天机器人。
每项能力有独立页面。从客户端与 runtime 开始 — 其余都挂在这一对上。
Sveda 各层面:JS 客户端、Rust runtime、stream 协议、MCP 与 tools、模型目录、embed token、host SDK。
CLIENT
JS 客户端
安装 @sveda-ai/core。SvedaClient 管理 endpoint、header 与 tool。session.send 发送一个回合。流式在 wire 上。
RUNTIME
Rust runtime
sveda-server 默认绑定 0.0.0.0:8787。拥有循环、目录、tools 与 MCP。路由、认证与部署仍由你负责。
STREAM
Stream 协议
token、tools、MCP 与错误共用一条 SSE 管道。客户端请求 application/vnd.sveda.stream+json。runtime 以 text/event-stream 响应。
TOOLS
MCP 与 tools
Backend tools 在 sveda-server 内运行。Frontend tools 在浏览器。Host MCP 是 mint embed token 时传入的 HTTP 服务。
CATALOG
模型
添加 ChatGPT 或 Claude 密钥,或任意 Responses/Anthropic API。DeepSeek 为 builtin wrapper。故障转移遍历列表。stream 不会重启。
EMBED
Embed token
为每位访客 mint 限定范围的 embed token。浏览器从不持有 host 密钥。
HOST
Host SDK
浏览器看不到 SVEDA_EMBED_HOST_API_KEY。后端调用 POST /sveda/embed/token,页面打开 JS 聊天或 iframe。
从真正重要的那一对开始。
安装 @sveda-ai/core。在 :8787 运行 sveda-server。Mint embed token,用 session.send 发送第一轮。