·tian
你的智能体读不懂的弃用通知
智能体不会阅读更新日志或 Sunset 响应头。本文将探讨为什么工具弃用对大语言模型智能体来说会静默失败，以及如何对工具契约进行版本化，从而让模型能够真正接收到通知。
insider
ai-agents
api-design
tooling
+2·tian
当你最大的客户端是 Prompt 时，如何弃用 API
AI 智能体不会阅读更新日志 —— 它们对你 API 的认知被冻结在 Prompt、工具 schema 和训练数据中。本文将探讨为什么关闭 v1 版本会导致重试风暴而非迁移，以及如何通过适配器、Sunset 响应头和智能体可读的错误信息来解决这一问题。
insider
api-design
ai-agents
versioning
+1·tian
AI 更新日志问题：为什么你的提示词更新正在破坏其他团队的工作
提示词编辑、模型升级和工具架构调整会在不改变代码的情况下改变行为。这里有能让消费团队保持畅通的更新日志格式和版本控制契约。
insider
ai-engineering
prompt-engineering
versioning
+2·tian
AI 驱动端点的 API 设计：为不可预测性建立版本控制
当你升级 API 背后的 AI 模型时，虽然 JSON 架构保持不变，但语气、拒绝行为和推理风格都可能发生变化。本文介绍了快照固定、结构化输出、行为包络和阴影部署等模式，这些模式能够确保 AI 端点对调用者保持稳定。
api-design
llm
versioning
mlops
·tian
智能体行为版本控制：为什么 Git 提交无法捕获真正的变化
Git 提交和语义版本控制无法捕获 AI 智能体行为的实际变化。了解行为快照、翻转中心门控和轨迹测试套件如何定义非确定性系统中'版本'的真正含义。
ai-agents
versioning
mlops
deployment
+1·tian
LLM 输出即 API 契约：为下游消费者版本化结构化响应
当多个服务依赖 LLM 结构化输出时，模型升级会悄无声息地破坏下游消费者。本文解析模式漂移与行为漂移的成因，以及在部署前捕获破坏性变更的版本化与契约测试模式。
insider
llm
production-ai
api-design
+3