用 Agno 构建 AI Agent — 结合 Gemini 与内置工具的实战运行记录
在沙盒中安装并验证了从 phidata 更名的 Agno v2.6.17，包含 Calculator、Wikipedia、结构化输出和多智能体团队的实际执行日志。同时诚实记录了亲历的各种陷阱：output_schema 与 output_model 混淆、废弃的模型 ID、Team API 参数变更。
标签
python
18篇文章
Ollama结构化输出实战指南 — 用Pydantic安全解析本地LLM的JSON响应
将Ollama 0.3+的JSON Schema强制模式与Pydantic结合，实现本地LLM响应的类型安全解析。 实测结果：结构化输出比普通文本快6倍，JSON解析成功率接近100%。
用sentence-transformers实测RAG嵌入 — 韩语查询准确率为何下降67%
在本地安装all-MiniLM-L6-v2，直接测量余弦相似度、运行迷你RAG，并比较英语与多语言嵌入模型。 用英语优化模型构建韩语RAG系统时，准确率下降67%的实测结果与解决方案。
LlamaIndex vs LangChain vs Haystack — 2026年RAG框架实测对比
亲自安装测试了LlamaIndex 0.14、LangChain 1.3和Haystack 2.30。包含langchain-community弃用警告、代码复杂度测量和InMemory检索实际运行结果的实测比较指南。
用Ollama + FastAPI搭建本地LLM API服务器 — 从开发到Docker部署完整指南
本指南完整介绍如何通过FastAPI封装Ollama REST API，逐步构建具备SSE流式传输、健康检查、Docker Compose容器化部署的生产级本地LLM服务器，并附有Llama 3.2、Mistral等主流模型的实际运行日志与完整API调用测试示例。
AutoGen 0.7.x多智能体实战 — AssistantAgent到GraphFlow从零构建
基于AutoGen 0.7.x新API从零实现多智能体系统的实战指南。逐步运行RoundRobinGroupChat、SelectorGroupChat、GraphFlow、FunctionTool，通过真实代码对比0.2.x差异。
Claude Agent SDK 子代理编排实战指南 — 多代理并行处理完全掌握
我亲自安装claude-agent-sdk 0.2.82，实测AgentDefinition结构与ClaudeAgentOptions类型，验证编排器同时spawn三个子代理的并行模式。完整讲解通过TaskBudget控制成本上限，以及SubagentStartHookInput钩子的Python实现全流程。
Claude Agent SDK 实战指南 — 用Tool Use让AI代理真正执行任务
亲自安装anthropic 0.101.0 SDK并完整实现了tool_use代理循环全流程。本文系统介绍了从JSON Schema工具定义、多工具并发调用、错误处理策略到流式响应与成本优化，通过Python实战代码逐步详细讲解区分聊天机器人与真正AI代理的核心设计模式，附可运行代码示例与步骤说明。
用FastMCP 3.x在30分钟内构建Python MCP服务器 — 一个@tool装饰器就够了
我实际安装了FastMCP 3.2.4，用@mcp.tool()、@mcp.resource()、@mcp.prompt()装饰器构建了可运行的MCP服务器。这是一份用30行Python实现Claude Desktop和Cursor可调用的AI工具服务器的实战指南。
FastAPI + Claude API 流式生产后端构建 — SSE、重试与错误恢复实战指南
本文是面向后端开发者的FastAPI + Anthropic SDK生产级流式AI后端完整指南。涵盖SSE流式端点实现、限速指数退避重试机制、错误分类与恢复策略、令牌流优化，以及基于Docker的完整容器化部署方案，每步均附完整可运行Python代码示例，是快速掌握并部署流式AI后端的最佳实践指南。
Anthropic SDK vs OpenAI SDK 开发者体验对比 — 类型安全性、错误处理与流式模式实测
在沙箱中同时安装anthropic 0.100.0和openai 2.36.0并深入比较。类型数量408 vs 230、错误类层级、流式实现、工具调用格式、SDK专有功能——全部从代码层面分析的实战比较指南。
用uv搭建AI开发环境 — 0.87秒启动Claude SDK项目的实战指南
使用Rust编写的Python包管理器uv 0.11搭建AI SDK开发环境的完整实战指南。覆盖pip速度100倍以上的加速安装、可复现环境管理、Claude SDK项目初始化全流程，附真实运行日志，是2026年Python AI开发的首选工具链。
Anthropic Files API实战指南 — 无需重复上传PDF即可批量分析文档
通过Anthropic Files API将PDF文档上传一次、在多个请求中反复复用的实战指南。含Python SDK批量代码、与提示词缓存的成本对比、 file_id生命周期管理模式及批量分析适用场景判断。
PydanticAI实战教程 — 用FastAPI的感觉构建类型安全的AI智能体
我实际安装了PydanticAI 1.88.0，直接测试了TestModel、output_type、@agent.tool和多提供商切换。包括result_type→output_type变更等真实陷阱，以及完整的FunctionModel测试策略。
Python AI智能体库比较 — Pydantic·Instructor·Smolagents
用真实基准代码对比Pydantic AI、Instructor和Smolagents。从结构化输出、智能体架构、生产就绪度、成本效率四个维度，为您提供2026年明确的Python AI库选型决策依据。
从零构建MCP服务器 — 使用Streamable HTTP传输实现真实AI工具
使用Python FastMCP从零构建MCP服务器的实战教程。涵盖Streamable HTTP传输配置、工具实现及Claude Code集成，基于实际操作经验分享。
LiteLLM供应链攻击 — AI基础设施依赖的安全盲区
深入分析PyPI上发生的LiteLLM供应链攻击。涵盖AI工具链依赖漏洞与恶意包检测方法、供应链安全强化策略， 以及工程团队可立即应用于实务的具体防御步骤与安全检查清单。
Google Gemini File Search 5分钟构建RAG系统
2025年11月发布的Gemini File Search Tool使用指南,无需复杂RAG管道即可构建文档检索与问答系统。完全托管的RAG方案显著缩短开发时间。