Files
nexus/wiki/concepts/7-Layer-Harness-Stack.md
2026-05-03 05:42:12 +08:00

41 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: "7-Layer Harness Stack"
type: concept
tags:
- "harness-engineering"
- "agentic-ai"
- "system-design"
sources:
- "Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog"
last_updated: 2026-04-20
---
## Overview
7层 Harness Stack——production-grade AI Agent 系统的分层架构规范,从认知层到约束恢复层的完整 7 层结构。
## Structure
| Layer | Name | Core Function |
|-------|------|--------------|
| 1 | Cognition | 受限操作边界role file/job description |
| 2 | Tools | 工具输出排序/去重/token 预算截断 |
| 3 | Contracts & Interfaces | JSON Schema 边界验证,防 Schema Drift |
| 4 | Orchestration | DAG/状态机约束允许的动作 |
| 5 | Memory & State | Working Memory + Persistent State 分层 |
| 6 | Evaluation & Observation | 异构验证(规则/工具/LLM-as-judge|
| 7 | Constraints & Recovery | 幂等重试Context Reset 机制 |
## Principles
- 模型在 Harness 内部,不直接对用户或外部世界说话
- 每个边界交叉处有显式契约:严格 JSON Schema / 类型化函数签名 / 版本化 API spec
- 每一层产生可被模型以外的东西验证的输出
## Related Concepts
- [[Harness-Engineering]] — 父概念,本框架所属的工程学科
- [[Context-Reset]] — 第 7 层 Constraints & Recovery 的关键机制
- [[Sprint-Contract]] — 第 6 层 Evaluation 的关键机制
- [[Schema-Drift]] — 第 3 层 Contracts 要解决的核心问题
## Source
- [[Your-AI-Isn-t-Stupid---It-Just-Needs-a-Better-Harness--Lychee-Technology-Engineering-Blog]]