forked from xiaohei/taiji-pda-v0
Revise README for Taiji AI Agent platform
Updated project overview and core technology sections to reflect new branding and features.
This commit is contained in:
Fasthei
@@ -1,155 +1,177 @@
|
||||
# Agent 赋能平台：全栈工程架构与实施
|
||||
# 太极 AI Agent 赋能平台 (Taiji AI PDA)
|
||||
|
||||
## 📌 项目概述
|
||||
<div align="center">
|
||||
|
||||
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 确保租户数据安全 。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
**企业级 AI Agent 管理与分发平台前端**
|
||||
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## 📋 项目简介
|
||||
|
||||
太极 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 计费引擎的配置示例？
|
||||
<div align="center">
|
||||
<sub>Built with ❤️ by Taiji Team</sub>
|
||||
</div>
|
||||
|
||||
Reference in New Issue
Block a user