用途:查询飞书通讯录中的用户与部门信息,包括用户信息、部门成员、部门详情及组织架构。
主要能力(通过 channel tool 的 action 参数调用):
- get_user:查询用户信息。user_id 可省略,省略时自动使用当前发送者的 open_id,因此查询“我是谁”时无需参数;查询他人时指定 user_id。可选 user_id_type,默认 open_id。
- list_users:列出部门下的用户,必填 department_id,可选 user_id_type、page_size(默认 50)、page_token。
- get_department:查询部门信息,必填 department_id。
- list_departments:列出子部门,可选 parent_department_id(默认根部门)、page_size、page_token。
使用方式:以 channel(action=...) 形式调用,例如 channel(action="get_user") 查看本人信息,channel(action="get_user", user_id="ou_xxx") 查询他人,channel(action="list_users", department_id="dept_xxx") 列出部门成员,channel(action="list_departments") 列出顶级部门。自动化原则要求:user_id 省略时自动从发送者获取,不询问用户;user_id_type 默认 open_id,不询问类型;用户说“我是谁/查看我的信息”时零参数直接调用 get_user;用户说“看看部门”时直接调用 list_departments 列出根部门,不问父部门 ID;不提供交互式菜单选项;查到用户信息后若含部门 ID,可自动查询部门详情丰富结果。
限制:所有操作安全等级为 L1 只读,无需审批。文档未提供其他限制或收费信息。