Tổng quan kiến trúc

Trang này cung cấp tổng quan kỹ thuật về kiến trúc nền tảng FAOS cho lập trình viên và người ra quyết định kỹ thuật.

Kiến trúc cấp cao

┌─────────────────────────────────────────────────────────────────┐
│                        FAOS Platform                            │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐             │
│  │   Web UI    │  │  Mobile App │  │   CLI/SDK   │  Clients    │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘             │
│         │                │                │                     │
│  ┌──────▼────────────────▼────────────────▼──────┐             │
│  │              API Gateway (Kong)               │  Edge       │
│  └──────────────────────┬────────────────────────┘             │
│                         │                                       │
│  ┌──────────────────────▼────────────────────────┐             │
│  │           Core Services (Microservices)        │             │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐          │  Services   │
│  │  │  Agent  │ │Workflow │ │ Memory  │          │             │
│  │  │ Engine  │ │ Engine  │ │  Store  │  ...     │             │
│  │  └─────────┘ └─────────┘ └─────────┘          │             │
│  └──────────────────────┬────────────────────────┘             │
│                         │                                       │
│  ┌──────────────────────▼────────────────────────┐             │
│  │              Data Layer                        │             │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐          │  Data       │
│  │  │PostgreSQL│ │  Redis  │ │  S3     │          │             │
│  │  └─────────┘ └─────────┘ └─────────┘          │             │
│  └───────────────────────────────────────────────┘             │
└─────────────────────────────────────────────────────────────────┘

Tech stack

FAOS được xây trên stack 100% mã nguồn mở (giấy phép MIT/Apache 2.0):

Lớp	Công nghệ	Giấy phép
Frontend	React, Tailwind CSS, AG-UI	MIT
API Gateway	Kong	Apache 2.0
Backend	Node.js, Python	MIT
Database	PostgreSQL	PostgreSQL License
Cache	Redis	BSD
Message Queue	RabbitMQ	MPL 2.0
Container	Docker, Kubernetes	Apache 2.0
Observability	OpenTelemetry, Grafana	Apache 2.0

Thành phần cốt lõi

Agent Engine

Agent Engine là bộ não của FAOS, chịu trách nhiệm:

• Điều phối LLM (Claude, GPT, mô hình local)
• Thực thi tool
• Quản lý memory
• Thực thi guardrail

interface AgentEngine {
  process(request: AgentRequest): Promise<AgentResponse>;
  executeTool(tool: string, params: object): Promise<ToolResult>;
  checkGuardrails(action: Action): GuardrailResult;
}

Workflow Engine

Quản lý việc thực thi workflow nhiều bước:

• Định nghĩa workflow dạng DAG
• Thực thi song song và tuần tự
• Retry và xử lý lỗi
• Lưu trạng thái bền vững

Memory Store

Cung cấp memory bền vững cho agent:

• Vector embedding cho tìm kiếm ngữ nghĩa
• Đồ thị quan hệ thực thể
• Lịch sử hội thoại
• Chia sẻ tri thức xuyên agent

Event Bus

Kích hoạt giao tiếp thời gian thực:

• Nhắn tin agent-to-agent
• Gửi thông báo cho người dùng
• Webhook tích hợp
• Ghi audit log

Mô hình triển khai

Cloud (Managed)

Triển khai SaaS do FAOS quản lý:

• Kiến trúc multi-tenant
• Tự động mở rộng
• Không cần bảo trì

Self-Hosted

Triển khai trên hạ tầng của bạn:

• Cô lập single-tenant
• Tuân thủ chủ quyền dữ liệu
• Chính sách bảo mật tùy chỉnh

Hybrid

Kết hợp ưu điểm của cả hai:

• Control plane trên cloud
• Data plane on-premises
• Kết nối qua secure tunnel

Kiến trúc bảo mật

Cô lập multi-tenant

┌─────────────────────────────────────┐
│           Tenant A                  │
│  ┌─────────┐  ┌─────────┐          │
│  │  Data   │  │  Agents │          │
│  └─────────┘  └─────────┘          │
├─────────────────────────────────────┤ ← Network Isolation
│           Tenant B                  │
│  ┌─────────┐  ┌─────────┐          │
│  │  Data   │  │  Agents │          │
│  └─────────┘  └─────────┘          │
└─────────────────────────────────────┘

Năng lực bảo mật

• Authentication: OAuth 2.0, SAML, OIDC
• Authorization: RBAC với phân quyền chi tiết
• Encryption: TLS 1.3, AES-256 at rest
• Audit: Ghi log đầy đủ mọi hành động
• Compliance: Sẵn sàng SOC 2, GDPR, HIPAA

Khả năng mở rộng

FAOS được thiết kế cho quy mô doanh nghiệp:

Chỉ số	Năng lực
Agent đồng thời	10.000+
Request/giây	50.000+
Độ trễ message	< 100ms p99
Lưu trữ dữ liệu	Không giới hạn

Kiến trúc tích hợp

MCP (Model Context Protocol)

FAOS dùng MCP của Anthropic để chuẩn hóa tích hợp tool:

const server = new MCPServer({
  name: "my-integration",
  tools: [
    {
      name: "search_crm",
      description: "Search CRM records",
      inputSchema: { /* JSON Schema */ },
      handler: async (input) => { /* Implementation */ }
    }
  ]
});

Webhook

Nhận sự kiện thời gian thực:

{
  "event": "agent.action.completed",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "agentId": "agent_abc123",
    "action": "send_email",
    "result": "success"
  }
}

---

Bước tiếp theo

• Tham chiếu API - Tài liệu API chi tiết
• Thiết lập Enterprise - Triển khai self-hosted
• Hướng dẫn bảo mật - Cấu hình bảo mật