·tian
Agent 的端口与适配器架构：为什么你的工具 Schema 应该比供应商更长寿
供应商迁移往往在工具层而非提示词层崩溃。将工具 Schema 视为你拥有的端口 —— 为每个供应商和后端提供轻量级适配器 —— 你将免费获得确定性的 Agent 测试。
insider
ai-agents
architecture
tool-design
+1·tian
Postel 法则在工具边界是一种负担
宽容的解析器通过强制转换“差一点就对”的工具调用，会误导 AI Agent 认为草率的调用也是可行的，从而在循环中累积错误。带有清晰示例且包含错误的严格验证是一种循环内训练信号 —— 本文将探讨何时应保持严格，以及 Postel 法则在何处依然适用。
insider
ai-agents
tool-design
api-design
+1·tian
你的 Agent 读不懂的生产日志
把 agent 接入日志系统只是给了它访问权,不是理解力。真正的集成工作,是教它你的数据叫什么名字。
ai-agents
observability
logging
tool-design
+1·tian
工具的默认参数其实是伪装的策略决策
你的 Agent 跳过的每一个可选参数都会继承你选择的默认值。这些默认值是未经审计的策略 —— 它们在追踪中不可见，在评审中也无人负责。
ai-agents
tool-design
agent-safety
observability
·tian
原本运行良好的工具，直到两个智能体同时调用它
智能体工具通过了单调用者测试，但在第二个智能体出现的那天崩溃了。本文将探讨为什么并发漏洞在结构上对串行评估是不可见的，以及幂等性、锁定和负载测试如何修复这些问题。
insider
ai-agents
concurrency
idempotency
+2·tian
分页是一项工具目录规范：为什么智能体在处理列表返回时会耗尽上下文
返回无界列表的工具会将智能体变成函数调用时代的 SELECT * 反模式。分页是一种降级原语 —— 应该将其作为工具目录中的规范，而不是逐个工具去决定。
ai-agents
tool-design
context-engineering
mcp
+1·tian
无结果并不代表不存在：为什么智能体将检索失败视为证明
那些回答“无结果”的智能体很少是在对现实世界做出陈述。它们只是将一个空数组描述为一种证明——而这正是隐性生产事故产生的原因。
ai-agents
rag
tool-design
retrieval
+1·tian
为智能体编写工具：ACI 与 API 同等重要
你如何为 AI 智能体设计工具 —— 包括 Schema、描述、返回值和错误信息 —— 直接决定了智能体的可靠性。本指南将教你如何像对待任何生产级 API 一样严肃地对待 “智能体-计算机接口” (ACI)。
ai-agents
tool-design
llm-engineering
function-calling