为智能体系统设计可维护的文档框架，让协作与演化更透明。
Describing Agentic AI Systems with C4: Lessons from Industry Projects
- 用专门模型描述智能体、工具和交互模式
- 通过分层结构清晰呈现系统不同抽象层级
- 工业实践验证了文档对长期演进的支持力
不同领域催生不同架构风格，进而影响文档方式（如行为控制用状态模型，信息结构用ER模型）。智能体系统具有独特风格：专业智能体通过交换产物、调用外部工具、遵循重复交互模式与质量门限协同工作。当这些系统发展为长期工业解决方案时，文档必须捕捉此类核心特征，而非依赖临时代码草图或流程图。本文基于联合项目经验，提出适配该风格的文档体系：(i) 面向风格的建模词汇与若干视图，涵盖智能体、产物、工具及其协调模式；(ii) 与C4一致的分层描述技术，用于在抽象层级间组织这些视图；(iii) 工业案例与经验总结，证明该方法能生成透明、可维护的架构文档，支持持续演化。
原文摘要 · Abstract (English)
Different domains foster different architectural styles -- and thus different documentation practices (e.g., state-based models for behavioral control vs. ER-style models for information structures). Agentic AI systems exhibit another characteristic style: specialized agents collaborate by exchanging artifacts, invoking external tools, and coordinating via recurring interaction patterns and quality gates. As these systems evolve into long-lived industrial solutions, documentation must capture these style-defining concerns rather than relying on ad-hoc code sketches or pipeline drawings. This paper reports industrial experience from joint projects and derives a documentation systematics tailored to this style. Concretely, we provide (i) a style-oriented modeling vocabulary and a small set of views for agents, artifacts, tools, and their coordination patterns, (ii) a hierarchical description technique aligned with C4 to structure these views across abstraction levels, and (iii) industrial examples with lessons learned that demonstrate how the approach yields transparent, maintainable architecture documentation supporting sustained evolution.
Thank you to arXiv for use of its open access interoperability. PaperDance 不是 arXiv 官方产品；中文卡片由大模型生成，请以原文为准。