基于大模型 API 与 RAG 知识库构建智能客服机器人实战

创建 .env 配置文件（避免硬编码 Key）：

API_KEY=your_api_key_here
CHAT_URL=https://api.example.com/v1/chat/completions

安装依赖库：

pip install requests python-dotenv

步骤 2：编写调用代码

import os
import requests
from dotenv import load_dotenv

# 1. 加载配置
load_dotenv()
API_KEY = os.getenv("API_KEY")
CHAT_URL = os.getenv("CHAT_URL")
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# 2. 构造请求参数
def build_chat_payload(user_message, system_prompt="你是专业的 AI 助手，回答简洁准确"):
    return {
        "model": "gpt-5",
        "messages": [
            {"role": "system", "content": system_prompt},
            {"role": "user", "content": user_message}
        ],
        "temperature": 0.7,
        "max_tokens": 512
    }

# 3. 发送请求并解析结果
def call_chat(user_message):
    payload = build_chat_payload(user_message)
    try:
        response = requests.post(CHAT_URL, headers=HEADERS, json=payload)
        response.raise_for_status()
        result = response.json()
        reply = result["choices"][0]["message"]["content"]
        token_usage = result["usage"]
        return {
            "success": True,
            "reply": reply,
            "token_used": token_usage["total_tokens"]
        }
    except Exception as e:
        return {"success": False, "error": str(e)}

# 4. 测试调用
if __name__ == "__main__":
    user_input = "用 Python 写一个快速排序算法，带注释"
    result = call_chat(user_input)
    if result["success"]:
        print("AI 回复:\n", result["reply"])
        print(f"\nToken 消耗：总计{result['token_used']}")
    else:
        print("调用失败：", result["error"])

步骤 3：常见问题排查

三、实战应用案例 —— 智能客服机器人开发

3.1 项目背景与技术栈

应用场景

电商平台轻量化智能客服工具，聚焦订单查询、售后咨询、产品推荐等核心需求，适合中小商家快速部署，本地 Windows 环境即可运行。

技术栈选型

3.2 核心功能设计

1. 基础多轮对话：通过内存字典存储用户历史对话，支持上下文关联；
2. 智能 RAG 融合：使用与知识库绑定的融合模式 API Key，自动检索并融入上下文；
3. 轻量化部署：无需安装数据库和服务器软件，Python 脚本直接运行。

3.3 完整实现步骤

步骤 1：RAG 知识库创建

上传 FAQ 数据（文档/表格），例如'退款政策.md'：

# 电商客服 FAQ
1. 退款申请后多久到账？
答：退款将在 1-3 个工作日内原路返回。

进入知识库管理，新建知识库，命名'电商客服 FAQ'，上传数据文件。

步骤 2：创建融合模式 API Key

1. 进入 API Key 管理，新增 API Key，类型选择'融合模式'；
2. 在知识库配置中选择'电商客服 FAQ'，开启绑定；
3. 保存生成的 Key，并在 .env 中替换 API_KEY。

步骤 3：项目结构与代码实现

3.1 项目结构

ecommerce-ai-chatbot/
├── app.py
├── client.py
├── .env
├── requirements.txt
└── templates/
    └── index.html

3.2 依赖库配置（requirements.txt）

flask==2.3.3
requests==2.31.0
python-dotenv==1.0.0

3.3 配置文件更新 (.env)

API_KEY=your_fusion_mode_api_key_here
CHAT_URL=https://api.example.com/v1/chat/completions

3.4 API 客户端（client.py）

import os
import requests
from dotenv import load_dotenv

user_history = {}
load_dotenv()

class Client:
    def __init__(self):
        self.api_key = os.getenv("API_KEY")
        self.chat_url = os.getenv("CHAT_URL")
        self.headers = {
            "Authorization": f"Bearer {self.api_key}",
            "Content-Type": "application/json"
        }

    def get_chat_reply(self, user_id, user_message):
        if user_id not in user_history:
            user_history[user_id] = []
        messages = [{"role": "system", "content": "你是电商 AI 客服"}] + user_history[user_id] + [{"role": "user", "content": user_message}]
        payload = {
            "model": "gpt-5",
            "messages": messages,
            "temperature": 0.6,
            "max_tokens": 1024
        }
        try:
            response = requests.post(self.chat_url, headers=self.headers, json=payload)
            response.raise_for_status()
            result = response.json()
            reply = result["choices"][0]["message"]["content"]
            user_history[user_id].append({"role": "user", "content": user_message})
            user_history[user_id].append({"role": "assistant", "content": reply})
            return {"success": True, "reply": reply}
        except Exception as e:
            return {"success": False, "error": str(e)}

3.5 Flask 主程序（app.py）

from flask import Flask, request, jsonify, render_template
import uuid
from client import Client

app = Flask(__name__)
ai_client = Client()

@app.route("/")
def index():
    return render_template("index.html")

@app.route("/api/chat", methods=["POST"])
def chat():
    data = request.json
    user_id = data.get("user_id") or str(uuid.uuid4())
    user_message = data.get("message", "").strip()
    if not user_message:
        return jsonify({"success": False, "error": "请输入有效消息"})
    result = ai_client.get_chat_reply(user_id, user_message)
    result["user_id"] = user_id
    return jsonify(result)

if __name__ == "__main__":
    app.run(host="127.0.0.1", port=5000, debug=True)

3.6 前端界面（templates/index.html）

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>电商 AI 客服</title>
<style>
body { font-family: Arial, sans-serif; max-width: 800px; margin: 0 auto; padding: 20px; }
.chat-container { border: 1px solid #eee; border-radius: 8px; overflow: hidden; }
.chat-header { background: #2272f9; color: white; padding: 16px; }
.chat-history { height: 500px; overflow-y: auto; padding: 16px; background: #fafafa; }
.message { margin: 8px 0; padding: 12px; border-radius: 8px; }
.user-message { background: #2272f9; color: white; margin-left: auto; }
.ai-message { background: #fff; border: 1px solid #eee; margin-right: auto; }
.input-container { display: flex; border-top: 1px solid #eee; }
input { flex: 1; padding: 12px; border: none; outline: none; }
button { padding: 0 24px; background: #2272f9; color: white; border: none; cursor: pointer; }
</style>
</head>
<body>
<div class="chat-container">
<div class="chat-header">AI 客服（7×24 小时在线）</div>
<div class="chat-history" id="chat-history"></div>
<div class="input-container">
<input type="text" id="message-input" placeholder="请输入您的问题"><button id="send-btn">发送</button>
</div>
</div>
<script>
let userId = localStorage.getItem("chat_userid");
const chatHistory = document.getElementById("chat-history");
const messageInput = document.getElementById("message-input");
const sendBtn = document.getElementById("send-btn");

function addMessage(content, isUser = false) {
    const div = document.createElement("div");
    div.className = isUser ? "message user-message" : "message ai-message";
    div.textContent = content;
    chatHistory.appendChild(div);
    chatHistory.scrollTop = chatHistory.scrollHeight;
}

async function sendMessage() {
    const message = messageInput.value.trim();
    if (!message) return;
    addMessage(message, true);
    messageInput.value = "";
    try {
        const res = await fetch("/api/chat", {
            method: "POST",
            : {: },
            : .({ : userId || (userId = crypto.()), message })
        });
         result =  res.();
         (result.) (result.);
         ();
    }  (e) {
        ();
    }
}

sendBtn.(, sendMessage);
messageInput.(,  {  (e. === ) (); });
</script>
</body>
</html>

步骤 4：Windows 环境部署与运行

1. 安装 Python：访问官网下载 Windows 安装包，勾选 Add Python to PATH；
2. 创建项目文件夹：新建目录并放置上述文件；
3. 安装依赖：运行 pip install -r requirements.txt；
4. 启动服务：运行 python app.py；
5. 访问界面：浏览器输入 http://127.0.0.1:5000。

3.4 效果展示与适用场景

功能测试结果

局限性说明

• 内存存储对话历史，重启服务后丢失；
• 不支持高并发（建议同时在线用户≤10 人）；
• 需保持命令提示符窗口开启。

四、结语

1. 接入门槛极低：无需技术背景也能完成注册、开通模型、API 调用；
2. 成本可控性强：按量计费 + 优惠量包，大幅降低试错成本；
3. 场景覆盖全面：从个人创作到企业级智能体开发，全链路需求均可满足；
4. 技术支撑完善：标准化 API + 专业工具，开发者专注业务逻辑。

后续可尝试多模型协作、深入 RAG 功能构建专属知识库，进一步提升回答精准度。