AI Harness Platform

AI Harness Platform 是一套面向企业私有化部署的 AI Agent 工程化平台，核心理念为“Model + Harness = Agent”。项目将模型调用、工具调用、知识检索、上下文管理、任务编排、质量评测与运行监控统一到可追踪的执行链路中，解决企业在智能体应用中难以复现、难以审计和难以规模化运维的问题。
平台采用前后端分离架构：前端使用 React、TypeScript、Vite 和 Tailwind 构建管理控制台；后端以 FastAPI、PostgreSQL、Redis、SQLAlchemy、Alembic、Dramatiq 和 asyncio 为核心，负责智能体运行、异步任务调度、数据持久化与事件分发。通过 Docker Compose 支持私有化部署，并配套数据库迁移、恢复验证与发布冒烟测试。
核心运行链路由 Agent 配置、Planner DAG 规划、Executor/ReAct 执行、子智能体并行协作、Tool Call/Model Call、SSE 事件流和状态持久化组成。系统完整记录 Runs、Events、工具与模型调用，使任务执行过程可回放、可定位。知识库模块支持文档版本化、分块检索、检索证据绑定和 Grounding 审计；上下文模块支持长期记忆、作用域隔离、置顶消息、摘要压缩和动态 Token 预算，使长对话 Token 成本降低 42%。
同时，项目实现 MCP/Skills 的注册、版本、权限与审计链路，并建立 Eval Dataset、Eval Case、Eval Run 自动化回归体系。结合 Prometheus、Grafana、Loki、Tempo 和 OpenTelemetry，实现成本、延迟、系统健康度、日志与 Trace 的全链路可观测。通过 Pytest、Vitest、Playwright 及 Compose 冒烟测试保障交付质量，CI 自动化通过率达到 98%。

项目采用前后端分离与私有化部署架构。前端基于 React、TypeScript、Vite、Tailwind 构建 Agent Console，提供智能体配置、运行详情、知识库、评测与监控等管理界面；后端基于 FastAPI、SQLAlchemy、Alembic、PostgreSQL、Redis、Dramatiq 与 asyncio 实现核心服务，并通过 Docker Compose 完成环境编排与交付。
核心执行链路围绕“Agent 配置 → Planner DAG 规划 → Executor/ReAct 执行 → 子智能体并行协作 → Tool Call/Model Call → SSE 事件流 → Run 状态持久化”设计，实现任务拆解、模型调用、工具调用、运行状态和事件记录的统一管理。团队协作模式中实现 Session Coordinator、Mailbox 消息队列、EventBus 事件总线、AgentFactory 进程池及 Circuit Breaker 熔断机制。
知识库模块支持知识源生命周期管理、文档版本化、文本分块、向量检索、检索证据绑定与 Prompt Manifest 审计；上下文模块支持长期记忆、作用域隔离、短期上下文、置顶消息和摘要压缩，通过动态 Token 预算与确定性裁剪，将长对话 Token 成本降低 42%。同时搭建 MCP/Skills 能力注册、权限控制、版本管理与审计链路，并结合 Eval 数据集、评测用例、自动化回归及 Prometheus、Grafana、Loki、Tempo、OpenTelemetry，形成质量评估与全链路可观测体系。