跳转到主要内容

juhecli-user 企微用户

juhecli-user — 企微用户管理:获取帐号信息、公司信息、登出

使用案例

查看我的信息我的企业信息切换账号

查看我的信息

获取当前登录用户的个人资料
>查看我的信息
$juhe-cli user profile --guid xxxx-xxxx-xxxx
{ "data": { "name": "张三", "userid": "zhangsan", "avatar": "https://wxwork.qq.com/avatar/xxxxx", "mobile": "138****1234", "email": "zhangsan@example.com", "gender": 1 } }

查看公司信息

获取当前用户所属企业信息
>我的企业信息
$juhe-cli user corp_info --guid xxxx-xxxx-xxxx
{ "data": { "corp_name": "示例科技有限公司", "corp_id": "ww1234567890", "corp_type": "企业", "industry": "互联网/软件", "scale": "100-499人" } }

概述

企微用户 SKILL 提供企业微信帐号信息查询和登出功能。包括获取个人帐号信息(姓名、头像、ID)、 公司信息(企业名称、行业、规模)和登出操作。 所有命令仅需 guid 参数(由 Agent 自动从设备管理 SKILL 获取),无需用户提供额外参数。

SKILL 定位

此 SKILL 用于确认登录身份和查看企业信息。AI Agent 在登录后可先调用 user profile 确认当前帐号, 再进行后续操作。

触发方式

用户可能会这样自然地表达需求:

  • "查看我的信息"
  • "我的企业信息"
  • "我是哪个企业的"
  • "登出"
  • "切换帐号"

命令列表

SKILL 名称说明
juhecli-user企微用户管理 - 获取帐号信息、公司信息、登出

详细命令说明

获取个人帐号信息 (user profile)

获取当前登录用户的个人详细信息,包括姓名、头像、用户 ID 等。Agent 可在登录后调用此命令确认身份。

参数

参数类型必填来源说明
guidstring[需查询]来自设备管理 SKILL 的返回值

返回值

字段说明
name用户姓名
userid用户唯一 ID
avatar头像 URL
mobile手机号码
email邮箱地址
gender性别

获取公司信息 (user corp_info)

获取当前用户所属企业的详细信息。

参数

参数类型必填来源说明
guidstring[需查询]来自设备管理 SKILL 的返回值

返回值

字段说明
corp_name企业名称
corp_id企业 ID
corp_type企业类型
industry所属行业
scale企业规模

登出 (user logout)

登出当前企业微信帐号。登出后需要重新登录才能使用其他企微功能。

参数

参数类型必填来源说明
guidstring[需查询]来自设备管理 SKILL 的返回值

登出影响

登出后所有企微功能将不可用,需要通过登录 SKILL 重新扫码登录。 AI Agent 应在执行登出前向用户确认。

Agent 交互示例

查看个人帐号信息

text
用户: "查看我的信息"
AI: 好的,正在查询您的帐号信息...
   [Agent 调用 user profile]

   您的企业微信帐号信息:
   - 姓名:张三
   - 用户ID:zhangsan
   - 手机:138****1234
   - 邮箱:zhangsan@example.com

查看企业信息

text
用户: "我的企业信息"
AI: 正在查询您的企业信息...
   [Agent 调用 user corp_info]

   您所属的企业:
   - 企业名称:示例科技有限公司
   - 企业ID:ww1234567890
   - 行业:互联网/软件
   - 规模:100-499人

登出帐号

text
用户: "登出"
AI: 确认要登出当前企业微信帐号吗?登出后需要重新扫码登录。
用户: "确认"
AI: [Agent 调用 user logout]
   已成功登出。如需继续使用,请告诉我重新登录。

切换帐号

text
用户: "切换到另一个帐号"
AI: 好的,先为您登出当前帐号...
   [Agent 调用 user logout]
   已登出。正在获取新帐号的登录二维码...
   [Agent 调用 login qrcode]
   请扫描二维码登录新帐号。

参数来源说明

参数来源标记获取方式
guid[需查询]Agent 通过 device list 获取

无需用户输入

此 SKILL 的所有命令仅需 guid,无需用户提供额外参数。AI Agent 可直接调用。

典型工作流

登录后确认身份

  1. Agent 调用 login 完成登录
  2. Agent 调用 user profile 确认当前帐号
  3. Agent 调用 user corp_info 确认所属企业
  4. 向用户汇报登录状态和身份信息
text
// 完整工作流示例
用户: "帮我登录企业微信"
AI: [登录流程完成后]
   登录成功!您当前的身份:
   - 姓名:张三
   - 企业:示例科技有限公司(互联网/软件行业)
   现在可以使用企微功能了。

错误处理

错误原因处理方式
未登录尚未完成登录流程先通过登录 SKILL 完成登录
guid 无效设备 GUID 错误或过期重新调用 device list 获取有效 guid
权限不足非管理员访问受限信息告知用户权限限制
网络错误API 不可达检查网络连接,稍后重试