# 想做一个能联网、能上线的 AI 智能体？这套方法把套路都定好了 —— flue-framework 介绍

代码仓库：https://github.com/liangdabiao/flue-framework-skill

想做一个 AI 智能体（会自己调用工具、管理对话的 AI 助手），可市面上的框架五花八门，光是"怎么定义智能体、怎么接模型、怎么让它对外提供网页接口、怎么上线部署"就有一堆约定要记，稍不留神就报错。

**flue-framework 就是来解决这件事的。** 你告诉它想要什么样的 AI 智能体，它还你一个能跑、能联网提供接口、能部署上线的成品。它是一套帮你按固定套路把模型、会话、工具、技能、运行环境这些零件组装好的方法（可以理解为"框架"——一套现成的工作方式）。

![配图：按约定写 TS，把零件拼装成能部署的 agent](assets/flue-framework/01.png)

---

## 它到底能做什么

- 帮你用极简的方式定义一个智能体：指定用哪家模型（Anthropic、OpenAI、DeepSeek、OpenRouter 等都内置支持）、给它什么指令。
- 帮你加上自定义工具：让 AI 能发起网络请求、执行代码等，扩展它的能力边界。
- 支持两种形态：一种是对外提供网页聊天、实时推送的常驻助手；一种是跑一次就结束的自动化工作流（比如定时处理一批任务）。
- 支持子智能体：让主 AI 把任务派给专门的 AI 分头做，再汇总结论。
- 自带隔离运行环境（沙箱）、会话管理，还能强制让 AI 返回结构化的数据，方便接进你自己的系统。
- 开发到上线一条龙：开发时热更新调试、打包、以及上线部署的说明，它都帮你安排好。

![配图：createAgent 一行定义，defineTool 接工具，两种形态](assets/flue-framework/02.png)

## 怎么用

你不需要记任何命令。在 codex / workbuddy 等 agent 装好 flue-framework 技能后，直接对 AI 说话就行：

**场景 1：你想快速搭一个会讲冷笑话的 AI**
你：帮我搭一个 AI 智能体，模型用 Claude，指令是"讲一个好笑的工程师冷笑话"
AI：它按框架约定帮你把智能体搭好，能直接联网提供接口，不用你自己拼装模型、会话、工具这些零件。

**场景 2：你想要一个能联网查资料的助手**
你：给我做一个智能体，能发起网络请求去查天气，再用网页聊天的方式跟我对话
AI：它加上自定义工具让 AI 能联网，并对外提供网页聊天接口，开发时还能热更新调试。

**场景 3：你想要跑一次就结束的自动化任务**
你：帮我做一个工作流，每天自动跑一次、把结果整理成结构化数据
AI：它用框架的"工作流"形态帮你搭好，跑完就结束，并能强制返回固定格式的数据方便你后续处理。

## 谁适合用

- 想做一个能联网、能上线的 AI 智能体或 AI 产品的人（让 AI 帮你搭，不用自己死磕工程细节）。
- 需要把智能体以网页 / 接口形式对外提供、并上线部署的团队。
- 想在 DeepSeek 等兼容模型上跑 agent、又想要清晰结构的人。

## 一点说明

它是装在 codex / workbuddy 这类 AI 助手里的技能，不是单独打开的 App。你描述想要什么样的智能体，AI（带上这个技能）按框架约定帮你搭好；真正要跑起来，得有一个能加载技能、连得上模型的 AI 环境。它有两个容易踩的坑：常驻助手和工作流的写法不同，选错会报错；初始化时必须接住定义智能体的结果，不能直接传配置。具体版本与能力以项目文档为准，新版本细节可能变动。

## 闲鱼接单文案

> 以下服务展示在闲鱼 / 淘宝服务市场发布，用于承接本 skill 的定制开发订单。

**标题：TypeScript AI智能体框架开发 skill软件开发**

**描述：**

专注 AI Agent 技能（skill）定制开发，已做出基于 TypeScript 的智能体框架技能，现成作品可先看演示再下单。按固定套路把模型、会话、工具、技能、运行环境组装好：一行代码定义智能体（Anthropic / OpenAI / DeepSeek / OpenRouter 内置支持），自定义工具随意扩展，常驻网页助手和一次性自动化工作流两种形态，自带沙箱隔离、子智能体和结构化输出，开发热更新到打包部署一条龙。可按你的业务定制，全部源码交付、支持二次开发。

**服务内容：**

- 1、需求沟通梳理：先聊清楚智能体的用途、想用的模型和形态（常驻网页助手 / 跑一次就结束的工作流），列明功能清单后再动手
- 2、skill交付内容和格式：能跑、能联网提供接口、能部署上线的智能体工程：智能体定义、自定义工具、网页聊天接口或自动化工作流 + 上线部署说明
- 3、项目功能/系统开发：按你的业务定制工具、子智能体编排与部署方案，含热更新调试联调
- 4、skill源码交付：SKILL.md 技能说明 + 提示词 / 脚本 / 模板 / 工程样例组成的完整技能工程，兼容 codex / workbuddy 等 agent。全部源码 + 安装部署说明 + 使用演示，交付后可自行修改维护