面向二次开发与企业落地的 AI Agent 平台底座，采用平台控制面与 LangGraph Runtime 解耦架构，提供认证、项目管理、审计、MCP 工具接入等完整平台治理能力。
ai-agent-platform 是一套面向二次开发与企业落地的 AI Agent 平台底座，基于 LangGraph / LangChain 构建企业级 AI 平台架构。项目采用平台控制面与 Agent Runtime 解耦的核心设计，将平台治理层（认证、项目管理、审计、catalog 管理）与 Agent Runtime 执行层（图编排、模型装配、Tools/MCP/Skills 接入）分离，支持独立演进和分工协作。
平台默认包含四个正式服务：interaction-data-service（结果域数据服务）、platform-api（平台后端控制面 API）、platform-web（平台前端控制台）、runtime-service（LangGraph Agent Runtime），另提供 runtime-web 作为直连 Runtime 的调试前端。前端基于 Vue 3 + TypeScript + Vite 构建，后端基于 FastAPI，Runtime 基于 LangGraph / LangChain，MCP 工具接入基于 FastMCP。
项目提供一整套受控的 AI 持续编程 Harness（边界、契约、范式、闭环），指导 AI 代理在明确边界内持续开发、联调与验收，并支持通过自然语言指令触发 AI 代理自动化部署环境。以测试工程为初始切入场景，已验证 AI 智能评审、AI 驱动 UI 自动化、Text-to-SQL、多智能体协作等业务场景。
部署方面支持本地脚本一键启动和三种 Docker Compose 模式（仅 Runtime、整仓无 Nginx、整仓带 Nginx），模型配置支持 OpenAI 兼容 API。平台提供双链路设计——平台链路（platform-web → platform-api → runtime-service）与调试链路（runtime-web → runtime-service）并行运行。
架构分层：
┌─────────────────────────────────────────────┐
│ 平台控制面 │
│ ┌──────────┐ ┌──────────────┐ │
│ │platform-web│→│platform-api │ │
│ └──────────┘ └──────────────┘ │
├─────────────────────────────────────────────┤
│ Agent Runtime 执行层 │
│ ┌──────────────┐ ┌─────────────────────┐ │
│ │runtime-service│ │runtime-web（调试） │ │
│ └──────────────┘ └─────────────────────┘ │
├─────────────────────────────────────────────┤
│ 结果域数据服务 │
│ ┌───────────────────────────┐ │
│ │interaction-data-service │ │
│ └───────────────────────────┘ │
└─────────────────────────────────────────────┘
默认本地端口：
- interaction-data-service: 8081
- runtime-service: 8123
- platform-api: 2142
- platform-web: 3000
- runtime-web（可选）: 3001
快速启动：
scripts/dev-up.sh # 启动全部服务
scripts/check-health.sh # 健康检查
scripts/dev-down.sh # 停止
待确认信息：开源许可证类型、Python 具体版本要求、interaction-data-service 底层数据库类型、Windows 兼容性、多模态模型配置范围、认证方式细节、各服务横向扩展能力。