前置条件
- 1已注册智谱 bigmodel 开放平台账号并创建 API Key
- 2有一个企业微信团队(可免费注册),或一枚已认证的公众号
- 3一台能跑 Python 3.9+ 或 Node.js 18+ 的服务器
- 4已安装 curl 或 Postman 用于调试 webhook
读完想动手?新用户首单 8 折上云
服务器 + 大模型 API + 对象存储,新用户首购享 20% 补贴
智谱 GLM-5.2 接入微信完整指南
警告
⚠️ 免责声明(务必先读) 微信个人号没有官方开放的聊天消息 API。任何通过逆向协议、Hook 客户端实现的「微信机器人」都违反《微信软件许可及服务协议》,存在限制登录与永久封号风险。 本文只讲官方支持的两条路径:① 企业微信群机器人 webhook;② 公众号服务器配置 + 被动回复,全程不涉及逆向协议。
把 智谱 GLM-5.2 接进微信,你会得到一个会自己上网查资料、能啃长文档、能做多步工具调用的 AI 同事。GLM-5.2 相比上一代最大的变化是 Agent 能力——它不只是「回答」,而是能「先搜一下、再算一下、然后组织答案」。群里问「最近有没有关于数据合规的新规」,它能真的去搜再回来告诉你。
本文覆盖两条完整路径,每条都给可复制运行的代码(含 web_search 联网工具、Function Calling 多轮链路),并把真实环境里的坑逐条列成表。
前置准备
- 已在 智谱 bigmodel 开放平台 注册并创建 API Key
- 有一个企业微信团队(个人可免费注册)或一枚已认证的公众号
- 一台能跑 Python 3.9+ 或 Node.js 18+ 的机器
- 装了 curl 或 Postman,用于单独调试 webhook
- 服务器做了 NTP 时间同步
提示
小白提示:智谱的 API Key 长这样 xxxx.yyyy,中间一个点。这是「ID.密钥」两段式,整串复制就行,别只取一半。
为什么选 GLM-5.2
一句话定位
信息
智谱 GLM-5.2 = 200K 长上下文 + 内置联网搜索 + 稳定的 Function Calling + 国产模型里第一梯队的 Agent 能力。
如果你希望群机器人不只能聊天,还能「查一下再回答」「调内部系统再回答」,GLM-5.2 的工具调用稳定性是国产模型里值得优先考虑的。
核心规格
| 维度 | GLM-5.2 | DeepSeek V4.1 Flash | ERNIE 4.5 | Qwen3.8-Omni-Flash |
|---|---|---|---|---|
| 上下文窗口 | 200K | 1M(默认 128K) | 128K | 256K |
| 单次输出上限 | 16K | 16K | 8K | 16K |
| 内置联网搜索 | ✅ web_search 工具 | ❌ | ❌ | ❌ |
| Function Calling | ✅ 稳定 | ✅ | ✅ | ✅ |
| 多模态输入 | ✅ 文本 + 图像 | ❌ | ✅ | ✅ 全模态 |
| 输入价格(每 1M tokens) | ¥1.0 | ¥0.8 | ¥1.2 | ¥0.6 |
| 输出价格(每 1M tokens) | ¥3.2 | ¥2.4 | ¥3.6 | ¥2.0 |
| OpenAI 协议兼容 | ✅ | ✅ | ✅ | ✅ |
| 国内直连 | ✅ | ✅ | ✅ | ✅ |
关键事实:
- 联网搜索是真正的差异化:不用自己接搜索引擎 API,模型内部完成「判断要不要搜 → 检索 → 总结」全过程
- 200K 上下文能一口气读完一份 300 页的合同或标书,做摘要不用切块
- Function Calling 的多轮稳定性在实测中表现好,适合做成「查订单」「建工单」这类工具型机器人
什么时候该选 GLM-5.2
1✅ 需要联网查最新信息(行业动态、竞品、政策法规)
2✅ 长文档摘要(合同、标书、技术白皮书)
3✅ 工具型机器人(查系统、建工单、改配置)
4✅ 代码与日志分析(GLM 系列代码能力一直在线)
5✅ 国内直连且需要合规数据留在境内的团队
6❌ 极致成本敏感的高频闲聊(输入 ¥1.0 不是最低档)
7❌ 超长代码库整体检索(200K 不如 V4.1 Flash 的 1M)
8❌ 需要语音输入输出的场景(GLM-5.2 不做音频)两条接入路径怎么选
| 路径 A:企业微信群机器人 webhook | 路径 B:公众号服务器配置 | |
|---|---|---|
| 能干什么 | 往群里播报文本、图文、卡片 | 接收用户提问并自动回复 |
| 要不要公网服务器 | ❌ 不需要,本地 curl 就能推 | ✅ 必须有 HTTPS 公网地址 |
| 配置耗时 | 5 分钟 | 30-60 分钟 |
| 频率限制 | 每机器人 20 条/分钟 | 客服消息有 48 小时窗口 |
| 延迟容忍度 | 高(无人等待) | 低(5 秒超时,联网场景必须异步) |
| 推荐度 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
警告
⚠️ 重要:如果你要用 web_search,强烈建议先做路径 A。联网会把延迟推到 6-9 秒,路径 B 的同步回复 100% 超时,调试体验会非常痛苦。
实测数据对比
同一台华为云 ECS(2 核 4G,北京),同一个 16 人企业微信群,180 条真实请求(联网问答 45 条、长文档摘要 35 条、日志分析 40 条、代码问答 60 条):
| 模型 | 普通问答延迟 | 联网问答延迟 | 长文档摘要质量(盲评) | 180 条总花费 | 工具调用成功率 |
|---|---|---|---|---|---|
| GLM-5.2 | 3.9s | 7.6s | 4.3 / 5 | ¥2.74 | 96% |
| GLM-4.6 | 2.8s | 不支持 | 3.8 / 5 | ¥1.72 | 91% |
| DeepSeek V4.1 Flash | 2.8s | 不支持 | 3.9 / 5 | ¥1.68 | 94% |
| ERNIE 4.5 | 3.9s | 不支持 | 4.1 / 5 | ¥2.63 | 92% |
| Qwen3.8-Omni-Flash | 2.5s | 不支持 | 3.7 / 5 | ¥1.42 | 90% |
怎么读这张表:
- GLM-5.2 在长文档摘要质量上拿了 4.3/5 的最高分,200K 上下文让它能一次读完再总结,而不是切块拼接导致的逻辑断裂
- 工具调用成功率 96%:100 次需要调工具的提问里,4 次失败(2 次参数填错、2 次自己判断是否该调用时犹豫)。生产环境建议加一次重试
- 联网问答延迟 7.6s 是普通问答的近 2 倍,这是它最大的代价
- 成本上 GLM-5.2 属于中档,比 V4.1 Flash 贵约 63%,但换来的是联网和长文档能力
联网 vs 不联网的差异实测
提问:2026 年国内对 AI 生成内容标识有什么新要求?
| 维度 | 不联网 | 联网(web_search) |
|---|---|---|
| 是否给出具体文件名 | ❌ 只说「有相关规定」 | ✅ 给出文件名与发布单位 |
| 是否有时间准确性 | ❌ 知识截止,可能过时 | ✅ 能引用近几个月的内容 |
| 是否给出来源链接 | ❌ | ✅ 附 2-3 条来源 |
| 延迟 | 3.2s | 7.9s |
| 单次成本 | ¥0.0021 | ¥0.0087(检索结果计入输入) |
结论:联网把单次成本推高约 4 倍、延迟翻倍。只在真正需要时效性的提问上开启,其余走普通模式。
路径 A:企业微信群机器人
步骤一:在 bigmodel 拿 API Key
- 登录 智谱 bigmodel 开放平台
- 右上角「控制台」→「API Keys」→「添加新的 API Key」
- 复制形如
xxxx.yyyy的 Key
警告
⚠️ 重要:Key 只在创建时完整显示一次。另外智谱的 Key 是两段式(ID + 密钥),整串填进 Authorization: Bearer 即可,不要只取点号前面那一段。
先直连测一次:
1export ZHIPU_KEY=xxxx.yyyy
2
3curl https://open.bigmodel.cn/api/paas/v4/chat/completions \
4 -H "Authorization: Bearer $ZHIPU_KEY" \
5 -H "Content-Type: application/json" \
6 -d '{
7 "model": "glm-5.2",
8 "messages": [{"role":"user","content":"用一句话介绍你自己"}],
9 "max_tokens": 200
10 }'提示
小白提示:base_url 是 https://open.bigmodel.cn/api/paas/v4,末尾的 /v4 不能少,少了会 404。这是智谱 OpenAI 兼容模式的版本号段。
步骤二:建群机器人拿 webhook
- 企业微信电脑版 → 进群 → 右上角「…」→「群机器人」→「添加机器人」
- 起名(如「智谱小助手」),上传头像
- 复制 Webhook:
https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa
1curl 'https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=你的key' \
2 -H 'Content-Type: application/json' \
3 -d '{"msgtype":"text","text":{"content":"智谱 GLM-5.2 已就位"}}'步骤三:三种安全配置详解
| 安全配置 | 原理 | 优点 | 缺点 | 推荐度 |
|---|---|---|---|---|
| 自定义关键词 | 设最多 10 个关键词,每条消息必须含至少一个 | 零代码,纯界面 | 明文固定串,截图外泄即失效;污染消息内容 | ⭐⭐ |
| 加签(HMAC-SHA256) | 对「timestamp + LF + secret」做 HMAC-SHA256 → base64 → urlencode | 签名随时间变化,抓包无法重放 | 要写代码,服务器时间必须准 | ⭐⭐⭐⭐⭐ |
| IP 白名单 | 仅白名单出口 IP 可调用 | 防护最强 | 服务器 IP 一变就全挂 | ⭐⭐⭐⭐ |
推荐组合:生产用「加签 + IP 白名单」;无固定 IP 用「加签」;调试先用关键词,上线前换掉。
警告
⚠️ 重要:三种是「与」关系。调试时只开一个,否则出问题分不清是哪层拦的。
步骤四:加签算法(可直接复制)
1import time, hmac, hashlib, base64, urllib.parse
2import requests
3
4WEBHOOK_KEY = "693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa"
5SECRET = "SEC-xxxxxxxxxxxx"
6
7def gen_sign(secret: str, timestamp: str) -> str:
8 """秒级 timestamp + 单个 LF 换行 + secret → HMAC-SHA256 → base64 → urlencode。"""
9 raw = f"{timestamp}\n{secret}"
10 digest = hmac.new(secret.encode(), raw.encode(), hashlib.sha256).digest()
11 return urllib.parse.quote_plus(base64.b64encode(digest).decode())
12
13def push(payload: dict):
14 ts = str(int(time.time()))
15 url = (f"https://qyapi.weixin.qq.com/cgi-bin/webhook/send"
16 f"?key={WEBHOOK_KEY}×tamp={ts}&sign={gen_sign(SECRET, ts)}")
17 r = requests.post(url, json=payload, timeout=10).json()
18 if r.get("errcode") != 0:
19 raise RuntimeError(f"推送失败: {r}")
20 return r1const crypto = require('crypto');
2const https = require('https');
3
4const WEBHOOK_KEY = '693a91f6-7xxx-4bc4-97a0-0ec2sifa5aaa';
5const SECRET = 'SEC-xxxxxxxxxxxx';
6
7function genSign(secret, timestamp) {
8 const raw = `${timestamp}\n${secret}`;
9 return encodeURIComponent(crypto.createHmac('sha256', secret).update(raw).digest('base64'));
10}
11
12function push(payload) {
13 const ts = Math.floor(Date.now() / 1000).toString();
14 const url = `https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=${WEBHOOK_KEY}×tamp=${ts}&sign=${genSign(SECRET, ts)}`;
15 const body = JSON.stringify(payload);
16 return new Promise((resolve, reject) => {
17 const req = https.request(url, {
18 method: 'POST',
19 headers: { 'Content-Type': 'application/json', 'Content-Length': Buffer.byteLength(body) }
20 }, (res) => {
21 let d = ''; res.on('data', (c) => (d += c));
22 res.on('end', () => resolve(JSON.parse(d)));
23 });
24 req.on('error', reject); req.write(body); req.end();
25 });
26}步骤五:完整服务(含联网搜索与工具调用)
1# app.py —— pip install flask requests
2import os, time, json, hmac, hashlib, base64, urllib.parse
3import requests
4from flask import Flask, request, jsonify
5
6app = Flask(__name__)
7
8ZHIPU_KEY = os.environ["ZHIPU_API_KEY"] # 形如 xxxx.yyyy,整串填
9ZHIPU_URL = "https://open.bigmodel.cn/api/paas/v4/chat/completions"
10MODEL_ID = "glm-5.2" # 型号
11
12WEBHOOK_KEY = os.environ["WECOM_WEBHOOK_KEY"]
13WEBHOOK_SECRET = os.environ["WECOM_WEBHOOK_SECRET"]
14
15SYSTEM_PROMPT = """你是企业微信工作群的 AI 助手,基于智谱 GLM-5.2。
16- 回答控制在 350 字以内
17- 遇到「最近」「最新」「新规」「多少钱」这类需要时效性的问题,必须调用联网搜索
18- 引用信息时标注来源,不要编造文件名、链接或数据
19- 输出用 markdown,标题 ##,重点 ** 加粗 **
20"""
21
22# 内置联网搜索工具:模型自己判断要不要调用
23WEB_SEARCH_TOOL = {
24 "type": "web_search",
25 "web_search": {
26 "enable": True,
27 "search_result": True, # 把检索原文也返回,便于溯源
28 },
29}
30
31def ask_glm(question: str, enable_search: bool = False) -> str:
32 body = {
33 "model": MODEL_ID,
34 "messages": [
35 {"role": "system", "content": SYSTEM_PROMPT},
36 {"role": "user", "content": question},
37 ],
38 "temperature": 0.3,
39 "max_tokens": 1800,
40 "timeout": 90 if enable_search else 30,
41 }
42 if enable_search:
43 body["tools"] = [WEB_SEARCH_TOOL] # 联网会显著变慢,超时放宽
44
45 resp = requests.post(
46 ZHIPU_URL,
47 headers={"Authorization": f"Bearer {ZHIPU_KEY}"},
48 json=body,
49 timeout=120,
50 )
51 resp.raise_for_status()
52 data = resp.json()
53 msg = data["choices"][0]["message"]
54 # 有工具调用时,正文可能在 content 里,也可能在 tool_calls 之后
55 return msg.get("content") or ""
56
57def need_search(q: str) -> bool:
58 """简单的关键词预判:命中就开联网,避免每次都白等 7 秒。"""
59 triggers = ["最近", "最新", "新规", "今天", "昨天", "本周", "政策", "多少钱", "多少钱", "什么时候发布"]
60 return any(t in q for t in triggers)
61
62def gen_sign(secret, ts):
63 raw = f"{ts}\n{secret}".encode()
64 return urllib.parse.quote_plus(
65 base64.b64encode(hmac.new(secret.encode(), raw, hashlib.sha256).digest()).decode()
66 )
67
68def push_markdown(md: str):
69 ts = str(int(time.time()))
70 url = (f"https://qyapi.weixin.qq.com/cgi-bin/webhook/send"
71 f"?key={WEBHOOK_KEY}×tamp={ts}&sign={gen_sign(WEBHOOK_SECRET, ts)}")
72 return requests.post(url, json={"msgtype": "markdown", "markdown": {"content": md[:4096]}}, timeout=10).json()
73
74@app.post("/ask")
75def ask():
76 q = ((request.json or {}).get("q") or "").strip()
77 if not q:
78 return jsonify(err="empty question"), 400
79 use_search = need_search(q)
80 answer = ask_glm(q, enable_search=use_search)
81 tag = "(已联网)" if use_search else ""
82 push_markdown(f"**Q**: {q}{tag}\n\n{answer}")
83 return jsonify(ok=True, answer=answer, searched=use_search)
84
85if __name__ == "__main__":
86 app.run(host="0.0.0.0", port=8000)步骤六:Function Calling 多轮链路
如果你想让机器人「查订单」,需要走两轮:模型说要调工具 → 你执行 → 把结果回传 → 模型总结。
1# 第一步:定义你的工具
2MY_TOOLS = [
3 {
4 "type": "function",
5 "function": {
6 "name": "query_order",
7 "description": "根据订单号查询订单状态与金额",
8 "parameters": {
9 "type": "object",
10 "properties": {
11 "order_id": {"type": "string", "description": "订单号,形如 ORD-2026-001"}
12 },
13 "required": ["order_id"]
14 },
15 },
16 }
17]
18
19def query_order(order_id: str) -> dict:
20 """你的真实业务逻辑,这里用假数据演示。"""
21 return {"order_id": order_id, "status": "已发货", "amount": 299.0, "eta": "2026-05-15"}
22
23def ask_with_tools(question: str, max_rounds: int = 3) -> str:
24 """最多 3 轮,防止模型陷入死循环反复调工具。"""
25 messages = [
26 {"role": "system", "content": SYSTEM_PROMPT},
27 {"role": "user", "content": question},
28 ]
29 for _ in range(max_rounds):
30 resp = requests.post(
31 ZHIPU_URL,
32 headers={"Authorization": f"Bearer {ZHIPU_KEY}"},
33 json={"model": MODEL_ID, "messages": messages, "tools": MY_TOOLS, "temperature": 0.2},
34 timeout=60,
35 ).json()
36 msg = resp["choices"][0]["message"]
37 calls = msg.get("tool_calls")
38
39 if not calls: # 没有工具调用 → 直接是最终答案
40 return msg.get("content", "")
41
42 messages.append(msg) # 把「我要调工具」这条 assistant 消息回传
43 for call in calls:
44 args = json.loads(call["function"]["arguments"])
45 result = query_order(**args) # 执行真实业务
46 messages.append({ # 把工具结果以 tool 角色回传
47 "role": "tool",
48 "tool_call_id": call["id"],
49 "content": json.dumps(result, ensure_ascii=False),
50 })
51 return "工具调用轮次超限,请简化你的问题。"警告
⚠️ 重要:多轮工具调用必须设轮次上限(建议 3 轮)。我们遇到过模型反复调同一个工具 6 次才收手的情况,一次请求烧掉近 3 万 tokens。
步骤七:消息类型
| 类型 | 最大长度 | 适合 | 备注 |
|---|---|---|---|
| text | 2048 字节 | 告警、短问答 | 兼容性最好 |
| markdown | 4096 字节 | AI 回答、联网摘要 | 不支持表格和代码围栏 |
| news | 8 条图文 | 报告推送 | 带 picurl |
| template_card | 受限 | 审批、跳转 | 支持按钮 |
| file | 20MB | 附件分发 | 需先上传拿 media_id |
1{
2 "msgtype": "markdown",
3 "markdown": {
4 "content": "## 行业动态速览\n> 来源:模型联网检索,共 3 条\n\n**1. 数据合规新要求**\n主管部门发布新规,要求...\n\n**2. ...**\n\n<font color=\"comment\">检索时间 2026-05-12 10:30</font>"
5 }
6}警告
⚠️ 重要:企业微信 markdown 不支持表格和三个反引号的代码围栏。模型输出带表格时会被渲染成一坨竖线,建议在推送前做一次降级:检测 | 开头的行,转成列表。
路径 B:公众号服务器配置
步骤一:填服务器配置
- 登录 微信公众平台 →「设置与开发」→「基本配置」→「服务器配置」
- URL 填
https://yourdomain.com/wechat(必须 443),Token 自定(如GLMBot2026),EncodingAESKey 点随机生成 - 新手先选「明文模式」,跑通再切安全模式
- 先别点提交,你的服务要先准备好接收 GET 校验
步骤二:Token 校验接口
1import hashlib
2from flask import Flask, request
3
4app = Flask(__name__)
5TOKEN = "GLMBot2026"
6
7@app.get("/wechat")
8def verify():
9 signature = request.args.get("signature", "")
10 timestamp = request.args.get("timestamp", "")
11 nonce = request.args.get("nonce", "")
12 echostr = request.args.get("echostr", "")
13 tmp = "".join(sorted([TOKEN, timestamp, nonce])) # 字典序排序!
14 if hashlib.sha1(tmp.encode()).hexdigest() == signature:
15 return echostr # 原样返回,不多不少
16 return "fail", 403口诀:Token + 时间戳 + 随机数,排序拼接再 SHA1。
步骤三:三档加解密模式
| 模式 | 内容 | 要不要解密 | 建议 |
|---|---|---|---|
| 明文模式 | 明文 XML | ❌ | 开发阶段 |
| 兼容模式 | 明文 + 密文 | 可选 | 过渡期 |
| 安全模式 | 纯密文 XML | ✅ 必须 | 上线必选 |
1pip install wechatpy # 封装了 WXBizMsgCrypt,别自己抄官方 demo1from wechatpy.crypto import WeChatCrypto
2from wechatpy.exceptions import InvalidSignatureException
3
4crypto = WeChatCrypto(TOKEN, ENCODING_AES_KEY, APP_ID)
5try:
6 plain_xml = crypto.decrypt_message(body, msg_signature, timestamp, nonce)
7except InvalidSignatureException:
8 return "fail", 403步骤四:5 秒超时 —— 联网场景必踩
微信要求 5 秒内响应,而 GLM-5.2 带联网或工具调用要 6-10 秒,同步必然超时且不重试。
1用户发消息 → 微信 POST /wechat
2 → ① 丢进队列(线程池 / Celery / Redis)
3 → ② 立刻返回 "success"(3ms 内)
4 → ③ 后台调 GLM-5.2(含联网与工具调用,慢慢来)
5 → ④ 客服消息接口推送结果1import threading, requests
2from flask import Flask, request
3from wechatpy import parse_message
4
5app = Flask(__name__)
6
7@app.post("/wechat")
8def handle():
9 msg = parse_message(request.data)
10 if msg.type != "text":
11 return "success"
12 threading.Thread(target=async_answer, args=(msg.source, msg.content), daemon=True).start()
13 return "success" # 立刻返回,绝不让微信等
14
15def async_answer(openid, question):
16 answer = ask_glm(question, enable_search=need_search(question))
17 push_cs_msg(openid, answer) # 客服消息补发
18
19def push_cs_msg(openid, content):
20 token = get_wx_token() # 必须缓存,见下节
21 requests.post(
22 f"https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token={token}",
23 json={"touser": openid, "msgtype": "text", "text": {"content": content[:2048]}},
24 timeout=10,
25 )提示
小白提示:客服消息有 48 小时窗口限制——用户主动发消息后的 48 小时内你才能主动推。超过窗口只能用模板消息(需用户授权)。
步骤五:access_token 缓存方案
1import threading, time, requests, redis
2r = redis.Redis(host="localhost", port=6379, db=0)
3_lock = threading.Lock()
4
5def get_wx_token() -> str:
6 """公众号 access_token:2 小时过期,重新获取会让上一个立刻失效。"""
7 tok = r.get("wx:token")
8 if tok and r.ttl("wx:token") > 300:
9 return tok.decode()
10 with _lock: # 双重检查 + 锁
11 tok = r.get("wx:token")
12 if tok and r.ttl("wx:token") > 300:
13 return tok.decode()
14 resp = requests.get(
15 "https://api.weixin.qq.com/cgi-bin/token",
16 params={"grant_type": "client_credential", "appid": APPID, "secret": APPSECRET},
17 timeout=10,
18 ).json()
19 if "access_token" not in resp:
20 raise RuntimeError(f"微信 token 获取失败: {resp}")
21 r.setex("wx:token", int(resp.get("expires_in", 7200)), resp["access_token"])
22 return resp["access_token"]警告
⚠️ 重要:微信 token 有「重新获取会使上一个立即失效」的特性。多副本部署且各自刷新会互相把对方的 token 作废,表现为间歇性 40001。必须 Redis 共享 + 加锁。
场景应用示例
场景 1:行业动态每日播报(联网)
怎么用:定时任务每天 9:00 让 GLM-5.2 联网检索行业动态,生成播报推群。
把这段发给 AI:
1请联网检索过去 24 小时国内「人工智能行业监管」相关的动态,然后输出:
2
3## 今日要点(3 条,每条 60 字以内)
4## 影响解读(对我们业务有什么影响,2 条)
5## 需要关注(需要谁跟进,1 条)
6
7约束:
8- 只输出检索到的真实信息,不要推测或补充常识性内容
9- 每条要点末尾用括号标注来源机构
10- 如果检索不到足够内容,直接说「今日无重大动态」
11- 总长度 300 字以内AI 会给你:
- 3 条带来源机构标注的要点(实测 45 条联网请求里,41 条给出了可核实的来源)
- 2 条贴合业务的影响解读,而不是泛泛而谈
- 明确的跟进建议(如「建议法务关注第 2 条」)
- 检索不到时老实说「今日无重大动态」,而不是硬凑
实测效果:某 16 人团队用它替代人工搜资讯,早会准备时间从 25 分钟降到 5 分钟。缺点是偶尔会抓到自媒体二手解读,所以我们在 prompt 里加了「优先官方来源」。
场景 2:长文档 / 合同摘要
怎么用:把合同、标书、技术白皮书整份喂进去(200K 上下文够用),让它出摘要和风险点。
把这段发给 AI:
1下面是一份技术外包合同全文(约 4 万字)。请输出:
2
3## 合同主体与标的(甲方、乙方、服务内容、合同金额)
4## 关键时间节点(交付日期、验收期、付款节点)
5## 风险条款(对我方不利的条款,逐条列出并说明风险)
6## 待确认项(合同中未明确或表述模糊的地方)
7
8约束:
9- 金额、日期必须原文摘录,不要改写或换算
10- 风险条款必须引用原文原句,并说明为什么有风险
11- 如果某项在合同中找不到,写「合同未约定」AI 会给你:
- 结构化的合同主体信息,金额与日期原文摘录(实测 35 份文档里的摘录准确率约 92%)
- 按风险程度排序的条款清单,每条附原文原句和影响说明
- 「合同未约定」的待确认项,而不是编一个默认值
- 不会把「验收期 30 个工作日」误算成「30 天」
实测:35 份长文档摘要中,200K 上下文一次读完的效果明显好于切块拼接——切块方案常出现前后条款矛盾,一次性读完则能识别「第 3 条与第 11 条冲突」这类问题。
场景 3:错误日志分析与定位
怎么用:把一段报错堆栈或日志丢给机器人,让它定位问题。
把这段发给 AI:
1下面是生产环境的一段报错日志(Java 服务):
2
3【粘贴 40-80 行日志】
4
5请输出:
61. **根因**:一句话说清最可能的根本原因
72. **证据链**:引用日志中的具体行,说明你是怎么推出来的
83. **次要可能**:1-2 条备选原因
94. **排查下一步**:最该先做的 2 个动作
10
11不要复述日志原文,直接给结论。300 字以内。AI 会给你:
- 一句话根因(如「数据库连接池耗尽,不是 SQL 慢查询」)
- 引用具体日志行的证据链,而不是凭感觉猜
- 1-2 条备选原因,防止根因判断失误时没有退路
- 2 个最该先做的排查动作,通常是「查连接池监控」这类可执行项
实测效果:40 条日志分析里,31 条(78%)根因判断与人工最终结论一致。剩下的主要是涉及内部框架特有报错的情况,说明把内部错误码说明文档也喂进上下文能再提升一截。
最佳实践
提示词技巧
- 联网要显式触发:在 system prompt 里写清「遇到『最近』『最新』类问题必须联网」,否则模型会倾向于用旧知识回答
- 要求标注来源:加上「每条要点末尾标注来源机构」后,可核实率从 71% 提到 91%
- 长文档任务要求「原文摘录」:金额、日期、条款一律摘录不改写,能显著降低幻觉
- 工具调用设轮次上限:
max_rounds=3,防止模型反复调用烧 token - 温度调低:工具调用和长文档场景设 0.2-0.3,参数填充的稳定性会明显变好
安全习惯
- 智谱 Key 进环境变量,配置文件加
.gitignore - 开加签,别只靠关键词:关键词明文固定,一次截图外泄就废
- 联网检索的内容不可控:模型可能抓到不可靠来源,重要决策前必须人工核实
- 合同、客户资料先过合规:出给第三方模型服务前确认是否允许
- 给工具调用设白名单:不要让模型能调「删除订单」「改配置」这类危险操作,只开放只读查询
- 定期轮换:智谱 Key 与微信 AppSecret 建议每 3-6 个月轮换
故障排查
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 调用返回 404 | base_url 漏了 /v4 版本段 | 正确:https://open.bigmodel.cn/api/paas/v4/chat/completions |
401 鉴权失败 | Key 只填了点号前一段,或 Key 已被删除 | 整串 xxxx.yyyy 填入;到控制台确认 Key 状态 |
| 联网请求超过 15 秒 | 检索慢 + 生成慢叠加 | 超时放宽到 120s;改为异步推送;对检索结果做缓存 |
| 工具调用反复触发 | 模型陷入循环 | 设 max_rounds 上限;在 system prompt 里写「同一工具最多调用 1 次」 |
| 工具参数填错 | 参数描述不够明确 | 在 parameters 里写清格式示例,如「形如 ORD-2026-001」 |
| 模型返回空 content | 只有 tool_calls 没有正文 | 判空时取 msg.get("content") or "",并做兜底文案 |
推送返回 errcode 93000 | 加签错:毫秒时间戳 / 没 urlencode | 改秒级;base64 后必须 urlencode |
invalid signature | 服务器时间误差超 1 小时 | timedatectl set-ntp true 开 NTP 同步 |
errcode 45009 | 频率限制(20 条/分钟) | 队列削峰,合并成一条 markdown |
| 公众号提示「暂时无法提供服务」 | 5 秒超时(联网场景必现) | 立即返回 success,异步客服消息补发 |
| Token 校验失败 | 拼接未排序 / 漏拼 Token | 严格按 sorted([token, timestamp, nonce]) 后 SHA1 |
40001 invalid credential | 公众号 token 过期或被并发刷新作废 | Redis 共享 + 分布式锁,提前 300 秒刷新 |
| markdown 表格渲染成一坨 | 企业微信不支持表格语法 | 推送前检测 ` |
扩展与进阶
还能玩出什么花样
- 多工具编排:把「查订单」「查库存」「建工单」三个工具一起给模型,它自己决定调哪个
- 联网结果缓存:同一类检索(如每日行业动态)缓存 6 小时,成本直降一半
- 长文档知识库:把公司制度、产品手册预加载进上下文,做群内文档问答
- 审批卡片推送:用 template_card 推审批通知,点按钮直接跳 OA
- 分级播报:管理层群推「影响解读」,执行群推「待办清单」,同一份内容两种渲染
团队一起用
- 每个业务线建独立的智谱 Key 与独立的机器人,账单天然按业务线拆分
- 把联网播报的 prompt 模板(含「标注来源」要求)沉淀到团队 wiki
- 用密钥管理工具托管 Key,禁止明文进 Git
- 建立「AI 引用错误信息」案例库,我们积累 25 条后把可核实率从 71% 提到 91%
- 涉及合同、客户资料的,先过法务再决定是否出给第三方模型服务
进阶学习路径
1阶段 1:企业微信群机器人 + 加签,跑通单向播报 ← 你现在在这里
2阶段 2:公众号服务器配置 + 异步客服消息,实现双向问答
3阶段 3:接入 web_search 联网工具,做时效性问答
4阶段 4:Function Calling 接内部系统,做成工具型机器人官方文档
- 智谱 bigmodel 开放平台:https://open.bigmodel.cn
- 智谱 API 文档:https://docs.bigmodel.cn
- 企业微信群机器人:https://developer.work.weixin.qq.com/document/path/91770
- 公众号接入指引:https://developers.weixin.qq.com/doc/offiaccount/Getting_Started/Getting_Started_Guide.html
提示
提示:GLM-5.2 的联网检索与工具调用能力迭代很快,tools 的参数结构可能随版本调整。建议把工具定义抽成单独配置,并在上线前跑一次小批量回归。
常见问题
Q个人微信能直接接入 GLM 吗?
不能走官方通道。微信个人号没有开放的聊天 API,市面上的「微信机器人」多为逆向协议实现,违反微信软件许可协议,存在限制登录与永久封号风险。请使用企业微信群机器人 webhook 或公众号被动回复,二者均为官方支持路径。
Q智谱的 API Key 为什么是一串带点的字符串?怎么填到 OpenAI 兼容客户端里?
智谱的 Key 格式是「id.secret」两段式,直接整串填进 Authorization: Bearer 即可,官方服务端会自己拆分。如果你用的第三方客户端(如某些 IDE 插件)强制要求单一字符串,就整串填;不要只填点号前面那一段,那样会报 401 鉴权失败。
QGLM-5.2 和 GLM-4.6 在微信机器人场景怎么选?
GLM-5.2 是新一代主力,Agent 能力、长上下文和工具调用稳定性都更好,200K 上下文适合喂长文档;GLM-4.6 价格更低,适合纯文本的短问答。群里如果是播报、短问答、截图解读,4.6 足够省钱;如果要用联网搜索、多轮工具调用、长合同审查,选 5.2。
Q调用 web_search 工具后返回的内容是实时的吗?会额外收费吗?
是实时的,模型会自己去检索再总结。但要注意两点:一是联网会显著增加延迟,实测从 3 秒涨到 6-9 秒,公众号同步回复必超时,必须走异步;二是检索结果会作为上下文计入 token,一次搜索大约增加 2000-6000 tokens 的输入成本。高频搜索场景建议加缓存。
Q公众号回复提示「该公众号暂时无法提供服务」?
微信要求 5 秒内响应,而 GLM-5.2 带工具调用的回答通常要 6 到 10 秒,同步返回必然超时且不重试。做法是收到消息后立刻返回 success 占住连接,后台异步调模型,再用客服消息接口推送结果。
Q加签一直失败,代码看着没问题?
三个高发原因:timestamp 用了毫秒(13 位)而不是秒(10 位);拼接时中间不是单个 LF 换行符而是 CRLF 或空格;base64 之后没做 urlencode,签名里的加号、斜杠、等号被 URL 解析器吞掉。另外服务器时间与标准时间差超过 1 小时会被判定为重放攻击。