Weiban Agent Skill
通过微伴 OpenAPI AI-Agent 接口读取员工视角的企微消息存档和业务上下文。
主要能力：
- 查询员工最近聊天、会话、消息窗口和消息时间线。
- 查询客户画像、客户标签、客户事件、员工、部门、客户群、表单、雷达、素材和话术。
- 创建和处理工单，或发起标签、积分、群发、朋友圈等业务任务。
适用场景
- 用户要查看员工最近聊天或指定时间范围内的企微聊天记录；OpenAPI 会默认限制到最近 7 天，也会裁剪更大的时间范围。
- 用户要结合聊天记录、客户档案、素材话术、表单、雷达、标签和工单做分析。
- 用户要查询或处理客户、工单、素材、员工、部门、客户群、表单、雷达、任务等 OpenAPI AI-Agent 能力。
基础地址和凭证
https://open.weibanzhushou.com
环境变量：
export WEIBAN_AGENT_BASE_URL="https://open.weibanzhushou.com"
export WEIBAN_AGENT_SECRET="<staff-agent-secret>"
export WEIBAN_AGENT_STAFF_ID="<staff-ext-id>"
员工 Agent Secret 的签发方式见 references/staff-agent-secret-auth.md。该签发接口是独立标准接口文档，不属于本 skill 的可调用能力。
使用脚本
执行命令时先进入本 skill 目录，后续都用相对路径调用脚本，避免绑定某台电脑或某个用户名：
cd "$(dirname "$SKILL_FILE")"
如果运行环境没有注入 SKILL_FILE，就进入当前安装的 weiban-agent-skill 目录后执行同样命令。不要把用户本机的绝对路径写进脚本或示例。
优先用意图级命令：
# 消息存档可用性检查
python3 scripts/weiban_agent_skill.py smoke
# 指定员工最近 6 小时聊天时间线
python3 scripts/weiban_agent_skill.py timeline --staff-id "<staff_ext_id>" --hours 6
# 搜索消息存档
python3 scripts/weiban_agent_skill.py search "合同" --staff-id "<staff_ext_id>" --hours 24
# 打开消息窗口
python3 scripts/weiban_agent_skill.py window "<session_id>" "<message_id>" --staff-id "<staff_ext_id>" --session-type single
# 客户上下文
python3 scripts/weiban_agent_skill.py customer "客户关键字"
# 素材和话术
python3 scripts/weiban_agent_skill.py material "报价"
# 工单列表
python3 scripts/weiban_agent_skill.py workorders
底层调用：
python3 scripts/weiban_agent_skill.py list
python3 scripts/weiban_agent_skill.py examples
python3 scripts/weiban_agent_skill.py call msgaudit.messages.search --payload '{"staff_id":"<staff_ext_id>","session_type":"all","limit":10}'
能力范围
消息存档：
msgaudit.useablemsgaudit.sessions.searchmsgaudit.sessions.getmsgaudit.messages.searchmsgaudit.messages.windowmsgaudit.chat.recent_contextmsgaudit.chat.employee_timeline
业务查询和 AI 上下文：
- 客户：
customer.search/detail/profile_context/tags/events - 素材话术：
material.search - 工单：
workorder.list/detail/handler_list/template.list/template.detail - 员工部门：
staff.*、department.* - 标签：
tag_group.*、tag.*、group_tag_group.*、group_tag.* - 客户和客户群：
external_user.*、group_chat.* - 表单和雷达：
smart_form.*、interact_radar.* - 群发/朋友圈任务查询：
group_msg.list、customer_group_msg.list、moment_message.list
业务写入：
- 客户标签：
customer.mark_tag - 工单：
workorder.upload/create/update/reply/switch/close - 任务：
task.tag.*、task.group_tag.*、task.score.*、task.integral.*、task.group_msg.*、task.customer_group_msg.*、task.moment_message.*
业务写接口默认需要显式加 --allow-write。真实写入前优先用 dry_run 或 precheck，真实写入必须有幂等字段，如 idempotency_key 或业务 request_id。
输出要求
- 默认输出 compact JSON，正文类字段只给摘要。
- 给用户汇报聊天记录时默认用 Markdown 表格，列：
时间、会话/客户、发送人、内容摘要、判断/动作。 - 不输出 secret、token、消息正文全文、客户敏感字段、完整附件 URL。
- 最近聊天优先使用
msgaudit.chat.employee_timeline，必须传入staff_id或设置WEIBAN_AGENT_STAFF_ID；员工 Agent Secret 只负责鉴权，不会自动填充消息存档的员工查询范围。时间不传时默认最近 7 天，传入时也会被裁剪到最多 7 天，limit最多 200。 - 只需要会话级概览时用
msgaudit.chat.recent_context且include_messages=false。
安全约束
customer.events数据较重，只在深度分析客户时调用。- 工单、客户标签、任务等业务写接口如需使用，先
dry_run/precheck，真实写入必须用户明确授权。 - 工单关闭、转交等操作应先读取工单详情和可操作按钮，再执行真实写入。
- HTTP timeout 控制在 8-12 秒，脚本默认 10 秒。
参考资料
- OpenAPI AI-Agent 全接口索引：
references/openapi-interface-index.md - 员工 Agent Secret 签发文档：
references/staff-agent-secret-auth.md - 调用脚本：
scripts/weiban_agent_skill.py
