必须完成模型能力接入、消息通道打通、业务知识注入三步闭环：开通文心一言API并配置千帆应用；在企业微信创建自建应用获取凭证；部署支持HTTPS的中转服务；配置回调URL并通过验证；上传结构化知识库文件并启用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让文心AI在企业微信里自动回答客户关于商品参数、促销规则、退换货政策等导购与客服问题，必须完成模型能力接入、消息通道打通、业务知识注入三步闭环，缺一不可。
开通文心一言API权限并获取密钥
登录百度智能云控制台→进入“千帆大模型平台”→点击左侧菜单“应用管理”→新建应用，名称填“企微导购客服”，选择“wenxinworkshop/chat/completions”接口权限。
创建成功后，在应用详情页复制【API Key】和【Secret Key】——这两个值后续用于签名验签，丢失需重新生成，无法找回。
进入“配额管理”，将QPS调至50以上，避免大促期间消息堆积超时。
在企业微信后台创建自建应用
登录企业微信管理后台→“应用管理”→“自建应用”→点击“创建应用”，填写名称“文心导购助手”、描述“基于文心一言的智能导购与客服应答系统”。
创建完成后，记录下页面显示的【CorpID】、【Secret】和【AgentID】——这三个字段将在中转服务中作为身份凭证使用，其中Secret仅显示一次，务必立即保存。
在“接收消息”设置中，开启“接收消息”并勾选“文本消息”，其余类型暂不启用，防止非文本消息触发异常解析。
部署消息中转服务（Python Flask示例）
方法一：本地快速验证（推荐开发阶段）
新建main.py文件，粘贴以下代码（需安装flask、requests、cryptography库）：
from flask import Flask, request, jsonify
import requests
import json
import time
import hmac
import hashlib
import base64
import os
app = Flask(__name__)
WENXIN_API_URL = "https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions"
API_KEY = os.getenv("API_KEY")
SECRET_KEY = os.getenv("SECRET_KEY")
@app.route("/wx", methods=["POST"])
def handle_wx_msg():
data = request.get_json()
content = data.get("Content", "").strip()
if not content:
return jsonify({"errcode": 0})
# 构造prompt，强制限定角色与知识边界
prompt = f"你是一名XX品牌官方导购兼客服，只依据知识库中2025年Q4起生效的《售后政策》《618大促规则》《尺码对照表》作答。用户问：{content}。请用简洁口语化中文回复，不编造、不推测，未知问题统一答'请稍候，已为您转接人工'。"
# 调用文心API
access_token = get_access_token()
resp = requests.post(
f"{WENXIN_API_URL}?access_token={access_token}",
json={"messages": [{"role": "user", "content": prompt}], "temperature": 0.3},
headers={"Content-Type": "application/json"}
)
result = resp.json().get("result", "暂时无法响应，请稍后再试")
return jsonify({"Text": result})
def get_access_token():
url = f"https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id={API_KEY}&client_secret={SECRET_KEY}"
return requests.get(url).json().get("access_token")
if __name__ == "__main__":
app.run(host="0.0.0.0", port=5000)
运行前，在终端执行export API_KEY="你的API Key"和export SECRET_KEY="你的Secret Key"，再启动服务。
方法二：生产环境部署（Nginx + Gunicorn）
将上述代码打包为Docker镜像，挂载SSL证书，通过Nginx反向代理到HTTPS域名（如https://ai.yourdomain.com/wx），确保企业微信回调URL必须为HTTPS且端口为443。
这一步操作起来很简单，直接把文件拖进去就行。但注意：企业微信要求回调URL必须能被公网访问，本地localhost或内网IP会校验失败。
配置企业微信消息回调地址
第一步：在企业微信管理后台“应用管理”→找到刚创建的“文心导购助手”→点击“接收消息”→填写“服务器配置”：
① 启用状态：开启
② URL：填你部署好的中转服务地址，例如 https://ai.yourdomain.com/wx
③ Token：任意6-32位英文或数字（如 wxai2026 ）
④ EncodingAESKey：点击“生成”，复制完整43位字符串
⑤ 消息加解密方式：选“明文模式”（调试期）→上线后必须切为“兼容模式”或“安全模式”
第二步：点击“保存”，系统会发起一次验证请求。若返回“配置成功”，说明中转服务已正确响应校验逻辑；若失败，检查Flask路由是否匹配、Token是否一致、服务器防火墙是否放行443端口。
第三步：在“功能介绍”中上传客服头像、设置欢迎语：“您好！我是AI导购小助手，可查订单、比价格、看尺码，随时问我～”
注入导购与客服专属知识库
登录千帆大模型平台→进入“知识库”模块→新建知识库，命名为“电商导购知识集”，类型选“结构化文档”。
上传三类文件：
• PDF格式《2025年Q4售后政策》（含退换货时效、运费规则）
• Excel表格《618大促满减梯度表》（列名必须含“门槛金额”“减免金额”“适用品类”）
• Markdown文档《热销款尺码对照指南》（每款含身高体重推荐区间、模特实测对比图链接）
上传后点击“开始解析”，等待状态变为“就绪”。这一步不能跳过——没有知识库支撑的文心AI只会泛泛而谈，无法精准回答“iPhone 15 Pro Max在618是否参与折上折”这类具体问题。
在调用API的prompt中加入知识库引用指令：“请严格依据知识库‘电商导购知识集’中的内容作答，禁止脱离该知识库自由发挥。”
