集成生命周期¶
完整的 Agent 产品体验从获得可信能力开始,到撤销与退役结束。安装、启用、连接、授权和任务成功分别具有状态,不能合并成一个“已连接”标记。
总流程¶
flowchart TD
D[发现发行者和分发入口] --> I[核对并安装精确制品]
I --> E[按宿主规则启用并发现组件]
E --> C[建立本地或远程连接并鉴别来源]
C --> A{需要远程受保护资源}
A -->|是| O[对应身份与最小授权]
A -->|否| L[核对本地用户 目录与会话]
O --> R[定位当前范围与对象]
L --> R
R --> X[执行、观察、核验或原操作恢复]
X --> F[任务结果与用户反馈]
F --> V[迭代:合同、方法、UI 与测试]
V --> P[验证、审核与发布新候选]
P --> U[升级、重新发现及迁移]
U --> C
E --> Z[禁用、撤权、卸载或退役]
X --> Z
Z --> K[核对在途操作和保留义务]
状态分离¶
| 状态面 | 例子 | 权威来源 |
|---|---|---|
| 制品 | 未安装、已校验、已安装、升级失败 | 包管理器/宿主与摘要 |
| 启用 | 已禁用、待信任、已启用 | 宿主策略 |
| 连接 | 未连接、连接中、不可达、可用 | 载体握手和健康状态 |
| 身份 | 未认证、已认证、过期、撤销 | 身份与资源服务 |
| 授权 | 缺 scope、缺业务角色、当前获权 | 资源服务最终判断 |
| 任务 | blocked、pending、unknown、终态 | 原操作与领域事实 |
| 采用证据 | 文档、参考实现、已测、已发布 | 适用制品和任务记录 |
例如“已经登录,为什么还要求登录”:先判断现有网页会话是否仍有效、工具连接是否有自己的身份受众,以及是否只是缺业务权限。不能用重复登录解决所有拒绝,也不能复制浏览器 Cookie 给另一载体。
阅读路径¶
独立本地不要求为了安装或创建目录而先建立远程账号。项目选择、不同OS默认目录和无界面路径见本地工作区实践;是否启用远程能力按任务判断。