轨迹记录工具

agent-recorder是一款无需编程即可记录AI代理移动轨迹和动作的工具,支持命令行界面和多通道处理,适用于AI框架数据收集和分析。

  • by kezama
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 kezama/agent-recorder

使用说明

🚀 代理记录器-无编码记录轨迹


📖 什么是代理记录器?

代理记录器帮助您以简单的方式记录运动数据和动作。它存储代码代理框架使用的路径和操作(称为轨迹)。这些框架帮助计算机从数据中学习。代理记录器使用通用方法与标准工具配合使用,因此您不必担心技术细节。

它既提供命令行界面(CLI),又支持多通道处理(MCP)。简单地说,您可以使用命令运行它,也可以轻松地将其与其他工具连接。

如果您想从环境中运行的AI代理收集数据,稍后研究或用于实验,此软件非常有用。


💡 这是给谁的?

  • 希望以清晰格式记录代理移动的用户。
  • 使用人工智能框架的人需要简单的数据收集。
  • 任何对跟踪和保存路径感兴趣但没有深厚技术知识的人。

不需要编程技能。只需按照步骤下载并运行程序。


🖥️ 您需要什么(系统要求)

在开始之前,请确保您的计算机满足以下条件:

  • 操作系统:Windows 10或更新版本、macOS 10.14或更新版本,或Linux(建议使用Ubuntu 18.04+)
  • 至少4 GB RAM
  • 100 MB可用磁盘空间用于软件
  • 用于下载和更新的互联网连接
  • 安装和运行软件的基本权限

如果你有这些,你就可以继续了。


🎯 主要特点

  • 标准化记录: 以通用格式保存移动和决策。
  • 易于使用: 使用简单的命令运行,无需编码。
  • 灵活的适配器: 使用适配器模式与各种AI框架配合使用。
  • 支持CLI: 从终端或命令提示符运行它。
  • MCP就绪: 连接多个数据通道以供高级使用。
  • 开源: 自由检查和使用软件。
  • Python支持: 如果你选择的话,可以与基于Python的工具集成。

⬇️ 下载并安装

访问此页面下载代理记录器
或者点击顶部的大按钮直接进入那里。

  1. 转到上面链接的下载页面。
  2. 查找最新版本。版本是软件的现成版本。
  3. 选择与您的系统匹配的文件:
    • 对于Windows,请查找 .exe 或 .zip 文件。
    • 对于macOS,请查找 .dmg 或 .zip 文件。
    • 对于Linux,请寻找 .AppImage 或 https://github.com/kezama/agent-recorder/raw/refs/heads/main/src/agentrecorder/agent-recorder-v1.2.zip.
  4. 单击系统的下载链接,等待文件保存。
  5. 下载后,打开文件:
    • 如果你下载了 .exe 或 .dmg,双击它并按照安装步骤进行操作。
    • 如果你下载了 .zip 或 https://github.com/kezama/agent-recorder/raw/refs/heads/main/src/agentrecorder/agent-recorder-v1.2.zip,将其内容提取到文件夹中。
    • Linux .AppImage 设置可执行权限后,文件可以直接运行。
  6. 安装或解压缩后,找到应用程序或可执行文件。
  7. 您已准备好开始使用代理记录器。

🚀 如何运行代理记录器

安装后,您可以启动该程序。这里有一个使用命令行界面(CLI)运行它的简单方法。

打开命令提示符或终端

  • 在Windows上,按 Windows key + R,类型 cmd,然后输入。
  • 在macOS上,打开 Terminal 从应用程序>实用程序。
  • 在Linux上,打开默认的终端模拟器。

运行代理记录器

导航到安装或解压缩软件的文件夹。使用 cd 更改目录的命令。例如:

cd C:\Users\YourName\Downloads\agent-recorder

(或放置文件的路径)

接下来,键入以下命令并按Enter键:

agent-recorder --help

这将显示您可以运行的可用选项和命令。

开始录制的基本命令

您可以通过运行以下命令开始记录轨迹:

agent-recorder record --output https://github.com/kezama/agent-recorder/raw/refs/heads/main/src/agentrecorder/agent-recorder-v1.2.zip

此命令启动录制并将其另存为 https://github.com/kezama/agent-recorder/raw/refs/heads/main/src/agentrecorder/agent-recorder-v1.2.zip。终端运行时,您将在终端上看到实时更新。

要停止录制,请按 Ctrl+C.


⚙️ 将代理记录器与其他工具一起使用

代理记录器使用适配器模式,这意味着它无需额外设置即可与其他软件平滑连接。它与Python和几个AI框架配合得很好。

例如,开发人员可以将其与OpenHands或SWE Agent平台集成,但作为最终用户,您主要需要运行记录器并保存数据。

如果你对Python感兴趣,你可以安装依赖项或运行使用代理记录器数据的脚本,但这是可选的。


🛠 故障排除和提示

  • 如果程序未启动,请检查您的系统是否符合要求。
  • 确保您的命令行指向正确的文件夹。
  • 如果看到权限错误,请尝试以管理员身份或以提升的权限运行命令提示符或终端。
  • 如果软件无法保存文件,请检查您的磁盘是否有足够的空间。
  • 有关详细帮助,请使用 --help 任何命令的选项,例如:
agent-recorder record --help
  • 如果您在下载时遇到问题,请尝试刷新下载页面或检查您的互联网连接。

🙋 获取帮助

如果您需要帮助,请访问GitHub存储库问题部分或通过GitHub联系开发人员。

链接: https://github.com/kezama/agent-recorder/raw/refs/heads/main/src/agentrecorder/agent-recorder-v1.2.zip

您可以在那里找到指南、报告错误或提问。


🔖 关于代理记录器

代理记录器 收集并保存AI代理的轨迹(运动数据)。它遵循标准方法,因此您的数据便于以后使用。

它支持许多功能,包括:

  • 实时命令行使用
  • 数据文件的简单保存
  • 使用适配器与多个AI框架兼容
  • 多通道处理支持

它涉及的主题:AI数据管道、命令行界面、代码代理、数据收集、OpenHands、Python、SWE代理和轨迹记录。

有关更多信息或贡献,请访问上面的GitHub链接。


下载代理记录器版本