# Mimari

> PentAGI'nin çalıştırdığı servisler, birbirleriyle nasıl iletişim kurdukları ve nelerin isteğe bağlı olduğu.

PentAGI, bir dizi Docker hizmetinden oluşur. Çekirdek yığın, [flows](https://pentagi.com/tr/docs/glossary/#flow)'u çalıştırmak için yeterlidir; [knowledge graph](https://pentagi.com/tr/docs/glossary/#knowledge-graph) ve gözlemlenebilirlik yığınları isteğe bağlı eklentilerdir.

## [Sistem bağlamı](https://pentagi.com/tr/docs/concepts/architecture/#system-context)

```mermaid
flowchart LR
  accTitle: System context of PentAGI with its users, targets, LLM providers, search engines, monitoring and the update server
  user["Security engineer"] -->|HTTPS| pentagi["PentAGI"]
  user -->|monitors| langfuse["Langfuse"]
  user -->|monitors| grafana["Grafana"]
  pentagi -->|tests| target["Target systems"]
  pentagi -->|queries| llm["LLM providers"]
  pentagi -->|searches| search["Search engines"]
  pentagi -->|reports| langfuse
  pentagi -->|reports| grafana
  pentagi -->|checks for updates| update["update.pentagi.com"]
```

Başlatıldıktan sonraki iki dakika içinde ve ardından her üç saatte bir, PentAGI ayrıca `update.pentagi.com` adresini kontrol ederek daha yeni bir yapı olup olmadığını denetler ve istekle birlikte kurulumun özetini gönderir; [Güncelleme denetimi](https://pentagi.com/tr/docs/configuration/security/#update-check) bunun neler içerdiğini ve nasıl kapatılacağını listeler.

## [Hizmetler](https://pentagi.com/tr/docs/concepts/architecture/#services)

| Grup                       | Hizmetler                                                                                                                                                                         | Compose dosyası                    |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- |
| Çekirdek                   | `pentagi` (REST ve GraphQL destekli Go arka ucu, React arayüzü), `pgvector` (pgvector uzantılı PostgreSQL), `pgexporter` (PostgreSQL metrikleri), `scraper` (yalıtılmış tarayıcı) | `docker-compose.yml`               |
| Knowledge graph            | `graphiti`, `neo4j`                                                                                                                                                               | `docker-compose-graphiti.yml`      |
| LLM gözlemlenebilirliği    | `langfuse-web`, `langfuse-worker`, `clickhouse`, `redis`, `minio`, `postgres`                                                                                                     | `docker-compose-langfuse.yml`      |
| Sistem gözlemlenebilirliği | `grafana`, `otel`, `victoriametrics`, `jaeger`, `clickstore`, `loki`, `node-exporter`, `cadvisor`                                                                                 | `docker-compose-observability.yml` |

[Tools](https://pentagi.com/tr/docs/glossary/#tool) hiçbir zaman `pentagi` konteynerinin kendisinde çalışmaz: her flow, Kali Linux gibi flow'un hedefine göre seçilen bir imajdan oluşturulmuş kendi [sandbox](https://pentagi.com/tr/docs/glossary/#sandbox) konteynerini alır.

## [Konteynerler](https://pentagi.com/tr/docs/concepts/architecture/#containers)

```mermaid
graph TB
  accTitle: Containers of the core stack and the optional knowledge graph
  subgraph Core
    UI[Web UI] -->|HTTP/WS| API[Backend API]
    API --> DB[(PostgreSQL + pgvector)]
    API --> Agents[Agents]
    Agents --> Sandbox[Sandboxed tools]
    Agents --> Scraper[Isolated browser]
  end
  subgraph Knowledge graph
    Graphiti --> Neo4j[(Neo4j)]
  end
  Agents --> Graphiti
  API -->|telemetry| OTEL[OpenTelemetry]
  API -->|LLM traces| Langfuse
```

* **Backend API** — Otomasyon için Bearer belirteç erişiminin yanı sıra REST ve GraphQL desteği sunan Go tabanlı hizmet.
* **Vector store** — pgvector uzantılı PostgreSQL; her komutu, çıktıyı ve gömmeyi saklar.
* **Agents** — Çalışmayı planlayan ve yürüten çoklu [agent](https://pentagi.com/tr/docs/glossary/#agent) sistemi; ayrıntılar için [Agents](https://pentagi.com/tr/docs/concepts/agents/) sayfasına bakın.
* **Sandbox** — Ana makineden yalıtılmış tool konteynerleri; üretim ortamında ayrı bir [worker node'da](https://pentagi.com/tr/docs/deployment/worker-node/) barındırılabilirler.