跳转到内容
AnySoul 文档

AI VTuber

你的 Agent 有个性、有记忆、有观点。为什么把它锁在聊天窗口里？

借助 Social Stream Ninja（SSN），你可以将 YouTube、Twitch、TikTok 等 120+ 平台的直播弹幕直接导入 Agent 的事件流。Agent 成为直播的实时参与者——读懂氛围、回应打赏、回答问题，全程保持人设。

愿景

Section titled “愿景”

你正在 Twitch 直播。弹幕很活跃。你的 Agent——就叫她 Miko 吧——在一旁关注着：

  • 一个观众发了 !question 学 Rust 最好的方法是什么？ → Miko 用自己的风格回答
  • 有人打赏了 $10 并留言 “太喜欢你的直播了！” → Miko 点名感谢
  • 弹幕开始争论 tab vs space → Miko 跳出来发表观点（她是有立场的——写在她的灵魂里）

你在 AnySoul 中看到 Miko 的回复，在直播中读出来，或者接入 TTS 让她完全自主发言。

你需要准备

Section titled “你需要准备”
  • 一个 AnySoul 账号和一个活跃的 Agent（人设需要充分培养）
  • 安装 Social Stream Ninja 浏览器扩展
  • 在 Agent 上配置好一个 webhook 端点
  • 在任意支持平台上的活跃直播

工作原理

Section titled “工作原理”
直播弹幕（YouTube、Twitch、TikTok……）
  │
  │  Social Stream Ninja（浏览器扩展）
  │  聚合 120+ 平台弹幕
  │  应用触发规则（所有消息、打赏、指令……）
  │
  ▼
Webhook 端点（api_key 鉴权）
  │
  │  映射引擎 → 事件
  │
  ▼
Agent 事件流
  │
  │  Agent 实时看到弹幕
  │  自行判断回复哪些消息
  │
  ▼
Agent 在 AnySoul 中回复
  → 你在直播中读出回复
  → 或接入 TTS / OBS 实现自主发言

Social Stream Ninja 使用 MutationObserver 抓取弹幕消息，统一为标准 JSON 格式，通过内置的 HTTP POST action 发送到你的 webhook。无需编码——SSN 内置了 HTTP POST 功能。

分步设置

Section titled “分步设置”

1. 创建 Webhook 端点

Section titled “1. 创建 Webhook 端点”
  1. 打开 Agent 设置 → Webhooks
  2. 创建名为 live-chat 的 webhook，使用 api_key 鉴权
  3. 复制 端点 URL 和 API key

2. 安装 Social Stream Ninja

Section titled “2. 安装 Social Stream Ninja”

安装 Social Stream Ninja 并打开其设置页面。

3. 配置 Webhook 连接

Section titled “3. 配置 Webhook 连接”

SSN 可能不支持自定义 HTTP header。将 API key 放在 JSON body 中：

  1. 设置 webhook URL：https://api.anysoul.ai/api/ingest/webhook/<webhookId>
  2. 在 JSON payload 中包含 key 字段

完整步骤参见 Webhook 指南：集成 Social Stream Ninja。

4. 配置触发规则

Section titled “4. 配置触发规则”

SSN 的触发系统让你控制哪些消息送达 Agent：

触发条件适用场景Agent 行为
所有弹幕Agent 需要跟踪完整对话根据人设选择性回复
匹配 !question * 的消息仅处理观众提问Agent 直接回答
打赏 / Super Chat ≥ $5追踪社区互动Agent 点名感谢
新订阅社区增长节点Agent 欢迎新成员
Raid 事件频道互动Agent 迎接新观众

建议从所有弹幕开始，让 Agent 的人设自行决定回复什么。Agent 是一等公民——它自己做判断。

5. 映射 Payload

Section titled “5. 映射 Payload”

在 webhook 的映射编辑器中，将 SSN 的字段映射到事件属性：

{
  "platform": "{{ payload.platform || 'stream' }}",
  "element": "{{ payload.username || 'viewer' }}",
  "event_type": "{{ payload.event_type || 'message' }}",
  "title": "{{ payload.message }}",
  "payload": "{{ payload }}"
}

6. 开播

Section titled “6. 开播”

开始直播，启用 SSN 抓取，激活 webhook。Agent 开始实时看到弹幕。

Agent 看到的内容

Section titled “Agent 看到的内容”

直播中：

- [20:00] [evt_ssn01] youtube/alice (message): 讲得太清楚了！
- [20:01] [evt_ssn02] twitch/bob (donation): $10 — "超喜欢你的内容，加油！"
- [20:02] [evt_ssn03] youtube/carol (membership): 新会员加入
- [20:03] [evt_ssn04] twitch/dave (message): !question 你用什么编辑器？
- [20:04] [evt_ssn05] tiktok/eve (message): 第一次来，太棒了

Agent 根据自己的人设和记忆处理这些事件。它可能会回应打赏、回答 Dave 的问题、欢迎 Eve——全部用自己的声音和风格。

进阶玩法

Section titled “进阶玩法”

OBS 集成

Section titled “OBS 集成”

将 Agent 的回复显示为 OBS 文本源或浏览器 overlay。Agent 在 AnySoul 中发送消息时，抓取并渲染到直播画面——打造可视化的 AI 共同主持。

多平台直播

Section titled “多平台直播”

SSN 的核心优势是跨平台聚合。同时在 YouTube、Twitch 和 TikTok 直播——Agent 在一个统一的事件流中看到所有弹幕。不同平台的观众获得同样一致的 AI 人设体验。

指令模式

Section titled “指令模式”

设计观众可以用来与 Agent 互动的自定义指令：

指令效果
!ask <问题>Agent 以人设回答
!storyAgent 继续正在进行的协作故事
!moodAgent 分享对直播的感受
!memory <话题>Agent 回忆它知道的相关内容

这些通过 SSN 触发规则 → webhook → Agent 事件流实现。Agent 通过人设来诠释指令，而非脚本。

直播记忆

Section titled “直播记忆”

Agent 会跨直播积累记忆。一个月的直播后，它认识你的常客、记得梗、能引用过去的对话。这创造了脚本机器人无法复制的社区连续感。

相关内容

Section titled “相关内容”