@ssv-lab概念
前端 SSV-AI-SDK（v2.0）通过抽象业务形态，统一处理交互状态、流式数据解析、时序消息渲染和 Agent 工具调用。核心目标是帮助业务快速搭建 AI 能力，并支持 React / Vue3 / Vue2 / 微信小程序等多端场景。
两条主线
| 能力 | 适用场景 | 核心输出 | 主方法 |
|---|---|---|---|
| Stream | 单次流式生成，如摘要、翻译、结构化生成 | parts: Part[] | generate(params) |
| Agent | 多轮 Agent 对话、工具调用、状态管理 | messages[].parts | send(params, options) |
快速安装
通过 npm 进行安装：
注意该 npm 包为 Coding Npm 的私有源，请先确定已经正确配置了 Coding Npm
bash
npm install @tencent/ssv-ai-sdk-react --save
bash
npm install @tencent/ssv-ai-sdk-vue --save
bash
npm install @tencent/ssv-ai-sdk-vue2 --save
bash
npm install @tencent/ssv-ai-sdk-miniprogram --save
框架接入案例
Stream
| 框架 | 接入方式 | 示例 |
|---|---|---|
| React | useStream | React 示例 |
| Vue 3 | useStream | Vue 3 示例 |
| Vue 2 | StreamMixin | Vue 2 示例 |
| 小程序 | 当前未导出 StreamBehavior | 说明 |
Agent
| 框架 | 接入方式 | 示例 |
|---|---|---|
| React | useAgent | React 示例 |
| Vue 3 | useAgent | Vue 3 示例 |
| Vue 2 | AgentMixin | Vue 2 示例 |
| 小程序 | AgentBehavior | 小程序示例 |
如何选择
| 我的场景 | 推荐 |
|---|---|
| 单次生成，不需要历史消息 | Stream |
| 多轮对话，需要上下文历史 | Agent |
| 需要前端工具，如定位、主题切换、动画 | Agent |
| 接入 AG-UI 协议 | Agent |
| 需要 AgentState 状态快照 / 增量 | Agent |