# Aggrega

> Aggrega, kod olarak altyapı için açık kaynaklı bir derleyicidir: uygulamanızın tek bir YAML tanımı, incelediğiniz ve sahibi olduğunuz Kubernetes, Helm, Compose, Terraform veya CloudFormation dosyalarına dönüşür.

URL: https://aggrega.ai/tr/

## Mimariyi bir kez tanımlayın. Çalıştırdığınız her platform için altyapı kodunu alın.

Aggrega, kod olarak altyapı için açık kaynaklı bir derleyicidir: uygulamanızın tek bir YAML tanımı, incelediğiniz ve sahibi olduğunuz **Kubernetes**, **Helm**, **Compose**, **Terraform** veya **CloudFormation** dosyalarına dönüşür.

**LangGraph**, **CrewAI**, **n8n**, **Dify** ve daha fazlasıyla zaten bir ajan mı oluşturdunuz? İçe aktarın.

[Yapay zeka asistanınızla kurun](https://aggrega.ai/tr/#ai-assistant)[Hızlı başlangıç](https://aggrega.ai/docs/tr/getting-started/)[Projenizi içe aktarın](https://aggrega.ai/tr/#import)

Linux ve macOS

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

Windows, PowerShell'de

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

Adım adım kurulan iki hızlı başlangıç örneği: yerel bir model üzerinde çalışan bir yapay zekâ ajanı ve PostgreSQL kullanan bir web uygulaması. Her adım, değiştirdiği dosyaları eklediği satırlarla, aggrega build komutunu ve derlemenin yazdığı dosyaları gösterir.

### Yapay zekâ asistanınızla çalışır

Komut çalıştırabilen bir asistana bu istemi yapıştırın; asistan Aggrega'yı kurar, Aggrega becerisini kendine ekler ve Aggrega MCP sunucusuna bağlanır. İstem, asistanın herhangi bir şey kurmadan önce size danışmasını sağlar.

İstem

Aggrega'yı benim için adım adım kurun ve her adımda ne çalıştırdığınızı bana söyleyin.

1. `aggrega version` komutunu çalıştırın. Komut bulunamazsa Aggrega'yı kurmadan önce bana sorun, ardından resmî yükleyiciyle benim kullanıcım için kurun: Linux veya macOS'ta `curl -fsSL https://aggrega.ai/install.sh | sh`, Windows'ta PowerShell'de `irm https://aggrega.ai/install.ps1 | iex`. `aggrega version` komutunu yeniden çalıştırın. Yükleyici `PATH` değişkenime eklenecek bir satır yazdırdıysa bunu bana gösterin.

2. `https://aggrega.ai/docs/ai-assistants/skill/` sayfası Aggrega eklentisini size kurmanın bir yolunu gösteriyorsa, kurmadan önce bana sorun, ardından eklentiyi bu şekilde kurun ya da arayüzünüzde benim atmam gereken bir adım söz konusuysa ne yapmam gerektiğini bana söyleyin. Eklenti, Aggrega becerisini ekler ve sizi Aggrega MCP sunucusuna bağlar. Aksi halde `aggrega skills install --help` komutunu çalıştırın ve yazdırdığı listede kendi tanımlayıcınızı bulun. Beceriyi bu projede mi yoksa tüm projelerde mi istediğimi bana sorun, ardından `aggrega skills install --agent <your identifier>` komutunu çalıştırın; tüm projeler için `--global` ekleyin. Listede yoksanız beceriyi kurmayı atlayın ve bunu belirtin.

3. Eklentiyi kurduysanız Aggrega MCP sunucusuna zaten bağlısınız. Aksi halde kendinizi `aggrega mcp` komutu olan Aggrega MCP sunucusuna, bir MCP sunucusunu nasıl ekliyorsanız öyle bağlayın; `https://aggrega.ai/docs/ai-assistants/mcp-server/` bunu sizin için açıklar. Eklentiyi veya sunucuyu yüklemek için yeniden başlatma veya yeniden yükleme gerekiyorsa ne yapmam gerektiğini bana söyleyin.

4. Bağlandıktan sonra `describe-capabilities` aracını argümansız çağırın ve listelediklerini özetleyin.

**İstemin tamamını gösterin**

- **Beceri** — Asistana yazım döngüsünün nasıl işlediğini anlatır ve bir şema ya da dosya hakkındaki her yanıtı aggrega ikili dosyasından almasını söyler.

- **MCP sunucusu** — aggrega mcp, asistana Aggrega'nın araçlarını verir: scaffold, validate, build ve diğerleri.

[Bir asistandan diğerine neler değişir](https://aggrega.ai/docs/tr/ai-assistants/set-up/)

### Nasıl çalışır

Siz uygulamayı tanımlarsınız, Aggrega dosyaları yazar ve zaten kullandığınız araçlar bunları dağıtır. Aggrega hiçbir zaman çalışan bir kümeye veya bir bulut hesabına erişmez.

Aggregate uygulamanızı tanımlar

Release tek bir ortamın ayarları

Manifest her parçanın nasıl oluşturulduğu

aggrega build aynı girdi, aynı dosyalar

- Kubernetes
- Helm
- Compose
- Terraform
- CloudFormation

incelediğiniz ve sahibi olduğunuz dosyalar

Aggrega'nın dışında

ArgoCD · Flux · Terraform yazılan dosyaları dağıtır

Aggrega dosyalarda durur. Çalışan bir kümeye veya bir bulut hesabına asla erişmez; yazdığı dosyaları kendi araçlarınız dağıtır.

#### Uygulamayı tanımlayın

Bir **Aggregate**, **bileşenlerini** ve bunların nasıl bağlandığını belirtir.

#### Ortamı seçin

Bir **Release**, o ortamın ayarlarını doldurur.

#### Her parçanın nasıl oluşturulacağını seçin

Bir **Manifest**, her bileşeni platformunuz için bir **Recipe**'ye eşler; örneğin bir Helm chart, bir Terraform modülü veya bir konteyner.

#### aggrega build'i çalıştırın

Her platform için dosyaları yazar: aynı girdi için her seferinde **aynı dosyalar**.

#### Kendi araçlarınızla dağıtın

Yazılan dosyalar **ArgoCD**, **Flux** veya **Terraform** tarafından dağıtılır.

### Neler oluşturabilirsiniz

Çalıştırılabilir bir örnekten veya kataloğun bileşenlerinden başlayın.

#### Yapay zekâ ajanları ve ağ geçitleri

Token bütçeleri, anlamsal önbellekleme, log maskeleme ve istem enjeksiyonu kalkanı sunan model ağ geçitlerinin arkasında çalışan, LangGraph, CrewAI, LlamaIndex, Dify, n8n ve daha fazlasıyla oluşturulmuş ajanlar.

[Token bütçeli bir ağ geçidinin arkasındaki bir ajan](https://aggrega.ai/docs/tr/language-reference/examples/envoy-ai-gateway-token-budget/)

#### Geleneksel iş yükleri

Veritabanları, önbellekler, mesaj aracıları ve kimlik yönetimi; örneğin PostgreSQL, MariaDB, Redis, Kafka ve Keycloak.

[Üç farklı şekilde dağıtılan tek bir PostgreSQL veritabanı](https://aggrega.ai/docs/tr/language-reference/examples/postgres-three-realizations/)

#### Features

Uygulamaya dokunmadan ortam başına eklediğiniz yetenekler; örneğin istem enjeksiyonuna karşı kalkan, hassas verilerin maskelenmesi, HTTPS ingress, izleme ve yedeklemeler.

[Her isteği istem enjeksiyonuna karşı tarayan bir ağ geçidi](https://aggrega.ai/docs/tr/language-reference/examples/ai-gateway-prompt-injection-shield/)

#### Tek uygulama, çok sayıda platform

Aynı Aggregate, dizüstü bilgisayarda Docker Compose ve üretimde Kubernetes için derlenir: hedefi değiştirmek kodunuzu değil, bir eşlemeyi değiştirir.

[Tek bir Aggregate, Compose ve Kubernetes için derlenmiş](https://aggrega.ai/docs/tr/language-reference/examples/mariadb-adminer/)

aggregate.yaml bir kez yazılır

Dizüstü bilgisayarda

release-compose.yaml

manifest-compose.yaml

aggrega build

docker-compose.yaml

Bir Kubernetes kümesinde

release-helm-synth.yaml

manifest-helm-synth.yaml

aggrega build

Kubernetes manifest dosyaları

Her platform kendi Release'i ve Manifest'inden oluşturulur. Uygulamanızı tanımlayan Aggregate aynı kalır.

#### Yönetişim ve politikalar

Politikalarınız derleyiciye takılır ve bunları ihlal eden bir derlemeyi, neyin düzeltilmesi gerektiğini söyleyerek durdurur.

[Tek bir politika, dört hedefte denetlenmiş](https://aggrega.ai/docs/tr/language-reference/examples/policy-render-verdict/)

aggrega build

politikanız derleyiciye takılı

başarılı

dosyalar yazıldı incelenmeye ve dağıtılmaya hazır

başarısız

derleme durduruldu policy plugin "rego" rejected the build: terraform/modules/db/main.tf: the RDS instance db stores its data unencrypted

Bir politika derlemeyi durdurabilir ve neyin düzeltileceğini söyleyebilir. Geçmeleri için dosyalarınızı asla değiştirmez.

#### Yeniden üretilebilir derlemeler

Aynı girdi, aynı çıktı ve her bağımlılık bir kilit dosyasında sabitlenmiş.

[Bir örneği ve kilit dosyasını derleyin](https://aggrega.ai/docs/tr/language-reference/examples/ai-agent-and-model-router/#building)

#### Standart kütüphane kataloğu

Ajanlar, modeller, ağ geçitleri, veri depoları, mesajlaşma, gözlemlenebilirlik, güvenlik ve depolama için Components, bir Aggregate içinde kullanıma hazır.

[Kataloğa göz atın](https://aggrega.ai/catalog/tr/browse)

### Asistanınız, Aggrega ile

Altyapı kodunuzu yazan bir asistanın Aggrega üzerinden çalışarak kazandıkları.

- **Yeniden üretilebilir** — Aynı girdi, aynı dosyalar; her bağımlılık bir kilit dosyasında sabitlenmiş olarak.

- **Tek bir tanım** — Uygulamanın, üzerinde çalıştığı her platform için derlenen tek bir tanımı.

- **Derleme zamanında politikalar** — Politikalarınız derleyicide çalışır ve onları ihlal eden bir derlemeyi durdurur.

- **İmzalı, sürümlü bir katalog** — Bir asistanın katalogdan çektiği her şey sürümlü ve imzalıdır; çekme işlemi her imzayı doğrular.

- **Derleyici tarafından denetlenir** — Asistan, aggrega ikili dosyasıyla doğrular ve derler; şemalar ve dosyalar hakkındaki yanıtlarını da ondan alır.

### Hedefler

Her platform, doğal olarak okuduğu dosyaları alır. Yapay zekâ ajanları her Kubernetes kümesinde, birçoğu da Compose üzerinde çalışır.

- **Kubernetes** — Kubernetes manifestleri, kaynak başına bir dosya, ArgoCD veya Flux'ın uygulaması için.

- **Helm** — Helm chart'ları, Kubernetes manifestlerine dönüştürülmüş.

- **Compose** — Uygulamayı bir dizüstü bilgisayarda çalıştırmak için bir Docker Compose dosyası.

- **Terraform** — Yönetilen bulut hizmetleri için yapılandırma. Aggrega hiçbir zaman Terraform'u çalıştırmaz.

- **CloudFormation** — AWS için yığın şablonları. Aggrega hiçbir zaman CloudFormation'ı çalıştırmaz.

[Her hedefin yazdıkları](https://aggrega.ai/docs/tr/language-reference/providers/reference-matrix/)

### İçe aktarma

aggrega import, bu biçimlerden birindeki bir projeyi okur ve incelemeniz ve düzenlemeniz için taslak Aggrega dosyaları yazar.

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

aggrega import

taslak Aggrega dosyaları incelemeniz ve düzenlemeniz için

Mevcut projeniz girer, taslak Aggrega dosyaları çıkar. Hiçbir şey dağıtılmaz; önce taslakları siz incelersiniz.

[İçe aktarma nasıl çalışır](https://aggrega.ai/docs/tr/authoring/import/)

### Başlayın

#### Hızlı başlangıç

Aggrega'yı kurun, çalıştırılabilir bir örnek derleyin, kendi makinenizde çalıştırın, ardından onu adım adım büyütün.

[Başlarken](https://aggrega.ai/docs/tr/getting-started/)

#### İlk örneği çalıştırın

Her çalıştırılabilir örnek, aggrega CLI ile derlediğiniz eksiksiz bir çalışma alanıdır.

[Örneklere göz atın](https://aggrega.ai/docs/tr/language-reference/examples/)

#### Kurulum

Tek bir komut, aggrega ikili dosyasını yönetici hakları gerektirmeden kullanıcınız için kurar.

[İkili dosyayı kurun](https://aggrega.ai/docs/tr/install/#install-the-binary)

### Açık kaynak

Aggrega derleyicisi Apache-2.0 lisansı altında açık kaynaklıdır ve öyle kalacaktır: derleyicinin kapalı bir sürümü olmayacak, open-core modeli de olmayacaktır. Derleyicinin tüm özellikleri açık kaynak sürümünde sunulacaktır.

#### Derleyici

aggrega ikili dosyası ve komut satırı arayüzü.

[GitHub'da aggrega-ai/aggrega-cli](https://github.com/aggrega-ai/aggrega-cli)

#### Visual Studio Code

aggrega ikili dosyası tarafından desteklenen, Aggrega YAML için doğrulama, gezinme, üzerine gelme bilgisi ve tamamlama.

[GitHub'daki eklenti](https://github.com/aggrega-ai/aggrega-vscode-extension)
