跳到正文

Haonan S005-3 Agent LLD

设计或审查 Agent 的模型、工具、节点流转、上下文、权限、预算、隔离与验证;根据实际运行能力定义控制机制,交付可追溯到业务采用与结果的详细规范。

个人 Skill产品研发4 个文件浏览次数 0
开始使用

下载前阅读 SKILL.md 中的使用条件,并确认所用工具支持对应能力。

输入资料
生成编排 LLD 前核查以下要素。关键权限或完成条件未知时暂停相关设计决策,其他依据充分的部分继续执行;已经确认的要求直接继承。 【SKILL02】PRD 核心业务验收:提取业务闭环与 Agent 动作边界。 【SKILL03】PROTOTYPE 交互映射:提取多端并发预期与状态流转推送要求。 【SKILL04】HLD 架构基座验收:核对物理隔离策略与网关选型。 【SKILL05-1-LLD-DATA】数据与检索契约握手:[核心握手] … 阅读本节完整说明
交付内容
按以下四阶段保留完整设计;用户选择交互评审时逐阶段确认,完整授权下连续执行,必要业务决策单独确认。 第一阶段 (Economics & Context):输出 【第 1 至 2 节:6 层治理全景图与上下文缓存经济学篇】。询问:“上下文分层与缓存排列已锁定,是否符合 Token 预算?” 第二阶段 (Actions & Control):输出 【第 3 至 4 节:MCP/工具设计与 Hooks 运行时治理篇】。询问:“细粒度工具接口与… 阅读本节完整说明
环境与依赖
生成编排 LLD 前核查以下要素。关键权限或完成条件未知时暂停相关设计决策,其他依据充分的部分继续执行;已经确认的要求直接继承。 【SKILL02】PRD 核心业务验收:提取业务闭环与 Agent 动作边界。 【SKILL03】PROTOTYPE 交互映射:提取多端并发预期与状态流转推送要求。 【SKILL04】HLD 架构基座验收:核对物理隔离策略与网关选型。 【SKILL05-1-LLD-DATA】数据与检索契约握手:[核心握手] … 阅读本节完整说明
  1. 获取完整包,保留配套文件的目录结构。
  2. 按照原文准备所需工具、依赖与输入资料。
  3. 阅读对应使用步骤与输入输出说明,在自己的环境中验证结果。

使用提示摘自原文,配套文件保留来源版本;实际运行条件以各包说明为准。

正文

获取原文件

references/agent-contract.md

Agent 注册表

agent_id,goal,non_goals,input_schema,output_schema,allowed_tools,data_scope,budget,termination,escalation,owner

工具注册表

tool_id,purpose,input_schema,output_schema,permission,side_effect,idempotency,timeout,error_codes,audit,approval

工具错误应稳定、可恢复且不泄露敏感实现细节。

能力与采用

每项能力记录 requirement_id,entry,provider,model,prompt_version,tool_adapter,knowledge_version,context_identity,output,adoption,business_result,acceptance_id。 目录登记、连接、执行、效果评测和业务采用分别验证。配置发布必须说明运行时读取来源及版本。 HOSTED_API 验证真实 API 请求与数据范围;SELF_HOSTED 增加制品、引擎和资源要求。适用门槛具有需求或风险依据。

状态机

至少覆盖:READY、PLANNING、EXECUTING、WAITING_APPROVAL、RETRYING、COMPLETED、FAILED、CANCELLED。按项目裁剪,不强制名称一致。

每条转换记录:事件、守卫条件、动作、预算消耗、验证器、失败去向。

涉及后端任务时,节点状态映射到后端定义的任务 ID、事件和终态,明确取消传播、超时、重复请求与结果采用条件。后端任务管理与 Agent 内部编排按 设计责任 维护各自规范;S006 使用 状态与分支检查 核查边界,S009 验证结果进入实际业务的路径。

上下文与记忆

  • 固定规则、任务输入、检索证据、工具结果、对话历史分层。
  • PII/PHI/秘密最小化、保留、删除、跨租户隔离。
  • 压缩或摘要保留事实来源和未决状态,不保留隐式推理。
  • 缓存键包含影响行为的版本;动态能力变化有失效策略。

预算与终止

max_wall_time,max_turns,max_tool_calls,max_retries,cost_or_token_budget,no_progress_rule,cancel_behavior

Evals

eval_id,risk,scenario,dataset_version,metric,threshold_source,judge,variance_policy,release_action

区分确定性验证、模型评测、人工评审和线上监控。

Haonan S005-3 Agent LLD · 原理图

查看原图
Haonan S005-3 Agent LLD 原理图

CONTACT HAONAN

联系haonan

医疗 AI · 产品与独立开发

刘浩南

关注医疗 AI 从 demo 到真实落地,聚焦产品化、商业化与院内工作流效率提升。

12年医疗产研经验,大湾区头部医疗AI公司前产品总监,独立开发者

医疗 AI 产品化医疗 AI 商业化院内工作流效率
刘浩南的微信联系二维码
微信扫一扫,联系 haonan