工作流与扩展总览

当你的应用开始接触外部世界，或者控制流本身变复杂时，就会进入这一章。

TIP

从这一章开始，默认思路建议切换到 Async First。尤其是 Tools 流式回传、instant 结构化流式输出、FastAPI 服务暴露，以及 TriggerFlow 的 runtime_stream / async_emit(...) 组合，都更适合异步接口。

适合什么时候读

模型需要调用工具、搜索、浏览、命令或 MCP Server
你要把 Agently 暴露成 Web 服务
你需要知识库 / RAG
你遇到了显式流程、并发、等待恢复问题

你会学到什么

哪些问题属于扩展能力，哪些问题已经升级成工作流编排
Tools、MCP、KB、FastAPI、TriggerFlow 分别解决什么问题
如何从请求层平滑升级，而不是一下子跳进过度设计

选型图

分块阅读

Tools

适合：

搜索、浏览、命令执行
工具日志与工具回路控制

入口：

工具系统总览

MCP

适合：

想把现成 MCP Server 直接接进 Agently

入口：

MCP 工具接入

知识库 / RAG

适合：

文档检索、知识问答、引用来源返回

入口：

知识库 / RAG

FastAPI

适合：

直接暴露 HTTP、SSE、WebSocket 接口

入口：

FastAPIHelper 集成

TriggerFlow

适合：

多阶段执行
分支与并发
runtime stream
等待、恢复、execution save/load
async chunk 内消费模型结果并继续派发

入口：

常见误区

只是要查一个外部接口，却直接搭一个完整工作流。
知识库还没理清数据边界，就先把检索结果混在 Prompt 和业务逻辑里。
想做 API 暴露时重复造一套流式协议，而不是先看 FastAPIHelper。

下一步去哪

要先学 Tools，继续看工具系统总览
要先学 KB，继续看知识库 / RAG
要确认是否已经超出请求层，继续看 TriggerFlow 概览
要进入工程落地推荐路径，先看 Async First 实践

工作流与扩展总览 ​

适合什么时候读 ​

你会学到什么 ​

选型图 ​

分块阅读 ​

Tools ​

MCP ​

知识库 / RAG ​

FastAPI ​

TriggerFlow ​

常见误区 ​

下一步去哪 ​

相关案例 ​

Related Skills（可选） ​