SuperAPI AI 工具集

velt-chat-sdk-adapter-best-practices

智能体与模型

查看项目

更新于 10-16 05:44

技能介绍

用途:本技能是构建接入 Velt 评论线程的机器人的实现指南,通过 Chat SDK Adapter(@veltdev/chat-sdk-adapter)把跨平台 Chat SDK 与 Velt 评论线程系统桥接起来,使同一个机器人可运行在 Velt、Slack、Discord 等兼容 Chat SDK 的平台上。

适用时机:构建响应 Velt 评论线程中 @ 提及的机器人;设置接收 Velt 评论/表情事件的 webhook 路由;配置 createVeltAdapter 的凭据与用户解析;处理表情回应(在托管版 Velt 上可读,写入需自托管);将 Velt 机器人部署到 Vercel、其他无服务器平台或 Node.js 服务器;构建把 LLM 回复流式写入 Velt 线程的 AI 智能体。

核心架构:适配器仅在服务端运行,位于 API 路由中,不涉及 VeltProvider 或 authProvider(这些是 Velt React SDK 的客户端模式)。适配器通过 VELT_API_KEY 认证,并自动生成按组织划分的认证令牌。流程为:用户在 Velt 评论线程中 @ 提及机器人;Velt 向你的 API 端点发送 webhook;适配器校验签名、解析事件并分发到你的处理器;处理器调用 thread.post() 回复(适配器经 Velt REST API 发布)。

依赖安装:npm install @veltdev/chat-sdk-adapter chat @chat-adapter/state-memory

规则分类按优先级:Core(CRITICAL,前缀 core-)、Webhook(CRITICAL,webhook-)、Events(HIGH,events-)、Users(HIGH,users-)、Reactions(MEDIUM,reactions-)、Deployment(MEDIUM,deployment-)。

文档:AGENTS.md 为全部规则的压缩索引(含文件路径,建议先读),AGENTS.full.md 为展开全部规则的完整指南。

限制:资料未提供具体代码示例、各规则细节、价格与平台支持范围等更多信息,暂未提供。