企业官网建设流程全解析

Fay数字人Agent框架实战指南：5个问题连上业务系统

【免费下载链接】Fayfay是一个帮助数字人（2.5d、3d、移动、pc、网页）或大语言模型（openai兼容、deepseek）连通业务系统的agent框架。项目地址: https://gitcode.com/GitHub_Trending/fay/Fay

直播到晚上九点，观众在弹幕里问"第二件还有货吗"，屏幕里的数字人卡住了——它听得见，却查不了。问题不在脸，在缺了一双手：Fay正是让数字人连通业务系统的agent框架，把这只手接上。

数字人的"五官"是五套零件焊在一起的

屏幕里的数字人看着像一个人，工程上其实是五套独立零件的总和。

耳朵是 funASR 语音识别，可以加热词，让商品名、品牌名不认错。大脑是任何 OpenAI 兼容接口的大模型，DeepSeek、Moonshot，或者 vllm 部署的本地模型都行。嘴巴是 TTS，Azure、阿里云的情感音色都能接。手是工具调用——Python 执行器、网页检索、PDF 知识库查询、查库存、开关设备。脸是你看到的画面：Live2D、UE5 的 3D 形象，或者网页、移动端页面。

Fay 只干一件事：当调度台

数字人像个刚入职的助理，Fay 是给他发工牌、指工位、再接上公司内网的那套系统。不管脸用哪套、模型用哪个，主循环都是这一条：

# Fay 主循环（简化示意）：一条弹幕或一句语音的完整旅程 text = asr.listen() # 耳：funASR 加热词，拿到文本 reply = llm.chat(history, text) # 脑：判断直接回答还是调用工具 if reply.has_tool: reply = run_tool(reply.tool) # 手：查业务系统、控设备 tts.speak(reply) # 嘴：TTS 发声，驱动数字人口型

框架的价值在于把"自己接一切"变成"换零件"——换模型、换脸、接新的业务系统，这条管线不动。

三个版本，先选对再动手

Fay 按场景分了三个版本，各有各的强项，入口都在 README.md 开头：

• 带货版赢在直播间实战：B 站弹幕监听、微信视频号监听、弹幕格式过滤、本地违禁词配置、情绪分析，"边卖边接弹幕"这套都预接好了。
• 助理版赢在居家办公：语音问答、开关设备、知识库问答，也支持 vllm、fastchat 起本地模型。
• agent 版赢在自主行动：能管日程、主动发微信消息、调工具，自己决定下一步干什么。

模型层同理：云模型直接接 OpenAI 兼容接口或 DeepSeek；数据不能出内网，就本地部署，接口照旧保持 OpenAI 兼容，Fay 侧配置几乎不动——代价是显存和部署你自己管，这是数据留在门里该付的钱。

拿到数字人需求，用 5 个问题定版

1. 它要在哪"接活"？→ 只做聊天问答，助理版够用；要实时接弹幕、过滤违规词，带货版。
2. 要不要它自己拿主意？→ 需要主动日程、主动发微信消息、调工具，agent 版。
3. 数据能不能出内网？→ 能，直连 OpenAI 兼容的云 API；不能，vllm、fastchat 本地部署，接口仍走 OpenAI 兼容。
4. 脸用哪套？→ Live2D、网页、移动端，前端直接带；UE5 的 3D，接 metahuman-stream 把音视频送进引擎。
5. 要不要带情绪说话？→ 接 Azure 或阿里云情感 TTS，配百度情绪分析；密钥留空就把对应模块关掉。

变更日志里的 3 个真实坑

TTS 吞开头。现象：回复前几个字没读出来，只剩半句。根因：音频流连接时序不对，第一帧被丢掉。一行修复：音频流第一帧别丢（用已修复的版本）。

空密钥报错。现象：百度情绪分析或 GPT 代理密钥留空，直接抛错。根因：没做空值校验，空字符串照样拼进请求。一行修复：密钥默认留空，"为空就跳过对应模块"。

首聊报错。现象：历史记录为空时，第一句提问就报错。根因：历史读取逻辑默认一定有数据。一行修复：首聊前预填一条 system 消息。

clone 下来做 3 件小事验证

1. git clone https://gitcode.com/GitHub_Trending/fay/Fay，切到助理版分支，把 LLM 换成你的 OpenAI 兼容端点启动——预期结果：开口说话，它听得到、答得上、TTS 念得出。
2. 把百度情绪分析密钥留空再发一句提问——预期结果：不再报空密钥错，正常回复。
3. 切到 agent 版接上网页检索工具，问一个需要外部信息的问题——预期结果：它调工具作答而不是自己编，fay.db 里的记录能区分出是 agent 还是 llm 回的。

数字人听得见弹幕，也查得到库存——晚上九点那档直播，下一个问题再也不会把它问卡。

【免费下载链接】Fayfay是一个帮助数字人（2.5d、3d、移动、pc、网页）或大语言模型（openai兼容、deepseek）连通业务系统的agent框架。项目地址: https://gitcode.com/GitHub_Trending/fay/Fay