diff --git a/README.md b/README.md index 30384fa..4ce751f 100644 --- a/README.md +++ b/README.md @@ -1,155 +1,177 @@ -# Agent 赋能平台：全栈工程架构与实施 +# 太极 AI Agent 赋能平台 (Taiji AI PDA) -## 📌 项目概述 +
-Agent 赋能平台是一个旨在将 AI Agents 从实验性脚本演进为工业级生产力单元的全栈工程化平台 。平台通过构建标准化的智力资源分发与治理体系，整合异构数据，支持多模型动态切换，并具备透明的计费与安全隔离机制 。 - -## 🏗 五大核心技术平面 - -### 第一平面：全域数据接入与工具化治理 - -核心目标是将异构 API 资源转化为 Agent 可理解、可调用的标准“工具集” 。 - -* -**LLM-Ready API 转换**：集成 RapidAPI 生态，利用超过 16,000 个 API 提供全领域能力 。 - - -* -**APILLAMA 技术**：采用微调的 Llama-3-8B-Instruct 模型，通过软提示技术将 API 文档转换为 Pydantic 或 JSON Schema 规范 。 - - -* -**语义增强**：通过详尽的操作摘要和描述字段，消除 Agent 在参数构造时的“幻觉”现象 。 - - - -### 第二平面：模型抽象层与动态治理 - -作为平台的“大脑指挥部”，负责屏蔽底层模型差异并确保高可用性 。 - -* -**统一网关**：集成 LiteLLM 代理网关，提供与 OpenAI 兼容的统一端点，支持超过 100 个模型 API 。 - - -* -**高可用路由**：支持模型组定义，实现自动负载均衡与跨服务商（如从 OpenAI 切换至 Anthropic）的故障转移 。 - - -* -**上下文管理**：自动处理不同模型的 token 限制，执行会话截断或总结逻辑 。 - - - -### 第三平面：单体 Agent 协议化封装 - -定义具有明确边界和原子化能力的 Agent 单元 。 - -* -**原子化设计**：每个 Agent 仅包含角色（Role）、目标（Goal）和授权工具集（Tools） 。 - - -* **通信协议支持**： -* -**MCP (Model Context Protocol)**：解决工具集成硬编码难题，支持 stdio 和 SSE 传输 。 - - -* -**A2A (Agent-to-Agent)**：通过 Agent Card（代理名片）实现代理间的发现、任务委派与工件交换 。 - - - - - -### 第四平面：以 MCP 为核心的本地编排 - -采用“MCP-First”策略，使平台服务能无缝集成至主流生态 。 - -* -**通用集成**：支持通过 MCP 协议直接接入 Cursor、Claude Desktop 等 IDE 和客户端 。 - - -* -**框架适配**：提供对 LangChain、CrewAI 和 Microsoft AutoGen 的原生适配器支持 。 - - - -### 第五平面：执行单元 (EU) 计费与治理 - -引入基于资源消耗的计费模型，解决 Token 计费的不确定性问题 。 - -* **EU 计费公式**： - - - - - - -* -**安全隔离**：利用 Firecracker (MicroVM) 或 gVisor 实施计算隔离，通过 RLS 确保租户数据安全 。 +![Next.js](https://img.shields.io/badge/Next.js-16.0-black?logo=next.js) +![React](https://img.shields.io/badge/React-19.2-61DAFB?logo=react) +![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript) +![Tailwind CSS](https://img.shields.io/badge/Tailwind-4.x-38B2AC?logo=tailwindcss) +**企业级 AI Agent 管理与分发平台前端** +
--- +## 📋 项目简介 + +太极 AI Agent 赋能平台是一个多租户、多角色的企业级 AI Agent 管理系统。平台支持超级管理员、渠道商、租户用户三级架构，提供完整的 Agent 生命周期管理、模型网关配置、资源分配与监控等功能。 + +## 🏗 系统架构 + +``` +┌─────────────────────────────────────────────────────────────┐ +│ 超级管理员 (Admin) │ +│ · 渠道管理 · 资源分配 · 平台监控 · 系统配置 │ +├─────────────────────────────────────────────────────────────┤ +│ 渠道商 (Channel) │ +│ · 租户管理 · 资源分配 · Agent 部署 · 使用统计 │ +├─────────────────────────────────────────────────────────────┤ +│ 租户用户 (Tenant) │ +│ · Agent 工厂 · 模型网关 · 数据工具 · 编排中心 │ +└─────────────────────────────────────────────────────────────┘ +``` + +## ✨ 核心功能 + +### 🔐 多级权限管理 +- **超级管理员**: 平台全局管理，渠道资源分配 +- **渠道管理员**: 租户管理，资源二次分配 +- **租户用户**: Agent 使用与自定义部署 + +### 🤖 Agent 工厂 +- 平台 Agent 一键部署 +- 自定义 Agent 创建与配置 +- K8s 资源配置 (CPU/内存) +- MCP 协议集成 + +### 🌐 模型网关 +- 多模型供应商支持 (OpenAI, Anthropic, DeepSeek 等) +- 统一 API 网关 +- 负载均衡与故障转移 +- 实时监控与日志 + +### 🔧 数据工具 +- API 工具管理 +- 自定义 Agent 部署 +- 工具市场集成 + +### 📊 资源监控 +- 实时资源使用统计 +- Agent 运行状态监控 +- 调用量与性能分析 + +### 🌍 国际化支持 +- 中文/英文双语界面 +- 一键切换语言 + ## 🛠 技术栈 -* -**模型/提取**：Llama-3-8B, APILLAMA +| 类别 | 技术 | +|------|------| +| **框架** | Next.js 16, React 19 | +| **语言** | TypeScript 5 | +| **样式** | Tailwind CSS 4, Radix UI | +| **状态管理** | React Context | +| **表单处理** | React Hook Form, Zod | +| **图表** | Recharts | +| **工具库** | date-fns, Lucide Icons | +## 🚀 快速开始 -* -**网关/治理**：LiteLLM, Pomerium +### 环境要求 +- Node.js >= 20.9.0 +- npm 或 pnpm -* -**协议**：MCP, A2A, JSON-RPC 2.0 +### 安装依赖 +```bash +# 使用 npm +npm install -* -**基础设施**：Firecracker, NATS, Golang +# 或使用 pnpm +pnpm install +``` +### 环境配置 -* -**监控**：Datadog, Prometheus, LangSmith +创建 `.env.local` 文件： +```env +# API 服务地址 +NEXT_PUBLIC_DATA_INGESTION_URL=http://localhost:8002 +NEXT_PUBLIC_MCP_SERVER_URL=http://localhost:8002 +NEXT_PUBLIC_API_GATEWAY_URL=http://localhost:8002 +``` +### 启动开发服务器 + +```bash +npm run dev +``` + +访问 [http://localhost:3000](http://localhost:3000) + +### 构建生产版本 + +```bash +npm run build +npm run start +``` + +## 📁 项目结构 + +``` +taiji-pda-v0/ +├── app/ # Next.js App Router +│ ├── admin/ # 超级管理员模块 +│ │ ├── dashboard/ # 管理控制台 +│ │ └── login/ # 管理员登录 +│ ├── channel/ # 渠道商模块 +│ │ ├── dashboard/ # 渠道控制台 +│ │ └── login/ # 渠道商登录 +│ ├── agent-factory/ # Agent 工厂 +│ ├── model-gateway/ # 模型网关 +│ ├── data-tools/ # 数据工具 +│ ├── orchestration/ # 编排中心 +│ ├── billing/ # 计费管理 +│ └── login/ # 租户登录 +├── components/ # 可复用组件 +│ ├── ui/ # UI 基础组件 +│ └── ... # 业务组件 +├── contexts/ # React Context +├── hooks/ # 自定义 Hooks +├── lib/ # 工具库 +│ ├── api-client.ts # API 客户端 +│ └── auth.ts # 认证工具 +├── styles/ # 全局样式 +└── docs/ # 项目文档 +``` + +## 🔗 API 端点 + +平台对接三个主要后端服务： + +| 服务 | 用途 | 默认地址 | +|------|------|----------| +| MCP Server | Agent 管理、用户认证 | `localhost:8002` | +| Data Ingestion | 数据接入服务 | `localhost:8002` | +| API Gateway | 模型网关服务 | `localhost:8002` | + +## 📝 开发规范 + +- 使用 TypeScript 严格模式 +- 遵循 ESLint 代码规范 +- 组件采用函数式写法 +- 使用 Tailwind CSS 原子类 + +## 📄 许可证 + +私有项目 - 保留所有权利 --- -## 🚀 快速集成 - -平台 Agent 支持多种集成方式： - -| 集成对象 | 实现方式 | -| --- | --- | -| **LangChain** | 使用 `langchain-mcp-adapters` 初始化 `MultiServerMCPClient` - - | -| **CrewAI** | 在 Agent 类中配置 `mcps` 字段指向 SSE URL - - | -| **AutoGen** | 使用 `StdioMcpToolAdapter` 封装 Action 单元 - - | -| **IDE (Cursor)** | 直接添加标准的 MCP 服务器端点 - - | - ---- - -## 🔮 未来规划 - -* -**自治成本优化**：开发元调度器自主选择最经济的模型+工具组合 。 - - -* -**跨代理信誉体系**：建立基于任务完成率的信任评分机制 。 - - -* -**异构计算卸载**：实现任务在端侧设备与云端集群间的动态分配 。 - - - -您是否需要我为您编写具体的 MCP 服务器部署脚本或 EU 计费引擎的配置示例？ \ No newline at end of file +
+ Built with ❤️ by Taiji Team +