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

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

基准 * 联合国 网站 * 联合国 文档 * 联合国 无 * 联合国 解析器 * 联合国 博客

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

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

安装

npm install @framers/agentos

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

全面快速启动 * 联合国 实例烹饪本 * 联合国 API 参考

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

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 技术. 紧急能力 - >

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

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

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 或运行时间的默认值),和每会话的人称重叠值.

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 运行此路径的每个部分 :

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

内存基准

两个标题结果都使用每个类别阅读器路由器(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 演员。 完整的表格和方法: 电视剧。 。 。 .
• 长梅梅瓦尔-M:70.2% (1.5M-token干草克,500会):在M上唯一一个超过65%的开源库,具有可复制的方法.

全导板 - > * 联合国 透明度审计 - > * 联合国 长梅梅瓦尔纸 (Wu等人,《2025年国际海洋生物公约》)

为什么代理OS

完整框架比较 - >

关键特性

6行中的多代理

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 从每个呼叫的命名模型, 严格的每座证书 和从记录中编辑的每个密钥. 多剂文件 - >

生态系统

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

配置 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 每家提供商)使用密钥,以便在吊销密钥、不支付密钥或节制密钥时,键入后一键失败(按键旋转) (中文(简体) ). probeProviderKey({ provider, apiKey }) 说一个钥匙是活的,没有信用,被拒绝的还是被压的, 通过同一个开票的探头 游泳池发送.

完全认证分辨率+每个提供者的默认模型 - >

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 参考 - > * 联合国 高级API 指南 - >

文档和社区

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

捐款

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

pnpm run test:coverage 运行有覆盖的套件, 如 CI 那样 : 运行失败低于 vitest.config.ts,并且CI将主人的数字发送给 代码上面写着:.

我们用 常规武器委员会项目指南:

启动和伙伴关系

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

方案与合作伙伴

合伙人	类型	提供	自兹
	启动程序	语音对文本+文字对语音的信用,上市	2026 (英语)

参与方式

有兴趣吗? 电子邮件 团队@frame.dev。 。 。 .

许可证

Apache 2.0 (英语)

   

由 框架 * 联合国 怀德赛