独立开发者
开发者维护一个或多个 Agent,通过统一标识对外提供服务。端点变化时更新登记,调用方按标识重新寻址,不需要开发者逐个通知调用方修改地址;调用记录按 Agent 分开,出现问题时容易定位。
一个开发者可以登记多个 Agent,每个 Agent 使用独立标识与独立凭据。按用途拆分后,停用或调整其中一个不会影响其他服务;授权范围按调用方分别确认,避免一个凭据覆盖全部能力。
调用方按标识访问,不需要了解开发者的部署位置。开发者调整内部结构时,只要端点与登记一致,调用方的接入方式不变。
小型团队
团队把检索、生成、通知等 Agent 分别登记,按能力说明区分用途。调用方按能力筛选,按授权范围调用,减少口头对接与手工配置;成员变动时更新联系人,登记内容与维护责任保持一致。
端点迁移时由维护人提交变更,调用方继续按标识访问,不必改动调用方配置。团队可以按 Agent 分配凭据,出现异常时单独停用,不影响其他服务。
企业内部
企业内部系统调用 Agent 时,先确认身份与授权,再取得端点。调用记录用于核对请求与排查问题,不记录业务正文;内部审计需要时,按记录编号与时间范围查询,不导出业务内容。
内部多个系统共用 Agent 时,按系统分配调用方标识与凭据,出现问题可以定位到具体调用方,不影响其他系统;授权范围按系统职责划分,避免权限过宽。
内部系统之间的调用关系较多时,按系统与用途分别登记,避免一个标识承担过多职责。记录按 Agent 与调用方分开,核对时可以缩小范围。
多 Agent 管理者
同一开发者管理多个 Agent 时,按主体和用途分别登记标识,按用途区分能力与端点。调用方按标识找到目标,不需要开发者逐个通知地址。
Agent 数量较多时,按主体和用途分组登记,授权范围分别确认,避免一个凭据覆盖过多 Agent,也便于单独停用。开发者可以按记录核对调用来源。
开发者维护登记内容,不介入 Agent 的业务处理。需要变更端点或授权时,由对应主体提交,按登记规则核对。
共同做法
四类接入方的差别在规模与分工,登记、寻址、鉴权与记录的环节一致。按统一做法办理,调用方不必了解每个 Agent 的内部部署,只需按标识与授权范围调用。
| 环节 | 做法 | 带来的结果 |
|---|---|---|
| 登记 | 一次提交能力、端点与授权范围 | 获得稳定标识 |
| 寻址 | 调用方按标识取得当前端点 | 端点调整不必逐个通知 |
| 鉴权 | 凭据证明调用方身份 | 调用方可被识别 |
| 记录 | 保存记录编号、目标、状态与时间 | 问题可核对 |