前置条件
- 1已安装钉钉客户端，且是目标群的群主或管理员
- 2已开通火山引擎方舟平台并创建推理接入点
- 3已安装 Python 3.9+，能访问公网
- 4了解基本的 HTTP 请求与 JSON 格式
即时通信 IM + AI
高效构建智能聊天能力
常见问题
Q火山方舟里的「推理接入点 ID」是什么，为什么不能直接用 doubao-1.5-pro-32k？
方舟的设计是「先建接入点，再用接入点调用」。你在控制台选好模型、开通额度后创建一个接入点，拿到一个 ep-2025xxxx-xxxxx 格式的 ID，请求时 model 字段填这个 ID 而不是模型名。直接填 doubao-1.5-pro-32k 会返回 InvalidEndpoint 或 model not found。这是新手最常卡的一步，也是方舟和其他家最大的设计差异。好处是同一个模型可以建多个接入点分别配额、分别计费。
Q创建接入点后调用一直报「额度不足」或 model not found，怎么排查？
按这个顺序查：一是接入点状态是否为「运行中」（刚创建有几秒到几十秒的就绪时间）；二是该接入点绑定的模型是否已完成开通（模型详情页有「开通」按钮，免费额度也要点）；三是 API Key 是否属于接入点所在的账号（子账号的 Key 调主账号的接入点会 403）；四是 region 是否匹配，方舟有多个地域，Key 和接入点要同地域。
Q豆包 1.5 Pro 和 doubao-1.5-thinking-pro（深度思考版）怎么选？
Pro 是常规版，响应快、成本低，适合文案生成、话术整理这类「发散但不需要推理」的任务；Thinking Pro 会在回答前生成思维链，适合需要逻辑推演的任务（归因分析、方案对比、数据解读），代价是延迟高 2-3 倍、输出 token 多 40%。钉钉群里日常用 Pro，遇到「为什么转化率掉了」这类归因问题再切 Thinking Pro，代码里用关键词规则分流即可。
Q生成的营销文案太模板化，怎么调？
三个有效手段：一是把 temperature 提到 0.8-1.0（文案场景要发散，技术场景才要收敛）；二是在提示词里给 2-3 个你认可的样例，让它模仿语气而不是模仿结构；三是明确禁止词（如「不容错过」「震撼上市」），实测加了禁止词表后，文案被运营打回的比例从 61% 降到 23%。
Q豆包支持 Function Calling 吗，能在钉钉群里查订单吗？
支持，豆包 1.5 Pro 的 function calling 在国内模型里属于稳定档。做法是在 tools 数组里声明函数 schema，模型返回 tool_calls 后你在本地执行再回传结果。钉钉群里可以做「查物流」「查库存」这类只读操作；涉及写入或资金的操作务必加二次确认（让用户在 ActionCard 上点按钮），不要让模型直接执行。
Q群里一天几百条消息，怎么控制成本？
四个办法：一是非必要不走 Thinking 版（差 3 倍价格）；二是限制 max_tokens 到 600，群里没人看长文；三是相同问题做结果缓存（我们实测运营群里约 27% 的提问是重复或近似的，缓存命中后直接返回）；四是给每个群设日调用上限，超了就降级到更便宜的模型或提示「明天再来」。