PowerCore 介绍¶

读者对象：管理员、进阶用户、Agent 开发者
预计阅读时间：1 小时
版本：v0.1 | 2026-08-13

1. AI Power 平台架构¶

1.1 整体组成¶

AI Power（后端 aipower）+ PE Agent Front（前端）构成完整平台：

┌──────────────────────────────────────────────┐
│           PE Agent Front（Web UI）            │
│  对话 / Agent编排 / 工具 / 知识库 / 管理      │
└────────────────────┬─────────────────────────┘
                     │ REST API / WebSocket
┌────────────────────▼─────────────────────────┐
│              aipower（FastAPI）               │
│  Butler / Agent引擎 / LLM / GraphRAG / Skill │
└────────────────────┬─────────────────────────┘
                     │
        ┌────────────┼────────────┐
        ▼            ▼            ▼
     MySQL        LLM API     GraphRAG 服务

1.2 技术栈¶

组件	技术
后端	FastAPI + Python 3.10+
前端	Vue 3 + TypeScript + Element Plus
数据库	MySQL + SQLAlchemy 异步 ORM
认证	JWT
实时通信	WebSocket
LLM	多模型兼容 OpenAI API 格式

2. 功能模块地图¶

模块	前端入口	核心能力
对话与任务	记录 / 新建	Butler 规划、多 Agent 执行、任务历史
Agent 编排	Agent	节点工作流、Prompt、工具绑定、调试
工具	工具	插件（Python 等）、MCP 服务
知识库	知识库	文档上传、GraphRAG 索引、图谱、RAG 问答
SKILL	Agent Prompt 中引用	可复用领域能力包
咒语	Prompt / LLM 输出	平台扩展 XML 标签
管理	/ad	用户、模型、审核
开放 API	CLI / HTTP	程序化调用 Agent

3. 核心工作流¶

3.1 任务执行流¶

用户输入
  → Butler 分析拆解
  → 用户确认规划
  → 依次调度 Agent
  → 各 Agent 按节点执行（LLM + Tool + 咒语）
  → 汇总结果

3.2 Agent 执行流¶

Head 节点
  → Normal 节点（Prompt 预处理 → LLM 调用 → 输出后处理/咒语）
  → ... 更多 Normal 节点
  → End 节点（格式化输出 / 下载）

3.3 SKILL 加载流¶

系统 Prompt 注入 Skill 元数据（第 1 层）
  → LLM 决定需要哪个 Skill
  → read_file 读取 SKILL.md（第 2 层）
  → 按需读取 references/scripts（第 3 层）

4. 数据与权限模型¶

4.1 隐私级别¶

所有主要资源支持：

级别	值	说明
个人	`Personal`	仅创建者
公开	`Public`	全员可用

4.2 用户个人空间¶

路径	内容
`documents/{手机号}/`	用户上传与个人文档
`skills/skills/`	SKILL 文件（个人/公共）

4.3 审核机制¶

知识库分享：Personal → 申请 → 管理员审核 → Public
Agent / MCP / 插件：创建者直接设 Public，无审核

5. 开放 API¶

5.1 基础信息¶

认证：登录获取 JWT access_token
请求头：Authorization: Bearer <token>

5.2 主要接口¶

接口	功能
`POST /peagent/login`	登录
Agent 列表 API	查询 Public/Personal Agent
Agent 调用 API	发起任务
任务状态 API	查询执行进度与结果

详细说明见 aipower/doc/AIPower 开放平台 API 文档.md。

5.3 CLI 工具 aiPower.py¶

python aiPower.py login --tel <手机号> --password <密码>
python aiPower.py list --token <token>
python aiPower.py call --token <token> --agent-id <id> --message "..."
python aiPower.py status --token <token> --task-id <id>

6. 管理员功能¶

访问 /ad（需管理员权限）：

功能	说明
用户管理	账号、权限
模型管理	可用 LLM 配置
消息中心	知识库分享审核等

7. 客户定制¶

平台支持多租户路径部署：

路径	说明
`/pe-agent/login`	PE Agent 登录
`/pe-agent`	主界面

后端可能有专用 API 前缀适配，版本 tag 参考 delta-0.0.x 系列。

8. 文档导航（按角色）¶

普通工程师¶

Agent 开发者¶

知识库维护者¶

增强检索（GraphRAG）

团队负责人 / 管理员¶

共享方案
管理工具使用
本文档（架构与权限）

9. 术语对照¶

中文	英文	说明
管家	Butler	任务规划 AI
智能体	Agent	工作流执行单元
节点	Node	Agent 内步骤
插件	Tool / Plugin	可调用工具
技能	SKILL	领域能力包
咒语	Spell	扩展 XML 标签
隐私级别	privacy_level	Personal / Public

10. 附录¶

系统设计详情：aipower/doc/AIPower设计文档.html
API 文档：aipower/doc/AIPower 开放平台 API 文档.md
SKILL 技术方案：aipower/app/skills/技术方案.txt