你的应用。
现在有了智能体。

把 AI 智能体放进你已经在交付的产品。聊天、tools、sidecar runtime — 免费、开源，路由仍是你的。

prompt Install Sveda into this project. Read https://sveda.dev/llms.txt first.

Install Sveda into this project.

Read:
- https://sveda.dev/llms.txt
- https://sveda.dev/docs/start
- https://sveda.dev/docs/hosts

Pick the matching host SDK from /docs/hosts. If unsure which backend or frontend this repo uses, ask the user.

Apache 2.0 · Laravel · Django · Rails · Next · Spring · 或静态页

Vue React Svelte Solid

1 · App.vue

<template>
  <SvedaChat />
</template>

2 · AppServiceProvider Laravel SDK

SvedaClient::host()
  ->resolveToolsUsing(fn () => [
    new FindAccountTool,
  ]);

你的 tool。代理可以调用它。

YOUR CRM · SALES

找到 Acme 账户。

FindAccountTool find_account → #10482

已打开 Acme Corp。Owner John D. Stage: Negotiation。发票 INV-8821 未付。

随便问…

工作方式

Self-host 或 Cloud。页面上的 widget。后端的 tools。这就是集成。

01

运行 Sveda

Self-host :8787

docker compose up

或

Cloud 即将推出
02

放到页面上

your.app

sveda-chat
03

声明一个 tool

BACKEND tool

+ FindAccount ok
+ GetInvoice ok

你的 API
04

完成

LIVE <sveda-chat>

FindAccount

GetInvoice

智能体已在产品里。

本页已上线

本站已经嵌入同一个智能体。它会搜索文档 — 打开并提问。

你已经在跑的技术栈。

在后端 mint session。在页面打开聊天。不是仅限 React 的 copilot，也不是新的 TypeScript 应用。

Vue、React、Svelte、Solid。

四个包，同一个聊天。引入 styles.css，传入 embed token，挂载 SvedaChat。

auth 留在 host。

页面上的 widget。后端 mint session。sidecar 上跑 agent loop。

PAGE

页面

浏览器里的 UI。

your.app

sveda-chat

仅 embed token — 无 host key
HOST

你的应用

auth、路由和 session mint 仍是你的。

YOUR APP auth

POST /sveda/session

你的 API 作为 tools
SIDECAR

Sidecar

在 host 旁边 — 不在 request cycle 里。

SVEDA-SERVER :8787

POST /sveda/stream

agent loop · MCP · catalog
MODELS

模型

密钥在 runtime。换供应商不必重写 UI。
BYOK
- ChatGPT responses
- Claude anthropic
failover 让 stream 继续。

Rust runtime →

sveda --tools

在产品中

线上的 tools。

内置搜索、host MCP 和 frontend tools 共用一条 stream。不需要第二个编排仓库。

host MCP

你的后端 API 变成智能体的 tools。

client tools

智能体在浏览器里点击、填写、导航。

search_code

在 workspace 索引里找文件。

read_code_file

打开找到的内容，然后回答。

spawn_tasks

一轮内并行工作。

search_agent_tools

按需发现更多 MCP tools。

本轮

你的 API mcp
你的 UI js
workspace 可选

不是又一个聊天机器人 SKU。

团队要的是产品内的智能体 — 不必替换应用，也不必另起 control plane。

聊天机器人 SaaS

活在产品旁边，而不是里面。你的 API 是事后才想到的。Auth 是别人的。

智能体框架

UI、stream、auth 和部署仍要自己拼。是原语，不是产品内智能体。

仅限 React 的 copilot

在 Next 上还行。在 Laravel、Rails 或 Spring 上别扭。其余技术栈不会消失。

自研胶水

Control plane、stream parser、tool loop、模型密钥。访客能发出一轮之前要花数周。

sveda --delta

SHIP

自己做

6-8 周

新的智能体仓库，然后 widget，然后 auth
手写 stream parser 和 tool loop
模型密钥和 failover 在第三个地方

Sveda

1 晚

应用旁的 Docker sidecar
Host SDK 签发 session
即插即用的聊天可以调用你的 tools

粘贴 prompt。仓库里出现智能体。

Sveda 免费开源 — Apache 2.0，self-hosted。也可以跳过安装，直接问本页上的智能体。它会搜索文档。

开始 GitHub

常见问题

Sveda 是什么？

Sveda 是嵌入现有产品的免费开源 AI 智能体。放入聊天 UI，把 API 接成 tools — 不必替换应用，也不必另起智能体平台。Apache 2.0，self-hosted。

需要替换我的应用吗？

不需要。sveda-server 跑在宿主旁边。路由、auth 和部署仍是你的。页面打开聊天；sidecar 负责智能体循环。

支持哪些技术栈？

Host SDK：PHP、Laravel、Python（Flask、Django、FastAPI）、Node（Express、Nest、Next）、Ruby、Go、Java 和 .NET。无框架：静态 HTML 加 POST /sveda/session。前端：Vue、React、Svelte、Solid、<sveda-chat> 或 headless JS 客户端。

智能体实际能做什么？

在你的 UI 里 stream 聊天，调用浏览器里的 frontend tools，经 MCP 调用后端。可选 workspace tools 搜索并阅读代码。模型和 failover 在 sidecar 上，不在 widget 里。

可以用哪些模型？

在 sidecar 上放 OpenAI（ChatGPT）或 Anthropic（Claude）密钥，或任意 Responses / Anthropic 兼容 URL。DeepSeek 是可选 wrapper。Failover 是有序列表 — 换供应商不必改 UI。

能用 Cursor 安装 Sveda 吗？

可以。从首页或 /docs 复制 agent prompt。每个 host SDK 页面都有对应技术栈的 prompt。把 https://sveda.dev/llms.txt 交给智能体。

这是托管聊天机器人吗？

开源 Sveda 是 self-hosted：你在应用旁运行 sveda-server。本营销站不是产品 runtime。可选的 Sveda Cloud 是独立托管单元格——隔离、同一 OSS 镜像、你的模型密钥——不是 runtime.sveda.dev 上的文档演示。见 /cloud。

什么是 Sveda Cloud？

按客户开通的托管 runtime。你仍用公开 host SDK，只是 Cloud 的 origin 与 host key。即将推出 — OSS 仍是 Apache 2.0、可自行托管。见 /cloud。