crapi/crapi-chatbot

聊天机器人服务后端镜像文档

概述

本Docker镜像提供了一个预配置的聊天机器人服务后端环境，旨在简化聊天机器人后端服务的部署流程。该镜像封装了聊天机器人核心的对话处理逻辑，包括用户输入解析、自然语言理解及对话状态管理等功能，适用于各类需要快速构建智能对话系统的场景。

核心功能和特性

• 用户输入处理：支持接收并解析文本、语音等多种格式的用户输入
• 自然语言理解（NLU）：内置意图识别与实体提取能力，准确理解用户需求
• 对话管理：动态维护对话上下文状态，支持多轮对话流程控制
• 模块化架构：核心功能组件解耦，支持自定义插件扩展（如知识库集成、第三方API对接）
• 轻量级部署：优化的镜像体积（<200MB），启动时间<30秒，资源占用低

使用场景

• 企业客服机器人：自动化处理客户咨询，降低人工客服成本
• 智能助手系统：个人或办公场景下的语音/文本交互助手（如日程管理、信息查询）
• 教育问答平台：学生作业辅导、知识点查询的自动化问答系统
• 内部知识库检索：企业内部文档、流程的智能检索与解答

使用方法

快速启动

通过以下命令快速启动基础服务（默认配置）：

bash
docker run -d -p 8080:8080 --name chatbot-backend [镜像名称]:latest

服务启动后，可通过 http://localhost:8080/health 检查服务状态（返回 {"status":"UP"} 表示正常运行）。

自定义配置

通过环境变量调整服务参数，支持以下核心配置项：

带自定义配置的启动示例

bash
docker run -d \
  -p 9000:9000 \
  -e PORT=9000 \
  -e LOG_LEVEL=DEBUG \
  -e NLU_PROVIDER=dialogflow \
  -e NLU_API_KEY="sk_abc123456" \
  -e DB_CONNECTION="mysql://chatbot:passwd@mysql-host:3306/chat_history" \
  --name chatbot-backend [镜像名称]:latest

Docker Compose集成

创建 docker-compose.yml 文件实现服务编排（含数据库依赖）：

yaml
version: '3.8'
services:
  chatbot:
    image: [镜像名称]:latest
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - LOG_LEVEL=INFO
      - DB_CONNECTION="postgresql://chatbot:postgres@db:5432/chatbot_db"
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: postgres:14-alpine
    environment:
      - POSTGRES_USER=chatbot
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=chatbot_db
    volumes:
      - chatbot-db-data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

volumes:
  chatbot-db-data:

通过 docker-compose up -d 启动完整服务栈。

API接口说明

服务启动后提供以下核心API端点（详细文档见 http://localhost:8080/swagger-ui.html）：

• POST /api/v1/chat：处理用户输入并返回对话响应（请求体需包含 user_id 和 input 字段）
• GET /api/v1/sessions/{user_id}：查询指定用户的对话历史
• DELETE /api/v1/sessions/{user_id}：清除指定用户的对话会话

请求示例（curl）：

bash
curl -X POST http://localhost:8080/api/v1/chat \
  -H "Content-Type: application/json" \
  -d '{"user_id":"user_001","input":"如何重置密码？"}'