4a29860b51
- Bridge server with LLM agent tool-use (search_kb, search_products, search_orders, search_inventory, escalate_human) - pgvector RAG knowledge base (95 FAQ chunks) - Auto opportunity creation in Twenty CRM - Auto follow-up task workflow - Chatwoot AgentBot integration (HMAC, webhook) - Docker compose infrastructure (PG18, Redis 8.8, node24-alpine) - Configuration templates (example files) - real secrets excluded via .gitignore
55 lines
3.4 KiB
Markdown
55 lines
3.4 KiB
Markdown
# Yehwang 客服知识库 (Customer Service Knowledge Base)
|
||
|
||
面向 **Chatwoot + ai-bridge + Twenty** AI 客服系统的知识库。内容为英文（客户群体为欧洲 B2B 零售商/店主，官方 FAQ 原文亦为英文），AI 在回复时按客户语言翻译即可。
|
||
|
||
## 内容来源（均为权威来源，非编造）
|
||
|
||
每个 md 文件都在 frontmatter 的 `source_url` 字段、以及正文标题下的「📎 来源 / Source」行里标注了**确切来源地址**，可点击核对/更新。汇总：
|
||
|
||
| 来源地址 | 对应文件 |
|
||
|---|---|
|
||
| https://www.yehwang.com/about-us.html | 00-about |
|
||
| https://www.yehwang.com/register.html | 00-about, 01-registration |
|
||
| https://www.yehwang.com/order.html | 02-ordering, 09-membership |
|
||
| https://www.yehwang.com/pre-order.html | 03-pre-order |
|
||
| https://www.yehwang.com/payment.html | 04-payment |
|
||
| https://www.yehwang.com/shipment.html | 05-shipping |
|
||
| https://www.yehwang.com/returns.html | 06-returns |
|
||
| https://www.yehwang.com/factory-direct.html | 07-factory-direct |
|
||
| https://www.yehwang.com/other-questions-1987986538 | 01-registration, 10-products |
|
||
| https://www.yehwang.com/membership-307802756 | 09-membership |
|
||
| https://dropshipping.yehwang.com/ · /about-us · /faq/{register,order,payment,shipment,returns} | 08-dropshipping |
|
||
| 数仓表 `wa_dim.dim_product_full` / `wa_dim.dim_user_full`（快照 2026-06-25） | 00-about, 09-membership, 10-products |
|
||
| 内部文档 `公司介绍.md.txt`（业务背景） | 00-about |
|
||
|
||
> 官网 FAQ 答案为 JS 折叠加载，用 Playwright 渲染后抓取；原始抓取数据存档于 `_source/`。
|
||
|
||
## 文件结构（一主题一文件，问答块切分，适配 RAG）
|
||
|
||
- `index.md` — 导航
|
||
- `00-about-yehwang.md` — 公司是谁、卖什么、两种履约模式
|
||
- `01-registration-account.md` — 注册 / 账号 / 找店 / 图片授权
|
||
- `02-ordering.md` — 下单 / 起订 €30 / 数量折扣 / 改单取消 / 优惠码
|
||
- `03-pre-order.md` — 预购规则
|
||
- `04-payment-vat-invoice.md` — 支付方式 / VAT / 发票
|
||
- `05-shipping-delivery.md` — PostNL/DHL 物流 / 运费 / 时效 / Brexit
|
||
- `06-returns-refunds.md` — 退换货 / 缺件 / 残次 / 定制品
|
||
- `07-factory-direct.md` — 工厂直发（中国直发全球）
|
||
- `08-dropshipping.md` — 一件代发（Shopify 接入）
|
||
- `09-membership-rewards.md` — 会员等级 / 阶梯量折扣 / 奖励
|
||
- `10-products-and-jewelry-care.md` — 品类盘 / 价格带 / 材质 / 珠宝护理
|
||
|
||
## 给 ai-bridge 的接入建议
|
||
|
||
1. **切块**：每个 `### Q:` 问答块作为一个 chunk（已天然分段）。frontmatter 里的 `keywords` 可并入 embedding 文本提升召回。
|
||
2. **向量化**：数仓 `.env.local` 已含 `DASHSCOPE_API_KEY`（`text-embedding-v3`，多语言），可直接复用，对欧洲多语种问法召回友好。
|
||
3. **system prompt 约束**：要求 AI 仅依据知识库作答；涉及金额/时效/政策时引用具体条款；无法回答时转人工（`helpdesk@yehwang.com` / `service@yehwang.com`）。
|
||
4. **联系方式**：自营/网站业务 `helpdesk@yehwang.com`、电话 `+31 318 668 171`；工厂直发 `service@yehwang.com`。
|
||
|
||
## 维护
|
||
|
||
- 政策类内容随官网 FAQ 变化需同步；商品/等级类数据可定期从数仓刷新（脚本见 `scratchpad` 或重跑聚合）。
|
||
- 标 `⚠️ 待核对` 的条目为需业务确认后补全的细节（如各国运费表、各国 VAT 税率表）。
|
||
|
||
_最后更新：2026-06-25_
|