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 可在登录后调用此命令确认身份。
参数
| 参数 | 类型 | 必填 | 来源 | 说明 |
|---|---|---|---|---|
guid | string | 是 | [需查询] | 来自设备管理 SKILL 的返回值 |
返回值
| 字段 | 说明 |
|---|---|
name | 用户姓名 |
userid | 用户唯一 ID |
avatar | 头像 URL |
mobile | 手机号码 |
email | 邮箱地址 |
gender | 性别 |
获取公司信息 (user corp_info)
获取当前用户所属企业的详细信息。
参数
| 参数 | 类型 | 必填 | 来源 | 说明 |
|---|---|---|---|---|
guid | string | 是 | [需查询] | 来自设备管理 SKILL 的返回值 |
返回值
| 字段 | 说明 |
|---|---|
corp_name | 企业名称 |
corp_id | 企业 ID |
corp_type | 企业类型 |
industry | 所属行业 |
scale | 企业规模 |
登出 (user logout)
登出当前企业微信帐号。登出后需要重新登录才能使用其他企微功能。
参数
| 参数 | 类型 | 必填 | 来源 | 说明 |
|---|---|---|---|---|
guid | string | 是 | [需查询] | 来自设备管理 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 可直接调用。
典型工作流
登录后确认身份
- Agent 调用
login完成登录 - Agent 调用
user profile确认当前帐号 - Agent 调用
user corp_info确认所属企业 - 向用户汇报登录状态和身份信息
text
// 完整工作流示例
用户: "帮我登录企业微信"
AI: [登录流程完成后]
登录成功!您当前的身份:
- 姓名:张三
- 企业:示例科技有限公司(互联网/软件行业)
现在可以使用企微功能了。错误处理
| 错误 | 原因 | 处理方式 |
|---|---|---|
| 未登录 | 尚未完成登录流程 | 先通过登录 SKILL 完成登录 |
| guid 无效 | 设备 GUID 错误或过期 | 重新调用 device list 获取有效 guid |
| 权限不足 | 非管理员访问受限信息 | 告知用户权限限制 |
| 网络错误 | API 不可达 | 检查网络连接,稍后重试 |