AgentEvalTool/docs
sinohqb 1aa453ef0a feat(intelligent-eval): add cron pool data model and task queue API
Implement Ticket 01 of intelligent eval cron pool architecture (ADR-0007):

- Add 4 new tables: task_queue, cron_pool, config_snapshots, decision_logs
- Implement task enqueueing logic with priority calculation
- Implement task assignment and completion APIs
- Add unit tests (9) and integration tests (7)
- Update CONTEXT.md with new vocabulary
- Add ADR-0007 documenting cron pool architecture decision

All 760 tests passing.
2026-08-12 02:13:21 +08:00
..
adr feat(intelligent-eval): add cron pool data model and task queue API 2026-08-12 02:13:21 +08:00
agents docs(deploy): record production access topology 2026-08-09 03:49:06 +08:00
api-reference v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
archive release: normalize project version to v1.0.0 2026-08-11 14:07:05 +08:00
deployment release: normalize project version to v1.0.0 2026-08-11 14:07:05 +08:00
external-references/tutu-api v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
guides v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
architecture-v1.0.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
data-models-v1.0.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
dev-log-20260715.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
evaluation-workflow.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
plan-v0.3.md feat(models): add centralized model configuration 2026-07-17 20:02:43 +08:00
plan-v0.4.md docs(release): v0.4「联」发布说明与里程碑收尾 2026-07-28 17:41:20 +08:00
README.md release: normalize project version to v1.0.0 2026-08-11 14:07:05 +08:00
release-notes-v0.2.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00
release-notes-v0.3.md docs(release): add v0.3 release notes and minimal CI baseline 2026-07-27 16:51:45 +08:00
release-notes-v0.4.md docs(release): v0.4「联」发布说明与里程碑收尾 2026-07-28 17:41:20 +08:00
release-notes-v0.5.md docs(release): v0.5「准」发布说明与里程碑收尾 2026-07-29 15:43:15 +08:00
release-notes-v0.6.md docs(release): freeze v0.6「巡」/ v0.7「析」milestone as 0.7.0 2026-08-03 02:42:47 +08:00
release-notes-v0.7.md docs(release): freeze v0.6「巡」/ v0.7「析」milestone as 0.7.0 2026-08-03 02:42:47 +08:00
release-notes-v0.8.md docs(release): freeze v0.8「比」period comparison milestone as 0.8.0 2026-08-03 15:24:07 +08:00
release-notes-v1.0.md release: normalize project version to v1.0.0 2026-08-11 14:07:05 +08:00
release-notes-v1.1.md release: normalize project version to v1.0.0 2026-08-11 14:07:05 +08:00
requirements-v1.0.md v0.2.0-dev: 文件管理 + 页面布局统一 + 6 个 bug 修复 2026-07-16 15:25:22 +08:00

AgentEvalTool 文档索引

文档版本: v1.1 项目版本: v1.0.0 日期: 2026-08-11 状态: 已发布 作者: AgentEval Team


一、简介

AgentEvalTool 是一个智能体质量评估工具集平台,用于评估 AI 数字员工(大模型 + RAG和 AI 助手OpenClaw的服务质量、效率与安全性。

本文档集提供完整的项目文档包括需求分析、架构设计、API 参考、部署指南和使用指南。

二、文档目录

2.1 核心文档

文档 说明 链接
需求分析 项目背景、功能需求、验证标准 requirements-v1.0.md
架构设计 系统架构、核心抽象、项目结构 architecture-v1.0.md
数据模型 数据库表结构、模型关系 data-models-v1.0.md

2.2 API 参考

文档 说明 链接
CLI 命令参考 所有 CLI 命令的详细用法 api-reference/cli-v1.0.md
Web API 参考 REST API 接口文档 api-reference/web-api-v1.0.md

2.3 部署文档

文档 说明 链接
部署概览 部署方式、环境要求、运维指南 deployment/README.md
t480 部署指南 t480 测试服务器具体部署步骤 deployment/t480-v1.0.md
volcengine-102 部署指南 正式线发布、验证与回滚 deployment/volcengine-102-v1.0.md

2.4 使用指南

文档 说明 链接
快速开始 5 分钟完成首次评测 guides/quick-start-v1.0.md
用户使用指南 详细功能说明和最佳实践 guides/user-guide-v1.0.md

2.5 版本发布说明

文档 说明 链接
V1.0.0 发布说明 双评测体系、耐久 Campaign、架构深化与双线部署 release-notes-v1.0.md
V0.8 发布说明 Campaign 周期对比与正式线演进基线 release-notes-v0.8.md
V0.2 发布说明 async 引擎、安全基线、测试基线、部署规范化 release-notes-v0.2.md
历史 V1.1 编号文档 早期原型阶段编号,不代表当前 SemVer release-notes-v1.1.md

2.6 开发日志

文档 说明 链接
v0.3.0 开发计划 模型配置中心、统一模型调用与旧配置迁移 plan-v0.3.md
2026-07-15 评测执行页改版 布局修复、Tab 滚动、时区 Bug、时间过滤、UI 全面改版 dev-log-20260715.md

2.6 阶段归档

文档 说明 链接
归档索引 已验收阶段的目标、决策、证据与后续约束 archive/README.md
Campaign 架构深化 耐久作业、读模型、运行时和正式线交付总结 archive/campaign-architecture-deepening-20260811-v1.0.md

2.7 外部参考

文档 说明 位置
tutu-api 参考 tutu-api 接口文档 docs/external-references/tutu-api/

三、快速导航

3.1 我是新用户

  1. 阅读 快速开始指南
  2. 安装并配置项目
  3. 完成首次评测
  4. 阅读 用户使用指南 了解更多功能

3.2 我是开发者

  1. 阅读 架构设计文档 了解系统设计
  2. 阅读 数据模型文档 了解数据结构
  3. 参考 CLI 命令参考Web API 参考
  4. 查看源代码和测试用例

3.3 我是运维人员

  1. 阅读 部署概览
  2. 参考具体服务器的部署指南(如 t480 部署指南
  3. 了解日常运维和故障排查

3.4 我要集成 OpenClaw

  1. 阅读 架构设计文档 的 OpenClaw 集成章节
  2. 参考 CLI 命令参考 的 OpenClaw 集成示例
  3. 查看 backend/plugins/openclaw/ 目录的插件示例

四、版本说明

  • 当前版本: v1.0.0
  • 版本基线日期: 2026-08-11
  • 状态: 已部署t480 开发线、volcengine-102 正式线)

所有文档均标注版本号,便于追踪和管理。当前发布说明见 release-notes-v1.0.md

五、文档规范

5.1 版本管理

  • 文件名包含版本号(如 architecture-v1.0.md
  • 文档头部包含版本元数据
  • 重大变更时更新版本号

5.2 文档结构

每个文档包含:

  • 版本元数据(版本、日期、状态、作者)
  • 清晰的章节结构
  • 代码示例和配置说明
  • 故障排查和最佳实践

5.3 更新流程

  1. 修改文档内容
  2. 更新版本号和日期(如有必要)
  3. 更新本文档索引(如有新增文档)
  4. 提交代码审查

六、反馈与支持

如有文档问题或建议:

  • 提交 Issue
  • 联系 AgentEval Team

最后更新: 2026-08-11