前置条件
- 1已安装钉钉客户端，且是目标群的群主或管理员
- 2已开通百度智能云千帆大模型平台，并完成实名认证
- 3已在千帆「应用接入」中创建应用并拿到 API Key
- 4已安装 Python 3.9+，能访问公网
即时通信 IM + AI
高效构建智能聊天能力
常见问题
Q千帆平台的 API Key 和旧版的 API Key / Secret Key 有什么区别，用哪个？
千帆 v2（推荐）只给一串 API Key，请求头写 Authorization: Bearer <API_KEY>，base_url 用 https://qianfan.baidubce.com/v2，模型名写 ernie-4.5，OpenAI SDK 可以零改动迁移。旧版 ERNIE 4.0 及更早走 https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/chat/completions，需要先用 API Key 和 Secret Key 换一个有效期 30 天的 access_token。新项目一律用千帆 v2，旧项目迁移时两套都能并存。
Q调用返回 errcode 100 / 110 / 111 是什么意思？
这三个是鉴权类错误里最高频的：100 表示 access_token 无效或已过期（换一个，或检查是不是把千帆的 API Key 当成 access_token 用了）；110 表示没有该模型的调用权限（去千帆控制台「模型服务」里开通 ERNIE 4.5 的付费或免费额度）；111 表示 access_token 已过期（旧版路径下 30 天到期，做缓存时别缓存超过 25 天）。
Q钉钉群里机器人回复经常超时（超过 20 秒）怎么办？
钉钉群机器人回调有约 20 秒的响应窗口，ERNIE 4.5 生成 800 字通常要 12-18 秒，很容易卡线。三种解法：一是把 max_completion_tokens 压到 600，让回答更短；二是改走 AI 卡片流式，先回一个空卡片占位再异步推送内容，这样回调可以秒回；三是把重活丢到 Celery / 线程池，回调只做入队。
QERNIE 4.5 的上下文窗口是多少，能一次塞整份制度文件吗？
ERNIE 4.5 主版本支持 128K 上下文，实测一份 3 万字的员工手册（约 4.5 万 tokens）可以完整塞进去并准确引用条款号。但注意两点：一是超长输入会显著拉慢首字延迟（实测 40K tokens 输入时首字 6.8 秒）；二是千帆对单次输入 token 数有上限，超过会报参数错误，建议超过 60K tokens 时先做切片检索（RAG）再问。
Q一个机器人能不能同时服务多个群，怎么区分消息来自哪个群？
能。企业内部应用方案下，每条回调消息体里都带 conversationId / openConversationId，用它做路由即可：建一张群 ID 到业务配置的映射表，不同群走不同的 system prompt（比如 HR 群优先答制度，运维群优先答告警）。群机器人方案做不到，因为 Webhook 与群是一对一绑定的。
Q消息里带手机号、身份证号会不会有合规风险？
会。千帆默认会对请求内容做安全审计并保留日志用于合规追溯，直接把含个人敏感信息的原文发给公网模型存在合规风险。建议：一是入群前在提示词规范里明确禁止粘贴敏感信息；二是在发送前跑一遍脱敏（手机号中间四位打星、身份证只保留前 6 位）；三是涉及个人信息量大的场景改用千帆专属实例或私有化部署。