需将gemini 3.1 pro api接入企业微信/钉钉机器人：先配置webhook地址并设ip白名单，再用fastapi搭建中间层服务接收消息，调用api时推荐契约式json提示以确保结构化输出，最后按平台规范回传markdown消息并添加重试与溯源标识。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让员工在企业微信或钉钉群里直接@机器人提问“上季度客户投诉TOP3是什么”“张经理下周有没有空档”，系统自动查表、读文档、生成结论并返回结构化答案，而不是每次都要人工翻记录、贴截图、手动汇总——这就需要把Gemini 3.1 Pro API真正接入到企业微信或钉钉的机器人通道里，让它成为可触发、可校验、可回传的智能客服节点。
配置企业微信/钉钉机器人入口
登录企业微信管理后台→应用管理→自建应用→创建应用，类型选“机器人”，填写名称（如“Gemini智服”），保存后进入详情页，复制“机器人Webhook地址”。
钉钉侧则需进入钉钉开放平台→应用开发→企业内部开发→机器人→创建应用，选择“群机器人”，启用“自定义关键词触发”，获取“Webhook地址”。【该地址是消息唯一入口，调用时必须用HTTPS POST，且不能暴露在前端代码中】
两个平台都必须开启“消息接收”权限，并在安全设置中添加你服务端的IP白名单（若部署在云服务器，填公网IP；若用本地调试，先配内网穿透）。
搭建中间层服务端（推荐Python FastAPI）
新建一个Python项目，安装依赖：pip install fastapi uvicorn python-dotenv requests。
创建 main.py，写入基础路由：监听 /webhook 接收企业微信/钉钉发来的JSON消息，提取 text.content 或 message.content 字段作为原始输入。
在环境变量文件 .env 中写入：GEMINI_API_KEY=your_actual_key_here，确保该文件不提交至Git。这一步漏掉会导致后续所有调用返回401错误，且密钥泄露风险极高。
服务启动命令：uvicorn main:app --host 0.0.0.0 --port 8000 --reload。确认服务能正常响应HTTP请求后，再进入下一步。
公众号运营：文章发布至草稿、样式封面、评论与用户管理、数据统计等。用户要求将 Markdown 发送到公众号草稿、查看阅读量统计或类似后台操作时，使用本技能。
调用Gemini 3.1 Pro API并结构化输出
方法一：纯文本问答（适合快速验证）
用 requests.post 向 https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-pro:generateContent?key={GEMINI_API_KEY} 发送POST请求，body为标准JSON：{"contents":[{"parts":[{"text":"请用中文回答：{user_input}"}]}]}。
方法二：带格式约束的强结构输出（推荐生产使用）
在prompt中明确要求返回JSON格式，并限定字段，例如：“请严格按以下JSON格式返回，不要任何额外说明：{\"summary\":\"\",\"key_points\":[],\"action_items\":[\"\"]}”。Gemini 3.1 Pro对这类契约式提示响应稳定，避免自由发挥导致解析失败。
方法三：多模态支持（如员工上传会议截图）
企业微信/钉钉会将图片转为临时media_id，你需要先用平台接口下载图片二进制流，再Base64编码后嵌入Gemini请求的 parts 中，类型设为 {"inlineData": {"mimeType": "image/png", "data": "base64_encoded_string"}}。注意：单次请求总大小不能超过20MB，超限会直接报错413。
将结果安全回传至群聊
第一步：判断原始消息来源是企业微信还是钉钉，调用对应平台的发送接口。
企业微信用 https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx，钉钉用 https://oapi.dingtalk.com/robot/send?access_token=xxx。
第二步：构造回传消息体。企业微信支持text、markdown、news多种类型；钉钉支持text、markdown、feedCard。优先选markdown，兼容性好，支持加粗、列表、换行，员工阅读体验清晰。
第三步：添加失败重试机制。网络抖动或平台限流时，第一次发送失败需延迟1秒后重试，最多2次。若仍失败，将原始请求与错误码写入日志，并向管理员推送告警消息，【不可静默丢弃用户请求】。
第四步：在返回消息末尾自动追加一行小字：“?由Gemini 3.1 Pro生成｜内容已校验｜如有疑问请反馈”。这既建立信任感，也隐含责任边界。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
