KoalaQA

KoalaQA 是一个开源的智能问答系统，面向企业内外部用户支持场景，可用于搭建客服平台、开发者社区、用户帮助中心等。它基于大语言模型（LLM）提供 AI 问答、知识库自动优化、问题洞察与社区运营 能力，目标是减少重复性人工服务，推动实现 ZCR（Zero Contact Resolution，零人工介入解决）。

所有 AI 功能依赖用户自定义的模型 API（如 OpenAI、通义千问、百智云等），不绑定特定厂商，数据完全保留在本地或私有服务器。

核心功能

🤖 AI 智能问答

• 基于 RAG（检索增强生成）架构，从知识库中检索相关内容后生成回答
• 自动处理常见问题（如产品使用、报错排查、政策查询）
• 支持复杂问题识别并提示转接人工（需集成工单系统，未来扩展）

🧠 知识库自动进化

• 自动生成问答对：从历史问答或文档中提取潜在 Q&A
• 回答优化：根据用户反馈或新内容自动更新答案
• 知识缺口检测：识别高频未回答问题，提示管理员补充内容

🏢 多板块与权限管理

• 支持创建多个独立板块（如“技术社区”“客户支持”“内部 FAQ”）
• 可配置板块的访问权限（公开 / 登录可见 / 特定用户组）

🔐 多种认证方式

• 内置支持：
  • 微信扫码登录
  • 企业微信扫码登录
  • OIDC（兼容 Auth0、Keycloak、飞书等）
• 便于集成到现有企业身份体系

📱 移动端适配

• 响应式 Web 界面，支持手机浏览器访问
• 问答、搜索、回复等核心功能在移动端完整可用

部署与配置

系统要求

• 操作系统：Linux（推荐 Ubuntu 20.04+）
• 容器运行时：Docker 20.x 或更高版本
• 架构：x86_64

一键安装

以 root 用户执行：

bash -c "$(curl -fsSL https://release.baizhi.cloud/koala-qa/manager.sh)"

安装过程约 3–5 分钟，自动拉取镜像、初始化数据库并启动服务。

首次访问

安装完成后，终端输出管理凭据，例如：

SUCCESS  访问地址: https://192.168.1.100
SUCCESS  邮箱: admin@email.com
SUCCESS  密码: auto-generated-random-string

通过浏览器访问该地址，使用邮箱和密码登录管理后台。

配置 AI 模型

• 首次登录需配置 LLM（如 gpt-4o、qwen-max、deepseek-coder）
• 支持主流模型供应商（OpenAI、Azure、通义、DeepSeek、百智云等）
• 推荐：使用 百智云模型广场 快速接入（注册即赠 5 元额度）

导入知识库

• 通过后台上传文档（Markdown、PDF、网页等）
• 系统自动解析内容，构建向量索引
• AI 问答将基于此知识库生成边界受限、可追溯的回答

典型应用场景