微伴助手

要解决什么问题

在企业微信场景里，员工视角的会话存档往往和 CRM、工单、标签、素材话术拆在不同系统里。分析「某员工最近和客户说了什么」「客户档案与聊天是否一致」「要不要打标签或建工单」时，需要反复登录后台、拼时间窗口，还容易踩 OpenAPI 的默认限制（例如消息查询常被裁到最近 7 天）。

本技能通过微伴 OpenAPI AI-Agent 接口，把消息存档查询与业务上下文（客户、部门、群、表单、雷达等）接到同一套 Agent 调用路径上，并在需要时走受控的写入流程。

技能如何工作

• 消息存档：查最近聊天、会话列表、消息窗口与时间线；汇报聊天时可用 Markdown 表格（时间、会话/客户、发送人、内容摘要、判断/动作）。优先用 msgaudit.chat.employee_timeline，需传 staff_id 或环境变量 WEIBAN_AGENT_STAFF_ID；仅要会话概览可用 msgaudit.chat.recent_context 且 include_messages=false。
• 业务只读：客户画像/标签/事件、素材话术、工单与模板、员工与部门、客户群、表单与雷达、群发/朋友圈任务列表等（如 customer.*、workorder.*、material.search）。
• 业务写入：标签、积分、群发、朋友圈、工单创建/回复/关闭等；默认需 --allow-write，真实写入前优先 dry_run / precheck，并带幂等字段（如 idempotency_key）。
• 输出与安全：默认 compact JSON；不输出 secret、token、消息全文、客户敏感字段或完整附件 URL。HTTP 超时建议 8～12 秒（脚本默认 10 秒）。

凭证通过环境变量配置；员工 Agent Secret 的签发见独立文档 references/staff-agent-secret-auth.md，不属于本 skill 的可调用能力。执行脚本前进入 skill 目录，用相对路径调用 scripts/weiban_agent_skill.py。

适用边界与注意点

• 消息时间范围：不传默认最近 7 天，传入也会被裁到最多 7 天；limit 最多 200。Secret 只负责鉴权，不会自动限定消息存档的员工范围。
• customer.events 数据较重，仅在深度分析客户时使用。
• 工单关闭、转交等操作应先读工单详情与可操作按钮，再经用户明确授权后写入。