AgenticX Enterprise 文档中心

基于 enterprise/ 全量代码整理。最后更新：2026-05-21

Enterprise 是企业级大模型应用一体化平台，由 员工前台（web-portal）、管理后台（admin-console）、AI 网关（gateway） 三端联动，共享 Postgres 多租户数据层与统一 RBAC。

快速导航

文档目录

架构

• overview.md — 组件拓扑、Monorepo 结构、技术栈
• data-flow.md — 聊天、策略、审计、计量数据流
• cache-and-pricing.md — L1/L2 缓存与计费归一
• mcp-hosting.md — 网关内 MCP Host
• protocol-translation.md — OpenAI pivot 协议转换
• plugin-runtime.md — 规则包 / 工具包运行时

应用与模块

• apps/README.md — 四个可部署单元（portal / admin / gateway / edge-agent）
• features/README.md — 十个业务功能域及实现状态
• packages/README.md — 共享技术包

API 契约

• api/README.md — API 总索引
• api/web-portal.md — 前台 REST 路由
• api/admin-console.md — 后台 REST 路由
• api/gateway.md — Go 网关 OpenAI 兼容 API
• api/internal-api.md — Gateway ↔ Admin Internal API

网关

• gateway/overview.md — 路由、Channel 中继、配额、审计
• gateway/policy-engine.md — 三通道策略评估
• gateway/runtime-config.md — Provider / 配额 / 快照 PG 化
• gateway/keypool-pat-overview.md — Key 轮转、配额选择、PAT
• gateway/api-tokens.md — agx-pat- 创建与吊销
• gateway/mcp-hosting-overview.md — MCP 托管总览

数据与权限

• database/schema.md — Drizzle schema、22 张表、迁移策略
• rbac/scopes.md — Scope 注册表与角色模板

配置

• configuration/env-vars.md — 全量环境变量分组表

插件

• plugin-protocol/README.md — rule-pack / tool-pack / theme-pack manifest 规范

开发与测试

• development/local-dev.md — bootstrap / start-dev 工作流
• development/troubleshooting.md — 常见问题速查
• testing/README.md — E2E、视觉巡检、压测脚本
• ../scripts/README.md — 脚本参数详解

可观测性

• observability/README.md — Prometheus /metrics 与 Grafana 模板

部署与运维（已有）

• deployment/README.md — Docker 自托管 或 Vercel + 外部 Gateway
• deployment/local-selfhost.md
• deployment/vercel-env-checklist.md
• deployment/supabase-migration-guide.md
• runbooks/ — SSO、审计回灌、策略回滚、PostgreSQL DDL 锁等待、Channel 中继、MCP 托管、隧道 demo
• perf-baselines/README.md — 只存档手工压测摘要，仓库没有历史基线数字

决策记录

• adr/0001-oss-foundations-selection.md

验收与销售

• mvp-acceptance-checklist-v20260422.md
• sales/sso-demo-script.md

与 Machi Desktop 的关系

两条链路不混用。客户方案中「端侧闭环」应描述 Machi 本地后端，而非 apps/edge-agent（当前为 skeleton）。

成熟度图例（全文档通用）