Persona：为网站嵌入流式 AI 聊天与页面工具

什么是 Persona？

Persona 是面向开发者的 JavaScript UI 库，可将 AI 助手添加到网站或 Web 应用中。它能展示流式对话，并通过 WebMCP 提供页面上已注册的工具。可安装的软件包支持连接兼容 SSE 的智能体后端，包括由你自行运营的后端。

你可以从 npm 软件包或 script 标签安装程序开始，选择组件的目标容器并连接聊天端点。配置浮动启动器、停靠式副驾驶或全屏助手，然后根据应用调整主题和页面工具。Runtype 提供可选的托管后端集成；该库也说明了单独使用自有后端的路径。

Persona 能做什么？

使用浮动面板快速添加助手，将组件停靠在工作区旁，或为其提供全屏容器。更改启动器配置即可选择展示方式。

通过 SSE 接收响应，并使用 customFetch 和 parseSSEEvent 自定义请求或事件解析。智能体后端可独立于 UI 进行选择。

通过 WebMCP 提供产品搜索、预订或表单操作等功能。Persona 会发现已注册的工具，在调用前请求用户批准，并将结果返回到对话中。

使用调色板、语义和组件主题令牌、深色模式及实时主题编辑器，让组件匹配你的网站。Shadow DOM 渲染和带前缀的 CSS 可将组件样式与宿主样式分离。

使用场景

添加连接到支持或文档智能体的浮动助手，无需围绕完整聊天应用重新设计页面。

使用停靠模式，让副驾驶位于仪表板或工作区域旁，同时保留原有界面。

让助手使用应用提供的搜索、购物车、预订或表单工具，并由聊天 UI 处理批准交互。

常见问题

Persona 可免费用于商业用途吗？

该库采用 MIT 许可证发布，允许使用、修改、分发和销售副本，且无需支付许可费用。副本或实质性部分中必须保留版权和许可声明。该软件按现状提供，不附带任何担保。

是否必须使用 Runtype 后端？

你可以使用 Persona 的协议和适配器连接兼容 SSE 的后端。Runtype 是可选的托管路径；文档也提供了自托管示例。模型访问和托管是部署中的不同部分。

是否需要特定的前端框架？

Persona 使用原生 JavaScript 渲染，不依赖任何框架。你可以在打包应用中安装 npm 软件包，也可以在页面上使用 script 标签选项。

如何让助手操作我的页面？

将相关页面操作注册为 WebMCP 工具。Persona 会发现这些工具，并在工具调用前请求用户批准；实际操作由你的页面代码提供。

Persona