用工单周报理解业务接入

从一项可核对的工作定义接入

假设企业希望员工查询本人负责项目的工单，统计完成情况，并生成周报。这是说明职责的教学示例，不表示某套真实工单系统已经完成接入。先确定输入字段、时间口径、数据范围和输出，再决定哪些部分由蜂巢、业务后端和员工完成。

参与方	准备什么	继续负责什么
企业管理员	登记工单系统及非敏感公共属性，配置身份客户端并分配系统与资源	平台账号、资格、模型和运行管理
业务团队	账号管理页、业务网关、数据查询与权限检查	业务用户关联、项目范围和操作结果
Skill维护者	查询与统计方法、脚本、错误处理及结果格式	请求准确性、业务幂等和方法更新
员工	关联业务账号，提出清楚的任务并检查报告	输入选择、结果核对和个人资产管理

先确认员工是谁，再决定能看什么

员工从蜂巢进入业务方账号管理页面。业务方通过OIDC授权码流程与PKCE确认蜂巢身份，校验返回信息，再由自己的页面处理账号关联。不能仅因一次登录成功，就静默把员工关联到另一个业务账号。

蜂巢系统资格和业务项目权限是两个条件。业务方应明确处理“尚未关联账号”和“账号没有项目权限”，而不是让员工反复输入蜂巢密码。统一身份也不等于蜂巢已经支持企业上游SSO登录或跨系统单点退出。

查询工单时怎样传递身份

1. 员工在相应业务范围中提出周报要求，任务核对当前系统与资源分配。
2. Skill读取该系统公共属性，按需取得限定目标系统的短期蜂巢Token。
3. 请求通过认证头发送给工单业务网关，不把Token放进地址、报告或普通日志。
4. 网关逐次在线核验有效性与目标系统，再按自身账号关系和项目权限查询。
5. Skill核对响应，把缺失项写明，生成独立报告；员工检查统计与待办。

安装Skill不自动授予系统资格，获得系统资格也不自动开放全部企业Skill、MCP和面板。公共属性保存成功，只说明平台登记完成，不能证明真实认证和业务查询已经联通。

面板和后台调用怎样加入

工单列表适合做成业务面板，让员工直接筛选和查看。已保存面板无需模型或员工运行环境即可打开，业务请求由浏览器直连业务API。业务方要为相应跨域请求配置合适条件，并继续校验身份和权限；聊天预览也可能产生真实业务操作。

如果工单后端希望调用蜂巢分析资料，可由后端保存开放API Key。Key固定执行员工、引擎和范围，不能让请求任意切换身份；业务后端还要先检查自己用户的数据权限。长任务可以异步提交后查询，停止轮询不会取消任务。

首次联调先使用合成资料，分别验证身份、账号关联、权限拒绝、正常查询和失败处理。任务超时或回复丢失时先查状态与已有业务结果，再决定重试，不自动换请求标识重新执行。整体执行过程见任务生命周期。