# @fastagent-sh/fastagent 中文文档

规范地址：https://npmcn.com/package/%40fastagent-sh/fastagent/

版本：0\.30\.3
npm 元数据更新时间：2026-11-09T04:29:41.345Z
中文译文更新时间：2026-11-14T10:57:36.441Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fastagent-sh/fastagent
原文对照：https://npmcn.com/package/%40fastagent-sh/fastagent/?lang=original
项目主页：https://fastagent.sh/
源码仓库：https://github.com/fastagent-sh/fastagent

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.4 MB，547 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.15\.0
- 运行依赖：19 个
- 首次发布：2026-07-10T10:35:55.011Z
- 最新版本发布：2026-11-09T04:29:40.981Z
- 近 30 天下载量：3087（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 33 个）

## 中文简介

维比先. 然后FastAgent:将本地代理目录变成你的应用程序中的活服务,在Telegram,Slack,Feishu,或任何频道后.

## 安装

```sh
npm install @fastagent-sh/fastagent
```

也可以使用：`pnpm add @fastagent-sh/fastagent`、`yarn add @fastagent-sh/fastagent`、`bun add @fastagent-sh/fastagent`

## README

[![FastAgent — Vibe first. Then FastAgent. An agent directory becomes a live service in your app, in Telegram, in Slack, or any channel.](https://raw.githubusercontent.com/fastagent-sh/fastagent/main/assets/hero.png)](https://fastagent.sh/)

[![CI](https://github.com/fastagent-sh/fastagent/actions/workflows/ci.yml/badge.svg)](https://github.com/fastagent-sh/fastagent/actions/workflows/ci.yml) [![npm version](https://img.shields.io/npm/v/@fastagent-sh/fastagent.svg)](https://www.npmjs.com/package/@fastagent-sh/fastagent) [![license](https://img.shields.io/npm/l/@fastagent-sh/fastagent.svg)](https://github.com/fastagent-sh/fastagent/blob/main/LICENSE) [![node](https://img.shields.io/node/v/@fastagent-sh/fastagent.svg)](https://nodejs.org/) [![built with pi](https://img.shields.io/badge/built%20with-pi-0b7285.svg)](https://pi.dev/) [![GitHub stars](https://img.shields.io/github/stars/fastagent-sh/fastagent?style=social)](https://github.com/fastagent-sh/fastagent/stargazers) [![follow @kid7st](https://img.shields.io/badge/follow-%40kid7st-000?logo=x)](https://x.com/kid7st)

建造在 [![pi](https://pi.dev/logo-auto.svg)](https://pi.dev/) \- 引擎盖下的代理控制器和多提供者 LLM API

文件定义的代理目录可以成为活服务. FastAgent将其取出终端,并服务于你的下一台/Astroapp,Telegram,Slack,Feishu,在时钟上,或在自己频道后.

离开终点站 成为现场服务.

-   **添加到您的应用程序中** - 一条路,你的认证,你的数据库,你的宿主.
-   **运行它作为现场服务** ——Telegram,Slack或Feishu bot,webhook处理器,调度,或自定义频道.

FastAgent不是一个新的代理授权DSL. 您带来了现有的定义和工程布局; FastAgent 提供了周围的可用的运行时间和适配器 .

![Three acts in one terminal: a coding agent vibes a support agent into a directory; fastagent dev serves it live, answering a Telegram message and a Slack mention and firing a daily schedule; fastagent deploy fly --run ships it to a live URL.](https://cdn.jsdelivr.net/gh/fastagent-sh/fastagent@main/assets/demo.svg)

## 为什么快速代理

编解码器使得它变得便宜 以显示有用的代理目录。 困难的部分是下一步: 本地代理住在终端, 但真正的服务接受webhooks, 加入聊天,运行在时钟上, 并保持他们的对话 通过重启.

FastAgent是本地代理目录中缺失的用于直播服务的桥梁.

## 特征

-   **Vibe先行——代理是自己的目录.** A 类 `SYSTEM.md` 快速,可再使用的技能,和 TypeScript 工具保持为您检查,编辑和承诺的文件——没有新的DSL,没有框架重写. 它所执行的项目被宣布为它的内容,它读取并修改,但从未成为它定义的一部分.
-   **海峡报.** 提供与Telegram bot,Slack应用,Feishu或Lark bot,或你自己的适配器相同的代理:经核实的webhooks,流回,群相知.
-   **默认持久.** 每一次谈话都生活在实例的存储中,一个被接受的消息在重启后得到回复. 建于开源 [毕](https://github.com/earendil-works/pi) 耐用绳子.
-   **模型,工具与技能.** 任何模型提供者(OpenAI、Anthropic、Google,.)通过OAuth或API密钥,加上代码中自己的提供者;输入工具在 `src/tools/` (TypeBox - 验证); 代理技能随需要加载.
-   **App嵌入——你的堆栈,我们插入.** 在您自己的进程内打开代理并像任何函数一样称呼它, 在您的认证后, 使用您的数据库和下面; 在您的 Next / Astro / Hono / Bun / Node app中以一个处理器挂载它的频道 。 FastAgent用你的应用编曲,从不拥有.
-   **随处部署.** 没有应用程序构建步骤——目录是可部署单位. `fastagent deploy docker|fly|railway|agentcore` 生成容器 + 目标配置和运行本(`--run` 推动它完成)。 本地多克获得用户拥有的Compose + 耐用状态; AWS Bedrock Agent Core 获得一高一高的CloudFormation地貌(webhooks通过转发器Lambda,调度通过EventBridge). 持久的入侵仍然是你的.

## 设计哲学

FastAgent是围绕一个小型的服务合同,应用自主的运行时关切,打出分界线,以及可堆肥的适配器而建造的.

-   **一个API, 正在进行中并超过 HTTP** - 那个 [API探员](https://npmcn.com/package/%40fastagent-sh/fastagent/docs/SPEC.md) 每一个频道,时间表和应用程序的呼叫, 以及一个程序调用一个部署的代理.
-   **注册运行时间** ——不接收您的授权,数据库,路线或部署.
-   **已打入边** ——打字工具,明确事件,边界验证.
-   **代理本地形状** ——目录为可部署单位,每一次检查都是一个编码代理可以运行的命令.

读取 [设计原则](https://fastagent.sh/docs/principles/) 说明理由.

## 我们没有建造的东西

FastAgent 留下一个小服务层,所以它从来不支配你的堆栈. 能力 其他代理框架烘烤到一个平台, 我们留给你的应用程序,你的下下文, 或代理本身—— 组成而不是锁定.

-   **无站台可移.** 没有仪表盘,没有控制飞机,没有运行时间你部署 _输入_ ——在本地运行,嵌入到你的应用程序中,或者将目录运送到任何地方.
-   **没有新格式或 DSL .** `AGENTS.md`, Agent Switch, TypeScript 模块 – FastAgent 消耗你已经使用的标准而不是平行的生态系统.
-   **没有工作流程引擎 .** 代理决定自己的步骤;对于确定性的多步管弦,从自己的队列或工作流程发送消息.
-   **一个钥匙,没有认证系统.** 服务代理人回答其渠道,每个渠道都验证其平台,并给出 `FASTAGENT_API_KEY`, API 下方 `/v1`: 整个实例的一键, 保存在服务器上, 除了它的客户之外, 所有人都无法进入. 用户,角色和每会次访问都是你的应用程序,在它的前面.
-   **没有模型或云锁入.** 任何提供者 pi-ai 支持, 或您的; 任何运行容器的主机 .

## 安装

开始于 [代理开发指南](https://github.com/fastagent-sh/fastagent/blob/main/docs/ai-start.md),用于人类和编码代理的作者入口。 它涵盖了责任,TypeScript工具,校验,渠道,调度,和部署. FastAgent 仓库 `AGENTS.md` 是给维护者的.

要与 Claude Code, Codex, Cursor 或者另一个编码代理商合作, 粘贴 :

> 读取 [https://fastagent.sh/ start.md 页面存档备份,存于互联网档案馆](https://fastagent.sh/start.md) 并在这个项目中建立一个代理.

对于人类:

```bash
npm i -g @fastagent-sh/fastagent   # CLI: fastagent init/dev/start/...
npm i @fastagent-sh/fastagent      # library API for embedding or code tools
```

要求数 **节点 24.15** 或者说 **1.4号舱**都由代理仓库设置, `node:sqlite`:节点于24:15停止称其为实验性,而"邦"从1.4起(在1.4:0上CI进行烟雾测试;其本土取来取代了undici路径. npm包船编译了JavaScript和类型声明.

## 快速启动

```bash
fastagent init my-agent
cd my-agent
fastagent dev
```

那就给它发个信息:

```bash
fastagent invoke "hello"
```

当地生产型服务:

```bash
fastagent start
```

没有FastAgent构建步骤:代理文件夹是可部署单位.

## 嵌入应用程序

```ts
import { baseEnv, openAgent } from "@fastagent-sh/fastagent";
import support from "@acme/support-agent"; // the default export of a package `fastagent build` made

const agent = await openAgent(support, {
  root: "/var/lib/myapp/support",
  env: baseEnv(process.env),
  model: "openai/gpt-5.5",
});

const session = await agent.sessions.create();
for await (const event of agent.messages.stream({ sessionId: session.id, content: "hi" })) {
  if (event.type === "delta" && event.channel === "text") render(event.text);
}
```

`await agent.serve()` 在您的应用程序中添加代理的频道和调度: 用于 Webhoks 的获取处理器, 挂载 其中您的框架会引导它们,或者它自己的服务器( )`listen`(中文(简体) )[嵌入](https://npmcn.com/package/%40fastagent-sh/fastagent/docs/embedding.md)) (中文(简体) ). 拿着钥匙 (单位:千美元)`FASTAGENT_API_KEY` 页:1 `start`,同一API可在 HTTP 下达到 `/v1`,另一个程序使用 `connectAgent(url, { apiKey })` 从 `@fastagent-sh/fastagent/client` 就像打开的特工一样.

## 文档

| 文档 | 目的 |
| --- | --- |
| [代理开发指南](https://github.com/fastagent-sh/fastagent/blob/main/docs/ai-start.md) | 为人类和编码代理编写目录 |
| [文件索引](https://fastagent.sh/docs/) | 文件地图 |
| [快速启动](https://fastagent.sh/docs/quickstart/) | 脚手架,运行,添加工具,然后启动 |
| [配置](https://fastagent.sh/docs/configuration/) | 配置模型、 认证、 端口、 会话、 工具和频道 |
| [设计原则](https://fastagent.sh/docs/principles/) | 设计选择、核心原始和非目标 |
| [CLI 参考](https://fastagent.sh/docs/cli/) | CLI 命令和旗帜 |
| [嵌入](https://fastagent.sh/docs/embedding/) | 使用 FastAgent 作为您自己的应用程序内的库 |
| [频道](https://fastagent.sh/docs/channels/) | 添加 Webhook/ 机器人频道 |
| [部署](https://fastagent.sh/docs/deploy/) | 将目录运送到 Fly, Railway 或任何 Docker 主机 |
| [电报](https://fastagent.sh/docs/telegram/) 编号 : [偷懒](https://fastagent.sh/docs/slack/) 编号 : [费修和拉克](https://fastagent.sh/docs/feishu/) | 一级频道指南 |
| [频道开发](https://fastagent.sh/docs/channel-development/) | 构建自定义频道适配器 |
| [API 参考](https://fastagent.sh/docs/api-reference/) | 公共类型脚本 API 参考 |
| [解决问题](https://fastagent.sh/docs/troubleshooting/) | 共同设置/运行时间问题 |
| [API SPEC探员](https://fastagent.sh/docs/spec/) | API探员 每个呼叫者都使用 |
| [核心设计](https://fastagent.sh/docs/design/core/) | 维护者架构注释 |

## 公共 API 表面和稳定性

软件包只导出支持的表面,从每个用户的条目中导出,并列出每个导出的名称(否) `export *`CI声称:

| 区域 | 实例 | 稳定 |
| --- | --- | --- |
| API探员 | `Agent`, (中文(简体) ), `AgentError` (单位:千美元)[API探员](https://npmcn.com/package/%40fastagent-sh/fastagent/docs/SPEC.md)(中文(简体) ) | 在版本内保持稳定 |
| 目录 代理人 服务 | `openAgent`, (中文(简体) ), `LocalAgent`, (中文(简体) ), `serve()`是因为 `Service` (单位:千美元)`fetch`, (中文(简体) ), `listen`(中文(简体) ) | 现在可以使用, 可能会在1.0之前收紧 |
| 超过 HTTP | `connectAgent` (单位:千美元)`/client`页:1 `/v1` 路线([API探员](https://npmcn.com/package/%40fastagent-sh/fastagent/docs/SPEC.md) 第9条 | 在版本内保持稳定 |
| 一个主机嵌入代理 | `createAgent`, (中文(简体) ), `addContent`, (中文(简体) ), `removeContent`, (中文(简体) ), `listContent`, (中文(简体) ), `CredentialStore`, (中文(简体) ), `credentialFile`, (中文(简体) ), `signIn`, (中文(简体) ), `signInOptions`, (中文(简体) ), `providerAuth` (单位:千美元)[嵌入](https://npmcn.com/package/%40fastagent-sh/fastagent/docs/embedding.md#6-a-desktop-host)(中文(简体) ) | 现在可以使用, 可能会在1.0之前收紧 |
| MCP工具和授权 | `inspectMcp`, (中文(简体) ), `signInMcp`, (中文(简体) ), `mcpGrantFile`, (中文(简体) ), `McpGrantStore` (单位:千美元)[MCP 服务器](https://npmcn.com/package/%40fastagent-sh/fastagent/docs/mcp.md)(中文(简体) ) | 现在可以使用, 可能会在1.0之前收紧 |
| 撰写 | `defineAgent`, (中文(简体) ), `defineChannel`, (中文(简体) ), `defineSchedule`, (中文(简体) ), `needs`, (中文(简体) ), `sessionIdOf`, (中文(简体) ), `readBodyCapped`, (中文(简体) ), `text`, (中文(简体) ), `secretEquals` | 现在可以使用, 可能会在1.0之前收紧 |
| 未导出 | 装配部分(`router`, (中文(简体) ), `createScheduler`),环境编辑(`writeEnvironment`),模型环境,利用内部 | 无相容承诺 |

工具或扩展是 pi-dudable 自己的(`defineTool`, (中文(简体) ), `defineExtension` 从 `@earendil-works/pi-durable`页:1 自定义提供者是pi-ai's(`createProvider` 从 `@earendil-works/pi-ai`: `init` 在代理中添加两个包.

入境点`./package.json` 也导出,用于读取版本的工具:

-   `@fastagent-sh/fastagent` - API探员, `openAgent`、宿主嵌入代理需要什么,以及作者写什么;
-   `@fastagent-sh/fastagent/client` —— 说 `connectAgent`在HTTP之上的API探员 用于任何地方的程序 `fetch` 运行;
-   `@fastagent-sh/fastagent/telegram` - Telegram机器人频道;
-   `@fastagent-sh/fastagent/slack` - API机器人频道;
-   `@fastagent-sh/fastagent/feishu` - 犬形Feishu bot频道(飞书,开.feishu.cn);
-   `@fastagent-sh/fastagent/lark` ——拉克-国际相容性剖面凌驾于飞虎发动机上.

## 仓库布局

```txt
src/     the npm package: CLI, library API, reference implementation
test/    vitest suite (faux models by default) + the Agent API's conformance suite
docs/    user docs, SPEC, and maintainer design notes
```

一个包;子路径导出为模块边界.

## 状态

FastAgent为前1.0. 稳定设计中心是API探员 `docs/SPEC.md`;套件API可能在1.0之前仍会收紧. 显著变化记录在 [GitHub 发布](https://github.com/fastagent-sh/fastagent/releases)。 。 。 .

## 设计更多

Agent API为尚未完成产品特性的能力留下了空间:

-   **缩放**:一个进程今天存储着一个实例;将一个实例分散于几个进程是今后的工作.
-   **沙盒处决** ——编码工具,通道,和作者所写的代码直接到达了本地进程;围绕完整的代理进程的一个沙盒是未来的工作.
-   **可观察性导出** ——今天存在平分的日志;OpenTeleometry出口商没有.
-   **更多频道** ——社区频道可以使用频道套件. 外部工具也可以使用 [MCP 服务器](https://npmcn.com/package/%40fastagent-sh/fastagent/docs/mcp.md)。 。 。 .
-   **更多部署目标** ——今天当地的多克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克.

见 [捐款](https://github.com/fastagent-sh/fastagent/blob/main/CONTRIBUTING.md) 如果其中一个是你想解决的问题.

> ☁️ **更喜欢这些管理?** FastAgent Cloud会用多层耐久性,规模至零,以及所建的可观察性来运行你的特工——并且自宿永远保持自由. [加入等候名单](https://tally.so/r/44DVMB)

## 项目

-   [捐款](https://github.com/fastagent-sh/fastagent/blob/main/CONTRIBUTING.md)
-   [安全政策](https://github.com/fastagent-sh/fastagent/blob/main/SECURITY.md)

## 鸣谢

FastAgent站在开源处. 绳子是 **[毕](https://github.com/earendil-works/pi)** (单位:千美元)[页:1](https://pi.dev/))——pi-dudable的耐用剂循环和pi-ai的多供应商LLM API.

这还取决于并感激:, [效果](https://github.com/Effect-TS/effect), (中文(简体) ), [未编辑](https://github.com/nodejs/undici), (中文(简体) ), [乔基达尔](https://github.com/paulmillr/chokidar), (中文(简体) ), [吉娃娃](https://github.com/unjs/giget), (中文(简体) ), [@ clack/ 瞬间](https://github.com/bombshell-dev/clack), (中文(简体) ), [忽略](https://github.com/kaelzhang/node-ignore),以及 [克罗纳](https://github.com/Hexagon/croner)。 。 。 .

脚手架 `writing-great-skills` 技能从 [马特孔克/技能](https://github.com/mattpocock/skills)包括许可证.

* * *

**FastAgent在开阔地建造.**  
如果这能让你避免将代理重写成另一个框架, [给它一个""](https://github.com/fastagent-sh/fastagent) ——这是最快的帮助其他devs找到的方法.

## 许可证

[麻省理工学院](https://github.com/fastagent-sh/fastagent/blob/main/LICENSE)运行时间依赖性使用允许的开源许可证,并作为单独的 npm 包安装;供应商 `writing-great-skills` 脚手架包括自己的执照.

## 常见问题

### @fastagent-sh/fastagent 是什么？

维比先\. 然后FastAgent:将本地代理目录变成你的应用程序中的活服务,在Telegram,Slack,Feishu,或任何频道后\.

### 如何安装 @fastagent-sh/fastagent？

在项目目录运行 npm install @fastagent-sh/fastagent，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 fastagent，可以用 npx fastagent 直接运行。

### @fastagent-sh/fastagent 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fastagent-sh/fastagent 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @fastagent-sh/fastagent 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.15\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @fastagent-sh/fastagent 可以商用吗？

@fastagent-sh/fastagent 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fastagent-sh/fastagent 的下载量有多少？

根据 npm 官方下载统计，@fastagent-sh/fastagent 在 2026/10/15 – 2026/11/13 这 30 天内被下载 3,087 次，日均约 103 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fastagent-sh/fastagent 还在维护吗？

最新版本 0\.30\.3 发布于 2026/11/09（5 天前）；至今共发布 33 个版本，其中过去 12 个月发布了 33 个；首次发布于 2026/07/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。