| name | dingtalk |
| platforms | ["dingtalk"] |
| description | 钉钉平台管理能力。当用户在钉钉中请求群管理(踢人、改群名、查群信息)、 组织架构查询(部门/用户查询)、发送工作通知、创建或管理群聊时使用。 即使用户没有提到钉钉,只要上下文是钉钉/DingTalk 场景且涉及群管理、 组织架构或工作通知,就应触发。仅有昵称时先查部门用户列表获取 user_id。 |
| keywords | ["dingtalk","钉钉","adapter:dingtalk","群管理","部门","工作通知","组织架构","企业","list_members"] |
| tags | ["group","management","im","enterprise"] |
| tools | ["dingtalk_get_user","dingtalk_get_dept_users","dingtalk_list_departments","dingtalk_send_work_notice","dingtalk_create_chat","dingtalk_add_chat_members","dingtalk_dept_info","dingtalk_update_chat","dingtalk_kick_member","dingtalk_set_group_name","dingtalk_get_group_info"] |
钉钉群聊与组织管理技能
钉钉是企业 IM 平台,特有组织架构(部门树)和工作通知能力,区别于个人社交类 IM。
核心原则
组织架构是核心
钉钉的用户隶属于部门树,很多操作需要从组织架构出发:
dingtalk_list_departments → 获取部门列表(根部门 ID=1)
dingtalk_get_dept_users(dept_id) → 获取部门下的用户列表
dingtalk_get_user(user_id) → 获取用户详情
工作通知 ≠ 群消息
dingtalk_send_work_notice 是直接发给个人的企业通知,出现在钉钉的「工作通知」入口,不需要群聊。用户说「通知一下张三」,如果是正式的企业通知,用 send_work_notice;如果只是聊天消息,用普通消息发送。
工具分类
群聊管理
| 工具 | 用途 | 说明 |
|---|
dingtalk_kick_member | 踢出成员 | — |
dingtalk_set_group_name | 改群名 | — |
dingtalk_get_group_info | 群信息 | — |
dingtalk_create_chat | 创建群聊 | 需群主 userId + 至少一个成员 |
dingtalk_add_chat_members | 添加成员 | — |
dingtalk_update_chat | 更新群设置 | 改名、换群主、增减成员 |
组织架构
| 工具 | 用途 | 说明 |
|---|
dingtalk_list_departments | 部门列表 | 默认从根部门 ID=1 开始 |
dingtalk_dept_info | 部门详情 | — |
dingtalk_get_dept_users | 部门用户列表 | — |
dingtalk_get_user | 用户详情 | — |
通知
| 工具 | 用途 | 说明 |
|---|
dingtalk_send_work_notice | 工作通知 | 发给指定用户列表,不需要群 |
易错点
- 部门查询从根部门 ID=1 开始。不知道部门 ID 时先
list_departments 获取整棵部门树。
- 群聊创建需要群主 userId 和至少一个成员,不能创建空群。
- 工作通知是独立于群聊的,它发到个人的钉钉「工作通知」入口,不要与群消息混淆。
- 操作成员需要钉钉 userId,仅有昵称时先通过
get_dept_users 或 get_group_info 查找。