# Aggrega

> Aggrega là một trình biên dịch mã nguồn mở cho hạ tầng dưới dạng mã: một bản mô tả YAML duy nhất về ứng dụng của bạn trở thành các tệp Kubernetes, Helm, Compose, Terraform hoặc CloudFormation mà bạn xem xét và sở hữu.

URL: https://aggrega.ai/vi/

## Mô tả kiến trúc một lần. Nhận mã hạ tầng cho từng nền tảng bạn vận hành.

Aggrega là một trình biên dịch mã nguồn mở cho hạ tầng dưới dạng mã: một bản mô tả YAML duy nhất về ứng dụng của bạn trở thành các tệp **Kubernetes**, **Helm**, **Compose**, **Terraform** hoặc **CloudFormation** mà bạn xem xét và sở hữu.

Đã xây dựng một agent bằng **LangGraph**, **CrewAI**, **n8n**, **Dify** và nhiều công cụ khác? Hãy nhập nó vào.

[Thiết lập cùng trợ lý AI của bạn](https://aggrega.ai/vi/#ai-assistant)[Bắt đầu nhanh](https://aggrega.ai/docs/vi/getting-started/)[Nhập dự án của bạn](https://aggrega.ai/vi/#import)

Linux và macOS

curl -fsSL https://aggrega.ai/install.sh | sh

Windows, trong PowerShell

irm https://aggrega.ai/install.ps1 | iex

Hai ví dụ khởi động nhanh, được xây dựng từng bước một: một tác tử AI chạy trên mô hình cục bộ, và một ứng dụng web dùng PostgreSQL. Mỗi bước hiển thị các tệp mà bước đó thay đổi cùng các dòng được thêm, lệnh aggrega build và các tệp mà bản build ghi ra.

### Làm việc cùng trợ lý AI của bạn

Dán prompt này vào một trợ lý có thể chạy lệnh, và nó sẽ cài đặt Aggrega, tự thêm skill Aggrega vào chính nó và kết nối với máy chủ MCP của Aggrega. Prompt yêu cầu trợ lý hỏi ý kiến bạn trước khi cài đặt bất cứ thứ gì.

Prompt

Hãy thiết lập Aggrega cho tôi, từng bước một, và cho tôi biết bạn đã chạy gì ở mỗi bước.

1. Chạy `aggrega version`. Nếu không tìm thấy lệnh, hãy hỏi tôi trước khi cài đặt Aggrega, rồi cài đặt nó cho người dùng của tôi bằng trình cài đặt chính thức: trên Linux hoặc macOS `curl -fsSL https://aggrega.ai/install.sh | sh`, trên Windows trong PowerShell `irm https://aggrega.ai/install.ps1 | iex`. Chạy lại `aggrega version`. Nếu trình cài đặt in ra một dòng cần thêm vào `PATH` của tôi, hãy cho tôi xem dòng đó.

2. Nếu `https://aggrega.ai/docs/ai-assistants/skill/` đưa ra cách cài đặt plugin Aggrega vào bạn, hãy hỏi tôi trước khi cài đặt, rồi cài đặt theo cách đó, hoặc cho tôi biết cần làm gì nếu đó là một bước tôi thực hiện trong giao diện của bạn. Plugin này thêm skill Aggrega và kết nối bạn với máy chủ MCP của Aggrega. Nếu không, hãy chạy `aggrega skills install --help` và tìm định danh của chính bạn trong danh sách mà lệnh in ra. Hỏi tôi xem tôi muốn có skill trong dự án này hay trong mọi dự án, rồi chạy `aggrega skills install --agent <your identifier>`, thêm `--global` cho mọi dự án. Nếu bạn không có trong danh sách, hãy bỏ qua việc cài đặt skill và nói rõ điều đó.

3. Nếu bạn đã cài đặt plugin, bạn đã được kết nối với máy chủ MCP của Aggrega. Nếu không, hãy tự kết nối với máy chủ MCP của Aggrega, tức là lệnh `aggrega mcp`, theo cách bạn thêm một máy chủ MCP, như `https://aggrega.ai/docs/ai-assistants/mcp-server/` mô tả cho bạn. Nếu bạn cần khởi động lại hoặc tải lại để nạp plugin hoặc máy chủ, hãy cho tôi biết cần làm gì.

4. Khi đã kết nối, hãy gọi tool `describe-capabilities` không kèm đối số và tóm tắt những gì nó liệt kê.

**Hiển thị toàn bộ prompt**

- **Skill** — Cho trợ lý biết vòng lặp soạn thảo diễn ra như thế nào, và yêu cầu nó lấy mọi câu trả lời về một schema hoặc một tệp từ binary aggrega.

- **Máy chủ MCP** — aggrega mcp cung cấp cho trợ lý các công cụ của Aggrega: scaffold, validate, build và các công cụ khác.

[Những gì thay đổi giữa các trợ lý](https://aggrega.ai/docs/vi/ai-assistants/set-up/)

### Cách hoạt động

Bạn mô tả ứng dụng, Aggrega ghi các tệp, và các công cụ bạn đang dùng sẽ triển khai chúng. Aggrega không bao giờ truy cập vào một cụm đang chạy hay một tài khoản đám mây.

Aggregate mô tả ứng dụng của bạn

Release thiết lập của một môi trường

Manifest cách xây dựng từng phần

aggrega build cùng đầu vào, cùng tệp

- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation

tệp bạn xem xét và sở hữu

Bên ngoài Aggrega

ArgoCD · Flux · Terraform triển khai những gì lệnh đã ghi ra

Aggrega dừng lại ở các tệp. Aggrega không bao giờ truy cập một cụm đang chạy hay một tài khoản đám mây; chính các công cụ của bạn triển khai những gì Aggrega đã ghi ra.

#### Mô tả ứng dụng

Một **Aggregate** đặt tên cho các **thành phần** của nó và cách chúng kết nối với nhau.

#### Chọn môi trường

Một **Release** điền các thiết lập của môi trường đó.

#### Chọn cách xây dựng từng phần

Một **Manifest** ánh xạ từng thành phần tới một **Recipe** cho nền tảng của bạn, chẳng hạn một Helm chart, một module Terraform hoặc một container.

#### Chạy aggrega build

Lệnh này ghi các tệp cho từng nền tảng: cùng một đầu vào cho ra **cùng các tệp**, mọi lúc.

#### Triển khai bằng công cụ của bạn

Những gì lệnh đã ghi ra được triển khai bởi **ArgoCD**, **Flux** hoặc **Terraform**.

### Những gì bạn có thể xây dựng

Bắt đầu từ một ví dụ có thể chạy được, hoặc từ các thành phần của danh mục.

#### Agent AI và gateway

Các agent được xây dựng bằng LangGraph, CrewAI, LlamaIndex, Dify, n8n và nhiều công cụ khác, đặt sau các gateway mô hình với ngân sách token, bộ nhớ đệm ngữ nghĩa, che giấu nhật ký và lá chắn chống prompt injection.

[Một agent đặt sau gateway với ngân sách token](https://aggrega.ai/docs/vi/language-reference/examples/envoy-ai-gateway-token-budget/)

#### Các khối lượng công việc truyền thống

Cơ sở dữ liệu, bộ nhớ đệm, message broker và quản lý danh tính, ví dụ PostgreSQL, MariaDB, Redis, Kafka và Keycloak.

[Một cơ sở dữ liệu PostgreSQL, triển khai theo ba cách](https://aggrega.ai/docs/vi/language-reference/examples/postgres-three-realizations/)

#### Features

Các khả năng bạn gắn theo từng môi trường mà không cần động đến ứng dụng, ví dụ lá chắn chống prompt injection, che dữ liệu nhạy cảm, ingress HTTPS, giám sát và sao lưu.

[Một gateway sàng lọc từng yêu cầu để phát hiện prompt injection](https://aggrega.ai/docs/vi/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### Một ứng dụng, nhiều nền tảng

Cùng một Aggregate được build cho Docker Compose trên laptop và cho Kubernetes trong môi trường production: đổi đích là đổi một ánh xạ, không phải mã của bạn.

[Một Aggregate, được build cho Compose và Kubernetes](https://aggrega.ai/docs/vi/language-reference/examples/mariadb-adminer/)

aggregate.yaml viết một lần

Trên máy tính xách tay

release-compose.yaml

manifest-compose.yaml

aggrega build

docker-compose.yaml

Trên một cụm Kubernetes

release-helm-synth.yaml

manifest-helm-synth.yaml

aggrega build

manifest Kubernetes

Mỗi nền tảng được xây dựng từ Release và Manifest riêng của nó. Aggregate, vốn mô tả ứng dụng của bạn, vẫn giữ nguyên.

#### Quản trị và chính sách

Các chính sách của bạn được cắm vào trình biên dịch và dừng một bản build vi phạm chúng, kèm theo chỉ dẫn cần sửa gì.

[Một chính sách, được kiểm tra trên bốn đích](https://aggrega.ai/docs/vi/language-reference/examples/policy-render-verdict/)

aggrega build

chính sách của bạn được gắn vào trình biên dịch

đạt

đã ghi tệp sẵn sàng để xem xét và triển khai

không đạt

bản dựng đã dừng policy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted

Chính sách có thể dừng bản dựng và cho biết cần sửa gì. Chính sách không bao giờ thay đổi tệp của bạn để chúng vượt qua.

#### Bản build có thể tái lập

Cùng đầu vào, cùng đầu ra, với mọi phụ thuộc được ghim trong một lockfile.

[Build một ví dụ và lockfile của nó](https://aggrega.ai/docs/vi/language-reference/examples/ai-agent-and-model-router/#building)

#### Danh mục thư viện chuẩn

Components cho agent, mô hình, gateway, kho dữ liệu, nhắn tin, khả năng quan sát, bảo mật và lưu trữ, sẵn sàng để dùng trong một Aggregate.

[Duyệt danh mục](https://aggrega.ai/catalog/vi/browse)

### Trợ lý của bạn, cùng Aggrega

Những gì một trợ lý viết mã hạ tầng cho bạn có được khi làm việc thông qua Aggrega.

- **Có thể tái lập** — Cùng đầu vào, cùng các tệp, với mọi phụ thuộc được ghim trong một lockfile.

- **Một bản mô tả** — Một bản mô tả ứng dụng, được build cho mọi nền tảng mà ứng dụng chạy trên đó.

- **Chính sách tại thời điểm build** — Các chính sách của bạn chạy trong trình biên dịch và dừng một bản build vi phạm chúng.

- **Một danh mục được ký và có phiên bản** — Những gì trợ lý kéo về từ danh mục đều có phiên bản và được ký, và thao tác pull xác minh từng chữ ký.

- **Được trình biên dịch kiểm tra** — Trợ lý xác thực và build bằng binary aggrega, và lấy câu trả lời về schema và tệp từ chính binary đó.

### Đích

Mỗi nền tảng nhận được các tệp mà nó đọc một cách tự nhiên. Agent AI chạy trên bất kỳ cụm Kubernetes nào, và nhiều agent cũng chạy được trên Compose.

- **Kubernetes** — Các manifest Kubernetes, mỗi tài nguyên một tệp, để ArgoCD hoặc Flux áp dụng.

- **Helm** — Helm chart, được kết xuất thành các tệp manifest Kubernetes.

- **Compose** — Một tệp Docker Compose, để chạy ứng dụng trên laptop.

- **Terraform** — Cấu hình cho các dịch vụ đám mây được quản lý. Aggrega không bao giờ chạy Terraform.

- **CloudFormation** — Mẫu stack cho AWS. Aggrega không bao giờ chạy CloudFormation.

[Mỗi đích ghi ra những gì](https://aggrega.ai/docs/vi/language-reference/providers/reference-matrix/)

### Nhập

aggrega import đọc một dự án ở một trong các định dạng này và ghi các tệp Aggrega bản nháp để bạn xem xét và chỉnh sửa.

- LangGraph
- CrewAI
- n8n
- Dify
- Langflow
- Flowise
- Google ADK
- Microsoft Agent Framework
- MCP client configurations
- Compose

aggrega import

tệp Aggrega bản nháp để bạn xem xét và chỉnh sửa

Đầu vào là dự án hiện có của bạn, đầu ra là các tệp Aggrega bản nháp. Không có gì được triển khai; bạn xem xét bản nháp trước.

[Cách nhập hoạt động](https://aggrega.ai/docs/vi/authoring/import/)

### Bắt đầu

#### Bắt đầu nhanh

Cài đặt Aggrega, xây dựng một ví dụ chạy được, chạy nó trên máy của bạn, rồi mở rộng nó từng bước một.

[Bắt đầu](https://aggrega.ai/docs/vi/getting-started/)

#### Chạy ví dụ đầu tiên

Mỗi ví dụ có thể chạy được là một không gian làm việc hoàn chỉnh mà bạn build bằng CLI aggrega.

[Duyệt các ví dụ](https://aggrega.ai/docs/vi/language-reference/examples/)

#### Cài đặt

Một lệnh duy nhất cài đặt binary aggrega cho người dùng của bạn, không cần quyền quản trị viên.

[Cài đặt binary](https://aggrega.ai/docs/vi/install/#install-the-binary)

### Mã nguồn mở

Trình biên dịch Aggrega là mã nguồn mở theo giấy phép Apache-2.0 và sẽ luôn như vậy: sẽ không có phiên bản đóng nào của trình biên dịch, cũng không có mô hình open-core. Mọi tính năng của trình biên dịch sẽ có trong phiên bản mã nguồn mở.

#### Trình biên dịch

Binary aggrega và giao diện dòng lệnh của nó.

[aggrega-ai/aggrega-cli trên GitHub](https://github.com/aggrega-ai/aggrega-cli)

#### Visual Studio Code

Xác thực, điều hướng, hover và tự động hoàn thành cho YAML Aggrega, dựa trên binary aggrega.

[Tiện ích mở rộng trên GitHub](https://github.com/aggrega-ai/aggrega-vscode-extension)
