# @framers/agentos 中文文档

规范地址：https://npmcn.com/package/%40framers/agentos/

版本：0\.19\.0
npm 元数据更新时间：2026-11-15T10:45:01.912Z
中文译文更新时间：2026-11-15T11:51:44.063Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：32.9 MB，5456 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：21 个
- peer 依赖：graphology \>=0\.25\.0，mediabunny ^1\.61\.3，typescript \>=5\.0\.0，hnswlib-node \>=3\.0\.0，neo4j-driver \>=5\.0\.0，officeparser ^8\.1\.1，tesseract\.js \>=5\.0\.0，ppu-paddle-ocr \>=3\.0\.0，graphology-types \>=0\.24\.0，@livekit/rtc-node ^1\.1\.0，quickjs-emscripten-core 0\.32\.0，@moonshine-ai/moonshine-wasm ^0\.1\.5，graphology-communities-louvain \>=2\.0\.0，@jitl/quickjs-wasmfile-release-sync 0\.32\.0
- 首次发布：2025-12-12T02:06:58.258Z
- 最新版本发布：2026-11-15T10:45:01.522Z
- 近 30 天下载量：67863（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：898（近 12 个月 898 个）

## 中文简介

AgentOS:用于自主AI代理的开源TypeScript框架. 统一图管,认知记忆,跑时工具造型,多级护栏,语音管,以及11个LLM提供商.

## 安装

```sh
npm install @framers/agentos
```

也可以使用：`pnpm add @framers/agentos`、`yarn add @framers/agentos`、`bun add @framers/agentos`

## README

[![AgentOS: TypeScript AI Agent Framework with Cognitive Memory](https://raw.githubusercontent.com/framerslab/agentos/master/assets/agentos-primary-no-tagline-transparent-2x.png)](https://agentos.sh/)  

# **代理服务器** 脚本 AI 代理框架

**记住,伪造自己的工具, 并活过长期的会议.** 持续的认知记忆,可选的HEXACO个性,多剂管弦乐,以及一个跨越13个LLM提供者的调度接口. 阿帕奇2.0 (英语).

[![npm](https://img.shields.io/npm/v/@framers/agentos?style=flat-square&logo=npm&color=cb3837)](https://www.npmjs.com/package/@framers/agentos) [![CI](https://img.shields.io/github/actions/workflow/status/framerslab/agentos/ci.yml?branch=master&style=flat-square&logo=github&label=CI)](https://github.com/framerslab/agentos/actions/workflows/ci.yml) [![tests](https://img.shields.io/endpoint?url=https://unpkg.com/@framers/agentos@latest/.github/badges/tests.json&style=flat-square&logo=vitest&logoColor=white)](https://github.com/framerslab/agentos/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/framerslab/agentos/graph/badge.svg)](https://codecov.io/gh/framerslab/agentos) [![TypeScript](https://img.shields.io/badge/TypeScript-5.4+-3178c6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/) [![License](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fregistry.npmjs.org%2F%40framers%2Fagentos%2Flatest&query=%24.license&label=license&color=blue&style=flat-square)](https://github.com/framerslab/agentos/blob/master/LICENSE) [![NVIDIA Inception](https://img.shields.io/badge/NVIDIA_Inception-Member-76B900?style=flat-square&logo=nvidia&logoColor=white)](https://www.nvidia.com/en-us/startups/) [![LongMemEval-S](https://img.shields.io/badge/LongMemEval--S-85.6%25-2ea043?style=flat-square)](https://docs.agentos.sh/blog/2026/04/27/longmemeval-s-83-with-semantic-embedder) [![LongMemEval-M](https://img.shields.io/badge/LongMemEval--M-70.2%25-2ea043?style=flat-square)](https://docs.agentos.sh/blog/2026/04/29/longmemeval-m-70-with-topk5) [![agentos-bench](https://img.shields.io/badge/bench-public-blue?style=flat-square)](https://github.com/framerslab/agentos-bench) [![Discord](https://img.shields.io/badge/Discord-Join%20Us-5865F2?style=flat-square&logo=discord)](https://wilds.ai/discord)

[**基准**](https://github.com/framerslab/agentos-bench/blob/master/results/LEADERBOARD.md) \* 联合国 [网站](https://agentos.sh/) \* 联合国 [文档](https://docs.agentos.sh/) \* 联合国 [无](https://www.npmjs.com/package/@framers/agentos) \* 联合国 [解析器](https://wilds.ai/discord) \* 联合国 [博客](https://docs.agentos.sh/blog)

* * *

AgentOS是用于AI代理的开源TypeScript框架 **记住、适应和编写自己的工具**。 。 。 .

-   **顶端开源内存基准 :** [在LongMemEval上为85.6% 页:1](https://github.com/framerslab/agentos-bench/blob/master/results/LEADERBOARD.md) 0.0090美元/更正(美元)`gpt-4o` 财务报告和审定财务报表 `gpt-5-mini` longMemEval-M上是M上唯一一个65%以上的开源库,采用可复制的方法.
-   **运行时间工具伪造 .** 一个代理为JSON Schemas的输入和输出撰写了JavaScript函数,声明的测试案例运行它,一个LLM法官审查结果,在批准后,工具加入会话的工具列表. 伪造的代码运行在一个过程中 `node:vm` 上下文或,与 `QuickJSExecutor`,在QuickJS WebAssembly中为每次通话提供自己的实例.
-   **持久性 [认知记忆](https://docs.agentos.sh/features/cognitive-memory)** 以及8个神经科学支持的机制 其中包括 回收引发的遗忘 重新整合 和源的信心衰减.
-   **可选 [墨西哥的个性](https://docs.agentos.sh/features/hexaco-personality)**, (中文(简体) ), [7项协调战略](https://docs.agentos.sh/features/agency-collaboration), (中文(简体) ), [护栏](https://docs.agentos.sh/features/guardrails-architecture),以及 [语音](https://docs.agentos.sh/features/voice-pipeline) 纵横 **13个LLM供应商**; 100+扩展和88个技能船作为单独的包件,并配有装入它们的登记册.

* * *

## 安装

```bash
npm install @framers/agentos
```

```typescript
import { agent } from '@framers/agentos';

const tutor = agent({
  provider: 'anthropic',                          // resolves to claude-sonnet-4-6 (provider default)
  // model: 'claude-opus-4-8',                    // pin a specific model to override the default
  instructions: 'You are a patient CS tutor.',
  personality: { openness: 0.9, conscientiousness: 0.95 },
});

// Provider auto-detected from env when `provider` is omitted.
// Cognitive memory, sentiment tracking and metaprompts: runtime: 'gmi' (see GMIs below).

const session = tutor.session('student-1');
await session.send('Explain recursion with an analogy.');
await session.send('Can you expand on that?'); // remembers context
```

[全面快速启动](https://docs.agentos.sh/getting-started) \* 联合国 [实例烹饪本](https://docs.agentos.sh/getting-started/examples) \* 联合国 [API 参考](https://docs.agentos.sh/api)

**会议.** 一个会话保持整个对话, 无论内存是打开还是关闭: 每个 `send()` 记录其工具调用,结果和模型的签名思维,以后的每一个请求都会重放. `stream()` 将轮到的文本记录为即时文本和最后文本 `runtime: 'gmi'`,每一步,作为 `send()` 页:1 历史默认上限为约120K个令牌. 设定 `history: false` 无国籍人会议 `history: { maxTokens }` 更改盖子,并调用 `reseed()` 以较短的一组信息来代替历史. `close()` 结束会话并释放其历史:下一个 `session(id)` 用那个id开始为空,和 `agent.usage(id)` 仍然报告身份证明花了多少.

```ts
const stateless = agent({ model, memory: false, history: false }).session('job-1');
const bounded = agent({ model, history: { maxTokens: 60_000 } }).session('job-2');
bounded.reseed([{ role: 'user', content: 'compact resume snapshot' }]);
```

* * *

## 紧急设计

有三件事会累积到一个会话 并编成行为: **内存** (发言、决定、检索) **工具表面** (当代理人伪造法官批准的工具时会增加) **墨西哥的个性** 矢量,用于塑造即时和缩放内存编码. 每一个都是可塑可观测的.

**运行时间工具伪造 .** 当没有工具覆盖子任务时, 代理员会打电话 `forge_tool` 带有一串已存在的工具或JavaScript函数,用于输入和输出的JSON Schemas,并测试大小写. 代码模式在主机设定前关闭 `emergentConfig.allowSandboxTools`。使用源 `eval`, (中文(简体) ), `require` 或者说 `process` 在运行前被拒绝。 伪造的代码运行在一个过程中 `node:vm` 默认上下文,有5个超时,以及 `node:vm` 不是一个安全边界 `QuickJSExecutor`,每个调用都会在快速JS WebAssembly中运行,其内存有限。 一个单独的LLM法官以测试结果审查候选人,一个经核准的工具加入会场的工具列表. 伪造工具输出为 `SKILL.md` 技术. [紧急能力 - >](https://docs.agentos.sh/features/emergent-capabilities)

**HEXACO 个性(可选).** 默认关闭. `agent()` 将特性值写入系统,作为指令,每个特性超过0.65或低于0.35。 一个认知记忆管理器赋予了同样的特性 其编码和它的8个机制中的7个 `AgentGraph` 树枝的特性 `addPersonalityEdge()`。 。 。 . [墨西哥文件 - >](https://docs.agentos.sh/features/hexaco-personality)

**灵魂档案.** 代理的身份,写作风格,硬限制和HEXACO的分数可以活在一个 `SOUL.md` 工作空间。 建立代理的每一种方式都应用身份和硬限制:硬限制关闭系统即时,灵魂的 `agentId` 是特工的一个身份 与 `systemBlocks`灵魂的道词和风格被忽略了 并且它的硬度仍然关闭了提示。 内容 `memory/` 目录持有操作员的标记下维基( a) `index.md` 附加目录 `entities/`, (中文(简体) ), `concepts/`, (中文(简体) ), `log/` 页面 `[[wikilinks]]`),由代理商与所有人共同交谈. 每个用户保留灵魂代理的对话记忆(会话 `userId`并编入该用户自己的网页; [`souledAgent()`](https://docs.agentos.sh/getting-started/high-level-api) 线接到底到底. `souledAgent()` 将每个人的记忆保留在自己的范围内, 永远删除它与 `agent.forgetUser(userId)` 并保持通过恢复删除; [什么是你的职责](https://docs.agentos.sh/features/memory-host-duties)。 。 。 . [灵魂文件 - >](https://docs.agentos.sh/features/soul-files)

```ts
import { souledAgent } from '@framers/agentos';

const aria = await souledAgent({ provider: 'anthropic', soul: '~/.agentos/agents/aria' });
```

* * *

## 通用的智力实例

在全程工作时,每场会议都有一个 **绿色倡议**: 具有自身人格、心情、对话历史和推理痕迹的持久代理人 `agent({ runtime: 'gmi' })` 一个代理的会话也是GMOI的. `agent()` 无 `runtime: 'gmi'` 是轻量级的帮助器;它使用一个快取并保存会话历史的模型。 一个全程运行的GMI绕着相同的模型,工具,护栏和认知内存运行:

-   **(原始内容存档于2018-03-29) (英语). Sentment – metapropts.** 当一个人a 实现情绪跟踪时,每个用户转弯都会得到分数;持续的挫折感或混淆性火灾恢复元aprompts,以及自反应元apropt从证据中重新读取GMI的情绪和任务上下文.
-   **毛重相忆.** 随着认知记忆的附着,每次交换都会被编码为GMI的当前情绪,并在分数中以情感相容来回想.
-   **自我改造工具.** 与 `selfImprovement.enabled`,运行时间登记册 `adapt_personality`, (中文(简体) ), `manage_skills`, (中文(简体) ), `create_workflow` 财务报告和审定财务报表 `self_evaluate`· ; `adapt_personality` 将运行的 GMI 特性在界限内更改,一个变异存储器在存储适配器和 `persistWithDecay` 已配置.
-   **推理追踪** 违约后最后500项判决(`reasoningTraceConfig` 或运行时间的默认值),和每会话的人称重叠值.

```ts
import { AgentOS, AgentOSResponseChunkType, BUILT_IN_PERSONAS } from '@framers/agentos';

// AgentOS.create() reads persona files from ./personas by default. Personas can
// also be given inline, as parsed JSON or code-built objects; here, the five the
// package ships. A custom loader covers any other source.
const agentos = await AgentOS.create({ personas: BUILT_IN_PERSONAS });
for await (const chunk of agentos.processRequest({
  userId: 'user-42', sessionId: 'research-q1', selectedPersonaId: 'v_researcher',
  textInput: 'Summarize the open incidents from this week.',
})) {
  if (chunk.type === AgentOSResponseChunkType.TEXT_DELTA) process.stdout.write(chunk.textDelta);
}
```

`agent({ runtime: 'gmi' })`,并导出为 `gmi()`,从代理选项中构建其GMI,没有 `AgentOS` 运行时间。 在以上部分中,这些GMOI运行了推理追踪,记忆被开启时的情绪加权内存,以及情绪跟踪,当其配置图开启时,与五个预设事件元发相(失败恢复,混淆澄清,满足强化,错误恢复和接触增强). 这个 `'full'` 剖面图可以打开认知记忆、情绪跟踪和这五个元相; `'light'`,默认值,仅当 `memory` 已经设定。 自我反射的元相,自修工具,人称叠加和运行时的护栏,取回和通道不在此路径上运行. 这个导师的 GMOI 运行此路径的每个部分 :

```ts
import { agent } from '@framers/agentos';

const tutor = agent({
  runtime: 'gmi',
  cognition: 'full',
  provider: 'openai',
  instructions: 'You are a patient CS tutor.',
  memory: { embedding: { provider: 'openai' } }, // cognitive memory embeds with text-embedding-3-small
});
const session = tutor.session('student-1', { userId: 'student-7f3a' }); // memory is scoped to the user id
await session.send('Explain recursion with an analogy.');
```

[在一个普通的药剂上加了什么GMI](https://docs.agentos.sh/architecture/gmi)

* * *

## 内存基准

两个标题结果都使用每个类别阅读器路由器(`gpt-4o` 回答时间理由和单会场用户问题, `gpt-5-mini` (其他四类) `gpt-4o-2024-08-06` 判官,全N=500,单CLI复制有靴子夹95%的CI和每个基准判官-FPR探测器.

-   **长门-斯:85.6%** 0.0090美元/正确,3 558 ms p50。 与 `gpt-4o` 读取每个问题,相同的检索分数为84.2%,与 Mastra OM 的级别为 a `gpt-4o` 演员(84.23%;马斯特拉使用) `gemini-2.5-flash` mastra OM报告为94.87%,其中a `gpt-5-mini` 演员。 完整的表格和方法: [电视剧](https://github.com/framerslab/agentos-bench/blob/master/results/LEADERBOARD.md)。 。 。 .
-   **长梅梅瓦尔-M:70.2%** (1.5M-token干草克,500会):在M上唯一一个超过65%的开源库,具有可复制的方法.

[全导板 - >](https://github.com/framerslab/agentos-bench/blob/master/results/LEADERBOARD.md) \* 联合国 [透明度审计 - >](https://agentos.sh/en/blog/memory-benchmark-transparency-audit/) \* 联合国 [长梅梅瓦尔纸](https://arxiv.org/abs/2410.10813) (Wu等人,《2025年国际海洋生物公约》)

* * *

## 为什么代理OS

| 文选. | AgentOS 区分器 |
| :-- | :-- |
| **朗钱/朗格拉夫** | 认知记忆[8个神经科学支持机制](https://docs.agentos.sh/features/cognitive-memory)),HEXACO个性,运行时工具form |
| **维塞尔 AI SDK** | 多代理团队(7个战略),7个向量后端, [护栏](https://docs.agentos.sh/features/guardrails-architecture)语音/电话, [零配置快取缓存](https://docs.agentos.sh/features/prompt-caching) |
| **CrewAI/马斯特拉** | 统一管弦(DAGs + 图表+任务),个性驱动的路由, **在LongMemEval-S(85.6%)和LongMemEval-M(70.2%)上公布的可复制数字,并全面披露方法** |

[完整框架比较 - >](https://docs.agentos.sh/blog/2026/02/20/agentos-vs-langgraph-vs-crewai)

* * *

## 关键特性

| 类别 | 要点 |
| :-- | :-- |
| **LLM 供应商** | 13 (由 API 键或基站 URL+ 2 本地 CLI 表示): OpenAI, Anthropic, 双子座, Groq, Ollama, OpenRouter, E请求y, LitelLM, College, Mistral, xAI, Claude CLI, 双子座 CLI. 加上图像/视频/音频生成提供者. |
| **快速缓存** | 每个提供者上的零配置:自动Anthropic断点包含多转折历史(直接 + OpenRouter) \* OpenAI缓存键路由 \* 常规缓存用量 + 漏出检测 \* 每调用 TTL, 仅使用前缀和选择退出 \* [指南](https://docs.agentos.sh/features/prompt-caching) |
| **认知记忆** | 8个机理:再整合,被检索引起的遗忘,非自愿召回,FOK,取出地心,分解编码,源分衰减,情绪调节 |
| **HEXACO 个性** | 6个特性调制内存,检索偏差,响应样式 |
| **GMI 运行时间** | 感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想 感想-感想-感想-感想-感想-感想 感想-感想-感想-感想-感想-感想 感想-感想-感想-感想-感想-感想-感想 感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想-感想 -感想-感想-感想\*感想-感想-感想-感想-知-知-知-知-知-知 `adapt_personality` 特性变化( opt- in) |
| **RAG 管道** | 7个向量后端 \* 4个检索策略 \* GraphRAG \* HyDE \* [重新排列](https://docs.agentos.sh/text/reranking):任何型号的当地交叉编码器、Cohere或LLM法官 |
| **多代理团队** | 7个协调战略 \* 管理者授权和专家产卵 \* 具有座位政策和严格的每座证书的示范人才库 \* 具有供应商和供应商法定人数的小组战略 \* HITL 核准门 |
| **管弦** | `workflow()` DAGs \* 导弹 `AgentGraph` 路由器、人格和发现边缘\* `mission()` \* 检查内存或SQLite和Postgres中的图(`SqlCheckpointStore`(中文(简体) ) |
| **护栏** | 6个包(PII、ML分类器、专题、代码安全、地基定位、内容政策) |
| **新兴能力** | \* 4个自我改进工具 \* 分级促进 \* 技能出口 |
| **语音( T)** | 第十一拉布斯,深格拉姆,发音 \*特维利奥,特尔尼克斯,普利沃 |
| **频道** | 37个平台适配器(Telegram, Discord, Slack, WhatsApp, webchat,.) |
| **观察性** | OpenTeleometry \* 使用分类账 \* 成本守护 \* 断路器 |

* * *

## 6行中的多代理

```typescript
import { agency } from '@framers/agentos';

const team = agency({
  strategy: 'graph',
  agents: {
    researcher: { provider: 'anthropic', instructions: 'Find relevant facts.' },                            // -> claude-sonnet-4-6
    writer:     { provider: 'openai',    instructions: 'Summarize clearly.', dependsOn: ['researcher'] },   // -> gpt-4o
    reviewer:   { provider: 'gemini',    instructions: 'Check accuracy.',    dependsOn: ['writer'] },       // -> gemini-2.5-flash
  },
});

const result = await team.generate('Compare TCP vs UDP for game networking.');
```

战略: `sequential`, (中文(简体) ), `parallel`, (中文(简体) ), `debate`, (中文(简体) ), `review-loop`, (中文(简体) ), `hierarchical`, (中文(简体) ), `graph`, (中文(简体) ), `panel`与 `hierarchical` + 键 `emergent: { enabled: true }`,经理在运行时伪造新的子代理. 每个名册代理人都可以自己安排 `provider`, (中文(简体) ), `model`, (中文(简体) ), `apiKey` 财务报告和审定财务报表 `effort`页:1 `parallel` 或者说 `panel` 机构可以要求提供商达到法定人数(`quorum: { minProviders: 2 }`在它合成之前。 A 类 `modelPool` 填补没有命名的每个席位 `provider` 也没有 `model` 从每个呼叫的命名模型, 严格的每座证书 和从记录中编辑的每个密钥. [多剂文件 - >](https://docs.agentos.sh/features/agency-api)

* * *

## 生态系统

| 软件包 | 作用 |
| :-- | :-- |
| [`@framers/agentos`](https://www.npmjs.com/package/@framers/agentos) | 核心运行时间:代理,认知记忆,管弦,护栏,语音,13个LLM提供者. 阿帕奇2.0 (英语). |
| [`@framers/agentos-extensions`](https://www.npmjs.com/package/@framers/agentos-extensions) | 100+先行扩展:通道适配器,工具包,集成,护栏包. |
| [`@framers/agentos-extensions-registry`](https://www.npmjs.com/package/@framers/agentos-extensions-registry) | 扩展目录的发现器+自动装入器. |
| [`@framers/agentos-skills`](https://www.npmjs.com/package/@framers/agentos-skills) | 88名主任 `SKILL.md` 技术. |
| [`@framers/agentos-skills-registry`](https://www.npmjs.com/package/@framers/agentos-skills-registry) | 发现+技能自动装填器;所推广的伪造工具上岸. |
| [`@framers/agentos-bench`](https://github.com/framerslab/agentos-bench) | 开放基准套:靴子圈 95%的CI,法官-FPR探测器,每个案件运行JSONs. 麻省理工学院. |
| [`@framers/sql-storage-adapter`](https://www.npmjs.com/package/@framers/sql-storage-adapter) | 跨平台 SQL 持久性: SQLite, Postgres, IndexedDB, Capacitor SQLite. |
| [`paracosm`](https://www.npmjs.com/package/paracosm) | AgentOS上的AI代理slomm模拟. [现场演示](https://paracosm.agentos.sh/sim)。 。 。 . |
| [`wunderland`](https://www.npmjs.com/package/wunderland) | 电池包含CLI+守护进程,覆盖AgentOS注册(审查). 阿帕奇2.0 (英语). |

显示的扩展载荷 `AgentOS.create({ extensionManifest })`· ; `createCuratedManifest()` 从 `@framers/agentos-extensions-registry` 从安装的已安装的扩展件中建起一个,没有显示负载的运行时间则没有. [扩展架构 - >](https://docs.agentos.sh/architecture/extension-loading)

* * *

## 配置 API 密钥

三层,优先级第一:内置 `apiKey` 呼叫时,模块级别 `setDefaultProvider()` 或环境可变自动探测(`OPENAI_API_KEY`, (中文(简体) ), `ANTHROPIC_API_KEY`,其余则按优先顺序解决,可按 `setProviderPriority([...])`) (中文(简体) ). 以逗号分隔的密钥列表给一个提供商一个密钥池:默认的圆边,或 `AGENTOS_KEY_POOL_STRATEGY_<PROVIDER>=ordered` (单位:千美元)`AGENTOS_KEY_POOL_STRATEGY_ANTHROPIC=ordered` 仅凭Anthropic的钥匙; `AGENTOS_KEY_POOL_STRATEGY=ordered` 每家提供商)使用密钥,以便在吊销密钥、不支付密钥或节制密钥时,键入后一键失败([按键旋转](https://github.com/framerslab/agentos/blob/master/docs/KEY_ROTATION.md)) (中文(简体) ). `probeProviderKey({ provider, apiKey })` 说一个钥匙是活的,没有信用,被拒绝的还是被压的, 通过同一个开票的探头 游泳池发送.

[完全认证分辨率+每个提供者的默认模型 - >](https://docs.agentos.sh/architecture/llm-providers)

* * *

## API 表面

-   **`agent()`**:轻量级状态剂. 提示、会话、人格、钩子、工具、内存 `memoryProvider` 钩子. 与 `runtime: 'gmi'` (或 `gmi()`),每个会话都是由相同选项构建的GMI,每个会话都有认知记忆,情绪跟踪和元相 `cognition` 简介.
-   **`agency()`**: 多代理团队 `agent()` 成员,拥有HITL审批门,运行限制,结构化输出,出处,在分级策略上,专家在运行时会出产. 内容 `guardrails` 财务报告和审定财务报表 `rag` 选项被报告或记录而不应用,以及 `voice.enabled` 在本地的WebSocket上为该机构提供JSON文本. 它没有收音机;频道适配器在全程运行中运行 `ChannelRouter`。 。 。 .
-   **`generateText()` 编号 : `streamText()` 编号 : `generateObject()` 编号 : `generateImage()` 编号 : `removeBackground()` 编号 : `generateVideo()` 编号 : `generateMusic()` 编号 : `performOCR()` 编号 : `embedText()`**:低级多式助力. `generateText()` 财务报告和审定财务报表 `streamText()` 带 `tools`;其他帮手则不取.
-   **`workflow()` 编号 : `AgentGraph` 编号 : `mission()`**:3个管弦乐作者通过一个图运行时间编写API.

提供者违约后退 `generateText()`, (中文(简体) ), `streamText()`, (中文(简体) ), `agent()` 财务报告和审定财务报表 `agency()`:当一个呼叫因可重试错误而失败时,它会被重审到其他按键位于环境中的提供者身上. 过 `fallbackProviders: []` 关闭它,或列表 设置链。 专职运行的 GMOI (`processRequest()`(c) 给供应商打电话,不设倒扣链。 通用指数 `agent({ runtime: 'gmi' })` 通过从代理商处建起的完成网关 `fallbackProviders`,当一个调用失败时,在第一个输出前出现可重试错误,而不是在输出后出现.

[完整的 API 参考 - >](https://docs.agentos.sh/api) \* 联合国 [高级API 指南 - >](https://docs.agentos.sh/getting-started/high-level-api)

* * *

## 文档和社区

-   **[基准](https://github.com/framerslab/agentos-bench/blob/master/results/LEADERBOARD.md)**:基准表、95%的置信间隔、方法审计
-   **[建筑](https://docs.agentos.sh/architecture/system-architecture)**: 系统设计,分层
-   **[认知记忆](https://docs.agentos.sh/features/cognitive-memory)**: 8个机制,引用30+APA
-   **[RAG 配置](https://docs.agentos.sh/features/rag-memory)**: 向量存储、嵌入、源
-   **[文档摄入量](https://docs.agentos.sh/features/memory-document-ingestion)**: PDF, Word, PowerPoint, Excel, OpenDocument, RTF, EPUB, HTML和Markdown 读取到文本, 对 Word 或 office 存档充气到什么
-   **[图书馆索引](https://docs.agentos.sh/features/library-index)**: 任何向量商店的源头, 以及一个浏览器条目, 用于页面本身的搜索和记录, 其他记录员( SubRip, WebVTT, Otter, Fireflies, Word) 的笔录文件, 读取与扬声器分开的转接, 以及存档条目的计划
-   **[文本处理和搜索](https://docs.agentos.sh/text)**: 标记器和终止, BM25, 模糊和混合搜索, 文本统计, 块化, 重排
-   **[重新排队](https://docs.agentos.sh/text/reranking)**页:1 `RerankerService` 在本地变形器.js 交叉编码器上( 评分停留在进程中), Cohere 重新排序 API, 任何模型上的 LLM 判断器 函数调用, 或者你自己的提供者
-   **[护栏](https://docs.agentos.sh/features/guardrails-architecture)**:两相调度器,四个判决,对BLOCK的搁置,将内容保留给一个人审查,故障打开和故障关闭的警卫
-   **[语音管道](https://docs.agentos.sh/features/voice-pipeline)**: TTS、STT、电话
-   **[博客](https://docs.agentos.sh/blog)**:工程员额、基准出版物、透明度审计
-   **[解析器](https://wilds.ai/discord)** \* 联合国 **[GitHub 问题](https://github.com/framerslab/agentos/issues)** \* 联合国 **[怀德赛](https://wilds.ai/)** (AI游戏世界由AgentOS提供动力)

* * *

## 捐款

```bash
git clone https://github.com/framerslab/agentos.git && cd agentos
pnpm install && pnpm build && pnpm test
```

`pnpm run test:coverage` 运行有覆盖的套件, 如 CI 那样 : 运行失败低于 [`vitest.config.ts`](https://github.com/framerslab/agentos/blob/master/vitest.config.ts),并且CI将主人的数字发送给 [代码](https://codecov.io/gh/framerslab/agentos)上面写着:.

我们用 [常规武器委员会](https://www.conventionalcommits.org/)项目指南:

| 指南 | 什麽 |
| :-- | :-- |
| [捐款](https://github.com/framerslab/agentos/blob/master/CONTRIBUTING.md) | 制定、承诺和拉动请求规则、审查线索、发放捐款许可证 |
| [添加 LLM 提供者](https://github.com/framerslab/agentos/blob/master/docs/contributing/new-provider.md) | 提供者接口、验收清单、赞助和披露 |
| [发行指南](https://github.com/framerslab/agentos/blob/master/docs/getting-started/RELEASING.md) | 合并后的更改如何成为每日 npm 发布 |
| [代理指令](https://github.com/framerslab/agentos/blob/master/AGENTS.md) | 编码代理人的命令和公约 |
| [维护者](https://github.com/framerslab/agentos/blob/master/MAINTAINERS.md) | 由谁审查和合并更改 |
| [行为守则](https://github.com/framerslab/agentos/blob/master/.github/CODE_OF_CONDUCT.md) | 社区标准 |
| [安全政策](https://github.com/framerslab/agentos/blob/master/.github/SECURITY.md) | 私下报告脆弱性 |
| [支助](https://github.com/framerslab/agentos/blob/master/SUPPORT.md) | 哪里去寻求帮助 |
| [发起人](https://github.com/framerslab/agentos/blob/master/SPONSORS.md) | 供资、赞助安排和披露 |

* * *

## 启动和伙伴关系

AgentOS为Apache-2.0并免费. 我们以技术优势整合任何高质量的提供者,伙伴和赞助者在 " README " 和 " Docs " 中被贴上这样的标签。 公司通过伙伴开办方案、赞助或供应商一体化进行参与。 见 [斯德哥尔摩](https://npmcn.com/package/%40framers/agentos/SPONSORS.md)。 。 。 .

### 方案与合作伙伴

| 合伙人 | 类型 | 提供 | 自兹 |
| :-- | :-- | :-- | :-: |
| [![Deepgram](https://img.shields.io/badge/Deepgram-13EF93?style=for-the-badge&logo=deepgram&logoColor=000000)](https://deepgram.com/startups) | 启动程序 | 语音对文本+文字对语音的信用,上市 | 2026 (英语) |

### 参与方式

| 音轨 | 这是什么 | 何处 |
| :-- | :-- | :-- |
| **发起人** | 基金开发。 被披露的标志设置+放行符信用. | [斯德哥尔摩](https://npmcn.com/package/%40framers/agentos/SPONSORS.md) |
| **供应商一体化** | 将您的模型或 API 作为支持提供者运输 。 免费的,以技术优势. | [提供者指南](https://npmcn.com/package/%40framers/agentos/docs/contributing/new-provider.md) |

有兴趣吗? 电子邮件 [团队@frame.dev](mailto:team@frame.dev)。 。 。 .

* * *

## 许可证

[Apache 2.0 (英语)](https://npmcn.com/package/%40framers/agentos/LICENSE)

 [![AgentOS](https://raw.githubusercontent.com/framerslab/agentos/master/assets/agentos-primary-transparent-2x.png)](https://agentos.sh/)    [![Frame.dev](https://raw.githubusercontent.com/framerslab/agentos/master/assets/frame-logo-green-no-tagline.svg)](https://frame.dev/)

**由 [框架](https://frame.dev/) \* 联合国 [怀德赛](https://wilds.ai/)**

## 常见问题

### @framers/agentos 是什么？

AgentOS:用于自主AI代理的开源TypeScript框架\. 统一图管,认知记忆,跑时工具造型,多级护栏,语音管,以及11个LLM提供商\.

### 如何安装 @framers/agentos？

在项目目录运行 npm install @framers/agentos，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typescript（\>=5\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @framers/agentos 支持 TypeScript 吗？

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

### @framers/agentos 支持 ESM 还是 CommonJS？

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

### @framers/agentos 需要什么版本的 Node\.js？

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

### @framers/agentos 可以商用吗？

@framers/agentos 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @framers/agentos 的下载量有多少？

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

### @framers/agentos 还在维护吗？

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