跳转到主要内容

10 含有标签「documentation」

Posts tagged "documentation" on TianPan.co.

查看所有标签

·tian

你的 Agent 从未读过的 ADR

编程智能体正以机器速度重新审视每一个未记录的决策。本文探讨了为什么架构决策记录(ADR)已从官僚式的点缀演变为集群基础设施,如何将它们接入智能体上下文,以及无人提醒你的过时 ADR 失效模式。

ai-agents
architecture
documentation
agentic-engineering
·tian

模型已经在直接与你的客户对话了

AI 助手正在那些你永远看不到的对话中引用你过时的报价、推荐已废弃的端点,甚至还在推销竞争对手。了解如何像对待生产环境一样监控模型的回答,并交付机器可读的真实源数据。

insider
ai
llm
devtools
+2
·tian

文档复兴:你的 README 是 Agent 的核心上下文界面

二十年来,文档一直是美好愿景的坟墓。编程 Agent 扭转了这一局面:你的 README 现在是可执行的上下文,其质量直接决定了任务的成败。

insider
ai-engineering
documentation
coding-agents
+2
·tian

Prompt 即文档:当系统 Prompt 成为唯一可信的交付物时

当 PM、支持团队和销售开始通过阅读系统 Prompt 来了解产品功能时,这既是一种褒奖,也是一种结构性失效。本文将介绍如何保留有效的部分并修复其余问题。

insider
ai-engineering
prompt-engineering
product-management
+1
·tian

过时的文档,肯定的错误答案:AI 帮助中心里隐藏的失效模式

当 RAG 系统检索到过时的上下文时,幻觉率会飙升 6 倍。如何将文档新鲜度视为一个工程问题——通过 TTL 过滤、时间重排序、过时评分以及在发布后保持 AI 帮助中心准确性的运营模型。

rag
knowledge-base
ai-reliability
documentation
+1
·tian

AI 文档债:随机系统是如何破坏你的技术知识库的

AI 功能文档的腐化速度比任何其他技术债都要快 —— 而且其方式往往令团队措手不及。本文将探讨为什么确定性的文档模式在概率系统中会失效,以及你应该转而编写什么样的内容。

ai-engineering
llm
technical-debt
documentation
·tian

你的 AI 功能说明文档是运行时依赖,而非营销文案

当 Prompt 发生变化而帮助中心文章没有更新时,你的 AI 功能信任契约就会悄然失效 —— 而 Prompt 仓库可以预测这种差距。

ai-engineering
documentation
governance
prompt-engineering
+1
·tian

Wiki 迎来了第二位租客:为什么面向 AI Agent 的文档与面向人类的文档截然不同

工程团队正悄悄地为其内部文档积累第二批受众——即每位开发者的 AI 助手。如果团队只为其中一类读者编写文档,那么提供给另一类读者的内容注定是残缺的。

ai-engineering
documentation
developer-experience
agents
+1
·tian

这个提示词去年还有意义:AI 系统中的机构知识衰减

当构建 AI 系统的工程师离职后,系统不会立即崩溃——它会缓慢腐烂。以下是如何通过提示词原理文件、评估来源日志和护栏理由注释来防止衰减。

insider
ai-engineering
prompt-engineering
documentation
+1
·tian

记录概率性功能:模型行为与开发者引导之间缺失的一层

由 AI 驱动的功能没有稳定的输入输出契约可供记录。本文介绍了如何为每次表现都不同的功能编写 API 文档、变更日志和运维手册 —— 利用行为包络(behavioral envelopes)、版本控制纪律和可观测性作为动态文档。

llm
documentation
ai-engineering
api-design