描述
Open ETF Agent 是一个开源项目,旨在提供一个实用的、可验证的框架,用于构建和理解 ETF 研究代理。它作为一个可运行的实地指南,使用户能够从理论文章转向可执行的模块。其核心理念围绕着能够阅读机制、运行相应的实现、检查生成的报告,并追溯到基础代码、原始来源和执行证据。
阅读更多
该项目强调透明性和可验证性,允许用户通过观察输出和追踪开发历史来理解代理的工作原理。它提供了一系列模块,每个模块代表代理开发中的一个进化步骤,而不仅仅是文章的发布日期。这些模块展示了特定的功能,例如持久的人机交互、时间意识和 PDF 内容提取。
用户可以在本地尝试代理,需安装 Node.js 和 npm。默认示例在离线状态下运行,不需要模型密钥,使实验变得可行。命令行界面生成报告、清单和运行记录,提供清晰的执行审计轨迹。该设置旨在用于合成示例,而非实时基金研究,专注于代理操作的机制。
该项目还维护详细的构建日志,记录增量改进和固定的开发快照。每个阶段突出一个独立的交付重点,允许用户在任何时刻检查原始代码。这包括全面的版本历史,从第一个可运行报告(v0.1)到更高级的功能,如内容信任和持久的人机交互(v0.13)。
Open ETF Agent 的一个重要方面是其对内容信任和安全性的关注,特别是关于提示注入。它实施机制以建立内容信任边界,确保外部内容被视为数据,而不是可以改变系统行为的指令。这涉及到保留原始身份、验证实际的 SDK 投影,并防止内容自我归属权威。该项目明确将源和证据身份与指令身份和执行授权分开,旨在构建一个强大且可验证的系统。
该项目还深入探讨了复杂主题,如跨运行对话压缩,解决代理如何管理历史上下文而不损害原始事实或用户意图的完整性。它概述了一种保守的策略,用于总结旧助手的响应,同时严格保留用户提示和源身份,确保摘要不会覆盖原始事实。这种对数据处理和执行追踪的细致方法使 Open ETF Agent 成为开发者和研究人员在 AI 代理的实际工程中一个有价值的资源。
- 类别AI 智能体构建工具
- 定价模式开源
- 部署本地
- 平台Node.js
Open ETF Agent的核心功能
可运行的实地指南:执行模块以理解代理架构。
版本追踪:追踪代码、版本和证据边界。
开源实现:访问和检查基础代码。
合成示例:在不需要模型密钥的情况下运行默认演示。
本地执行:在本地机器上使用 Node.js 尝试代理。
报告生成:生成可读的报告、清单和运行记录。
详细构建日志:查看增量开发快照和版本历史。
内容信任边界:实施 A35 内容安全以防止提示注入。
持久的人机交互:管理持久的用户对话。
时间意识:处理任务日期和 IANA 时区。
PDF 内容提取:处理 PDF 文档中的本地文本层。
上下文压缩:总结旧助手的响应而不改变原始事实。
模块化设计:通过不同模块探索代理的演变。
可验证的执行:确保每个声明都可以追溯到代码和证据。
GitHub 发布:访问稳定版本和开发历史。
如何使用 Open ETF Agent?
安装 Node.js:确保安装 Node.js 26.8.1–26.x 和 npm。
克隆仓库:从 GitHub 获取 Open ETF Agent 源代码。
安装依赖:运行 `npm install` 来设置项目依赖。
本地运行:执行 CLI 命令以生成报告和记录。
阅读报告:打开 `runs/` 目录中的 `report.md` 以检查输出。
检查代码:查看每个模块和版本的源代码。
探索模块:按照阅读地图理解代理机制和边界。
Open ETF Agent的使用案例
- 代理架构研究
- 可验证的 AI 开发
- 提示注入防御
- 代理中的上下文管理
- 本地 AI 代理原型开发
- PDF 内容处理
- 持久的人机交互
- 开源项目贡献





