从协议、架构到生产实践：全面解析 LangChain Deep Agents 的设计理念、API、文件系统、子智能体、上下文管理与部署策略
一次寻常的重新部署，让博客发布接口全线 500——最小草稿也发不出去，但登录、列表、健康检查全是绿的。根因藏在 boto3 1.36 的一次默认值变更里：PutObject 悄悄带上了 STREAMING-UNSIGNED-PAYLOAD-TRAILER，而第三方 S3 兼容实现不认这套新编码。
给 AI Agent 调用的命令行工具，和给人用的 CLI 是两种东西。本文以 FreshAI CLI（设备码登录 + 博客草稿/发布）的真实实现为骨架，讲清非交互、stdout/stderr 分工、结构化输出、语义化退出码、幂等与「结果未知」这些设计要点，并给出避坑清单和交付自检表。
把图文内容转成口播视频的完整知识整理：图文成片/半自动流水线/全代码管线三条路线对比，口播稿的长度换算，AI 图表动画的三种做法，B-roll 素材拼接的实现原理与工具。
MCP 管 agent 连工具，A2A 管 agent 连 agent，那 agent 连前端呢？AG-UI 用一条 36 种事件的事件流补上了三层协议的最后一块。本文基于官方仓库 main@5f32a64e 与 Python SDK 0.1.22 / TS SDK 0.0.59 的源码写成，深入到中间件、事件校验器和完整运行管线。
Loki 只索引标签、不索引日志正文，LogQL 的全部语法设计都源于这个取舍。本文从一次真实的排障经历讲起，拆解选择器、流水线、解析器与指标查询，并总结把查询写快的四条原则。
以阿里云百炼 + LangChain 实际跑通的 RAG 应用为主线：文档加载、分割、嵌入、Chroma 向量库、LCEL 生成链，附 RetrievalQA 历史写法注记、进阶检索策略与评估指标
从环境变量到数据集评估：LangSmith 接入、自动追踪、@traceable、Playground、Prompt Hub 的完整上手记录（2026-09 修订环境变量与评估 API）
