配置飞书账号集成
企业以飞书作为身份源时，若手动创建 AgentCore 员工账号，成员新增、信息变更或离职后还需逐个维护。配置飞书账号集成后，企业成员可使用飞书扫码登录 AgentCore，飞书通讯录中的用户信息可自动同步，无需手动创建用户，即可实现成员统一认证和自动化用户管理。
飞书账号集成包含以下能力，可按需选择配置范围：
适用范围与限制
开始配置前，确认满足以下条件并知悉相关限制：
拥有飞书开放平台开发者账号，能够创建企业自建应用并申请应用权限。
AgentCore 中选择的同步范围不能超出飞书应用的授权范围。
缩小同步范围不会自动清理已导入的用户。
飞书企业自建应用仅供本企业内部使用，发布需经企业管理员审核。账号没有管理员权限时，需提前联系管理员协助。
同步人数受容量上限约束，规划同步范围时需一并考虑：
当前账号集成的飞书应用最多支持 100 个用户，超出后账号集成将失败。成员同步人数同时受 AgentCore 当前账号及 Workspace 的配额限制，以实际生效配置为准；超过限制时，可缩小同步范围或申请调整配额。
配置飞书应用权限
在飞书开发者后台为应用配置权限。配置 AgentCore 控制台的飞书集成前，需先完成本步骤。
登录飞书开放平台，单击右上角的开发者后台。尚未创建应用时，在企业自建应用页签下单击创建企业自建应用，在创建企业自建应用对话框填写应用名称、应用描述和应用图标，然后单击创建；已有应用时，在企业自建应用页签下选择目标应用。
在应用的左侧导航栏，选择开发配置 > 权限管理。
开通下表全部权限。权限缺失会导致登录失败或同步不生效。
权限名称
权限标识
获取用户基本信息
contact:user.base:readonly获取用户 User ID
contact:user.employee_id:readonly获取通讯录基本信息
contact:contact.base:readonly获取部门基础信息
contact:department.base:readonly获取用户受雇信息
contact:user.employee:readonly获取用户组织架构信息
contact:user.department:readonly获取通讯录部门组织架构信息
contact:department.organize:readonly上述权限的权限类型均为应用身份。
确认各权限的权限状态列显示为已开通。
确认可访问的数据范围列。该列控制应用能读取的通讯录范围，默认与应用的可用范围一致；如需调整，单击该列的配置。通讯录接口的权限范围应覆盖需要同步的部门和成员，如需读取完整组织架构，可设置为全体员工。
发布应用版本。
发布应用版本
本节为被多处引用的公共子流程：在飞书开放平台修改权限、安全设置和事件与回调后，均需发布应用版本才能生效。
单击应用页面顶部提示条的创建版本，或在左侧导航栏选择应用发布 > 版本管理与发布后创建版本。
配置以下参数。
参数
说明
应用版本号
必填。页面会显示上一个版本号，按需递增。
更新说明
必填，最多 500 个字符。
可用范围
所有员工。如仅面向部分成员，需确保可用范围覆盖需要登录和同步的成员。
确认权限变更区域列出的内容无误后，提交发布。页面提示本次发布免审核，提交发布后即可上线使用时，提交后立即生效；否则需等待企业管理员审核通过。
发布完成后，应用页面顶部会显示当前修改均已发布。
配置飞书登录
从飞书应用中获取 App ID 和 App Secret，在 AgentCore 控制台完成配置，并把重定向 URL 注册到飞书应用。
登录飞书开放平台，单击右上角的开发者后台，在企业自建应用页签下选择目标应用。
在应用的左侧导航栏，选择基础信息 > 凭证与基础信息。
在应用凭证区域，记录 App ID（以
cli_开头）和 App Secret。App Secret 默认隐藏，单击右侧的眼睛图标显示。在AgentCore 控制台左侧，选择账号集成 > 飞书。
在应用配置区域，填入获取的 App ID 和 App Secret，单击保存配置，等待配置完成。保存配置后如需导入成员，继续完成配置飞书应用权限。
在登录设置区域，启用飞书扫码登录。
复制 AgentCore 提供的飞书登录回调地址（重定向 URL）。
在飞书应用的左侧导航栏，选择开发配置 > 安全设置。
在重定向 URL页签下，将飞书登录回调地址粘贴到输入框，然后单击添加。需要一次维护多个重定向 URL 时，单击批量修改。
发布应用版本，操作方法参见配置飞书应用权限。
配置飞书通讯录同步
本节把飞书通讯录中的成员导入 AgentCore。仅需批量导入现有成员时，完成配置飞书应用权限即可；如需在飞书成员新增、信息修改或离职后自动更新 AgentCore 用户，还需完成配置飞书应用权限。
配置成员同步
在 AgentCore 飞书账号集成页面设置同步范围，并执行成员同步。
在设置同步范围区域，选择全部同步或按部门同步。
全部同步：同步飞书应用已授权范围内的全部成员。
按部门同步：展开部门树，勾选需要同步的部门，将同步所选部门的直属成员及其所有子部门成员。
保存同步范围，等待配置完成。此操作仅保存同步范围，不会立即执行成员同步；首次导入成员或扩大同步范围后，还需单击执行同步。缩小同步范围不会自动清理已导入的用户。
单击执行同步，等待任务完成后，在用户页面查看同步的成员。
配置增量同步
如需在飞书成员新增、信息修改或离职后自动更新 AgentCore 用户，还需配置增量同步。
在飞书应用的左侧导航栏，选择开发配置 > 事件与回调，从加密策略获取加密密钥（Encrypt Key）和签名验证 Token（Verification Token）。获取后先不要保存飞书侧的回调配置，待两项填入 AgentCore 并保存后再返回飞书保存。
返回 AgentCore 飞书账号集成页面，启用通讯录自动同步，填入对应的加密密钥和签名验证 Token，保存并等待配置完成。
复制 AgentCore 提供的同步回调地址。
返回飞书应用的事件订阅配置，在回调配置页签将订阅方式设置为将回调发送至开发者服务器，填入同步回调地址并保存，确认地址校验通过。飞书页面默认推荐使用长连接接收回调，此处请勿选择该方式。
添加以下成员变更事件，并按飞书页面提示开通对应权限。
事件名称
事件类型
员工入职
contact.user.created_v3员工信息被修改
contact.user.updated_v3员工离职
contact.user.deleted_v3部门新建
contact.department.created_v3部门信息变化
contact.department.updated_v3部门删除
contact.department.deleted_v3发布应用版本，操作方法参见配置飞书应用权限。
验证飞书登录与成员同步
完成上述配置后，验证飞书登录与通讯录同步是否生效。
打开 AgentCore 的登录地址，在登录页选择飞书登录入口，使用飞书扫码登录。
完成飞书认证与授权。浏览器跳回 AgentCore 并提示登录成功，随后进入 AgentCore 的 Web 聊天页面，说明飞书登录配置已生效。
已执行成员同步时，在用户页面确认已显示从飞书同步的成员；按部门同步时，检查所选部门及其子部门的成员是否已导入。
已配置增量同步时，通过飞书管理后台新增测试成员或修改测试成员信息，不手动执行同步，等待后检查 AgentCore 用户页面的对应变化。