Architektura - 88 Agentů | CzechAI Gateway

┌─────────────────────────────────────────────────────────┐
│  VRSTVA 3: SALES KATALOG (101 služeb)                  │
│  ├─ Router Tower API (port 8090)                        │
│  ├─ Endpoint: /v1/services/{kategorie}/{sluzba}        │
│  ├─ Cena: 15-150K Kč/měsíc                             │
│  └─ Popis: High-level orchestrace pro klienty          │
└─────────────────────────────────────────────────────────┘
                         ↓ orchestruje
┌─────────────────────────────────────────────────────────┐
│  VRSTVA 2: UNIFIED GATEWAY (11 služeb)                 │
│  ├─ Port 9090                                           │
│  ├─ Endpoint: /api/{service}/{agent}                   │
│  └─ Popis: Centrální routing pro agent servery         │
└─────────────────────────────────────────────────────────┘
                         ↓ routuje
┌─────────────────────────────────────────────────────────┐
│  VRSTVA 1: AGENT SERVERY (88 agentů)                   │
│  ├─ Porty: 9100-9116 (11 serverů)                      │
│  ├─ Endpoint: /{agent_name}                            │
│  └─ Popis: Low-level implementace jednotlivých agentů  │
└─────────────────────────────────────────────────────────┘

📊 VRSTVA 1: AGENT SERVERY (88 AGENTŮ)

CO TO JE: Low-level Python Flask servery. Každý agent dělá JEDNU konkrétní věc.

JAK SE K NIM PŘISTUPUJE: - Přímo: curl http://46.224.121.179:9100/loan-assessment - Nebo přes Gateway (doporučeno): curl http://46.224.121.179:9090/api/banking/loan-assessment

KOMPLETNÍ SEZNAM (88 agentů):

Port 9100: BANKING (6 agentů)

1. loan_assessment          - Posouzení úvěru
2. credit_risk              - Kreditní riziko
3. underwriting             - Underwriting
4. ltv_calculator           - LTV kalkulačka
5. dti_calculator           - DTI kalkulačka
6. collateral_valuation     - Oceňování zajištění

curl -X POST http://46.224.121.179:9100/loan_assessment \
  -H "Content-Type: application/json" \
  -d '{"amount": 5000000, "monthly_income": 80000}'

Port 9101: LEGAL-AML (5 agentů)

7. aml_compliance           - AML compliance
8. sanctions_pep            - Sankce & PEP
9. ubo_discovery            - Objevování UBO
10. continuous_monitoring   - Kontinuální monitoring
11. legal_rag               - Právní RAG

Port 9102: REAL ESTATE (9 agentů)

12. due_diligence           - Due diligence nemovitostí
13. market_intelligence     - Tržní inteligence
14. investment_finder       - Hledač investic
15. auction_scraper         - Scraper dražeb
16. insolvency_scraper      - Scraper insolvencí
17. ownership_analysis      - Analýza vlastnictví
18. parcel_matcher          - Párování parcel
19. profit_score            - Profit scoring
20. risk_zones              - Rizikové zóny

Port 9103: INSURANCE (4 agenty)

21. underwriting            - Pojišťovací underwriting
22. fraud_detection         - Detekce podvodů
23. risk_profiling          - Rizikové profilování
24. premium_calculator      - Kalkulace pojistného

Port 9104: COMPLIANCE (5 agentů)

25. gdpr_compliance         - GDPR compliance
26. kyc                     - KYC (Know Your Customer)
27. regulatory_reporting    - Regulatorní reporting
28. compliance_monitoring   - Monitoring compliance
29. data_retention          - Retence dat

Port 9105: RISK MANAGEMENT (5 agentů)

30. credit_risk             - Kreditní riziko
31. market_risk             - Tržní riziko
32. liquidity_risk          - Riziko likvidity
33. operational_risk        - Operační riziko
34. portfolio_risk          - Portfoliové riziko

Port 9106: AML (7 agentů)

35. person_screening        - Screening osob
36. company_screening       - Screening firem
37. sanctions               - Sankční seznamy
38. ubo_discovery           - UBO discovery
39. risk_scoring            - Rizikové skórování
40. monitoring              - AML monitoring
41. compliance              - AML compliance

Port 9107: LEGAL (3 agenty)

42. ownership_forensics     - Forenzní analýza vlastnictví
43. legal_analysis          - Právní analýza
44. contract_review         - Review smluv

Port 9108: DATA (16 agentů)

45. ares_lookup             - ARES vyhledávání
46. company_matching        - Párování firem
47. contact_enrichment      - Obohacování kontaktů
48. knowledge_base          - Znalostní báze
49. entity_resolution       - Resoluce entit
50. data_validation         - Validace dat
51. deduplication           - Deduplikace
52. geocoding               - Geokódování
53. address_normalization   - Normalizace adres
54. phone_validation        - Validace telefonů
55. email_validation        - Validace emailů
56. company_classification  - Klasifikace firem
57. industry_tagging        - Průmyslové štítky
58. size_estimation         - Odhad velikosti
59. revenue_estimation      - Odhad tržeb
60. employee_count          - Počet zaměstnanců

Port 9109: CONTACT (13 agentů)

61. contact_finder          - Hledač kontaktů
62. contact_matcher         - Párování kontaktů
63. contact_validator       - Validace kontaktů
64. email_finder            - Hledač emailů
65. phone_finder            - Hledač telefonů
66. linkedin_scraper        - LinkedIn scraper
67. social_enrichment       - Sociální obohacování
68. job_title_parser        - Parser pracovních pozic
69. seniority_detector      - Detekce seniority
70. decision_maker_finder   - Hledač rozhodovatelů
71. org_chart_builder       - Stavitel org. struktury
72. contact_scoring         - Skórování kontaktů
73. engagement_predictor    - Predikce angažovanosti

Port 9116: ORCHESTRATOR (15 agentů)

74. master_orchestrator     - Hlavní orchestrátor
75. workflow_engine         - Workflow engine
76. aml_orchestrator        - AML orchestrátor
77. reality_orchestrator    - Realitní orchestrátor
78. banking_orchestrator    - Bankovní orchestrátor
79. insurance_orchestrator  - Pojišťovací orchestrátor
80. lead_orchestrator       - Lead orchestrátor
81. data_pipeline           - Data pipeline
82. batch_processor         - Batch procesor
83. scheduler               - Plánovač
84. task_queue              - Fronta úkolů
85. event_bus               - Event bus
86. saga_coordinator        - SAGA koordinátor
87. compensation_handler    - Handler kompenzací
88. retry_manager           - Správce retry

📊 VRSTVA 2: UNIFIED GATEWAY (11 SLUŽEB)

CO TO JE: Centrální vstupní bod. Namísto volání 11 různých portů, voláš JEDEN (9090).

# Základní info
curl http://46.224.121.179:9090/

# Health check
curl http://46.224.121.179:9090/health

# Seznam služeb
curl http://46.224.121.179:9090/api/services

# Swagger UI
http://46.224.121.179:9090/docs

1. banking       → 9100 (6 agentů)
2. legal-aml     → 9101 (5 agentů)
3. real-estate   → 9102 (9 agentů)
4. insurance     → 9103 (4 agenty)
5. compliance    → 9104 (5 agentů)
6. risk          → 9105 (5 agentů)
7. aml           → 9106 (7 agentů)
8. legal         → 9107 (3 agenty)
9. data          → 9108 (16 agentů)
10. contact      → 9109 (13 agentů)
11. orchestrator → 9116 (15 agentů)

# Banking loan assessment přes gateway
curl -X POST http://46.224.121.179:9090/api/banking/loan-assessment \
  -H "Content-Type: application/json" \
  -d '{"amount": 5000000, "monthly_income": 80000}'

# Gateway automaticky přeposílá na:
# http://localhost:9100/loan_assessment

VÝHODY GATEWAY: - ✅ Jeden vstupní bod (9090) místo 11 portů - ✅ Automatický health monitoring - ✅ Prometheus metrics - ✅ Unified dokumentace (Swagger UI) - ✅ Centralizované logování - ✅ Budoucí autentizace (API keys)

📊 VRSTVA 3: SALES KATALOG (101 SLUŽEB)

CO TO JE: High-level orchestrace pro klienty. Kombinuje více agentů z Vrstvy 1 do komplexních workflow.

curl -X POST https://router.czechai.io/v1/services/leady/master-intelligence \
  -H "X-API-Key: demo-key-123" \
  -H "Content-Type: application/json" \
  -d '{"region": "Praha", "budget": 10000000}'

ROZDÍL OD VRSTVY 1: - Vrstva 1 (Agent): Dělá JEDNU věc (např. "posouď úvěr") - Vrstva 3 (Služba): Kombinuje VÍCE agentů (např. "najdi nemovitost + oceň + zkontroluj vlastníka + posouď úvěr + doruč report")

┌─────────────────────────────────────────┐
│ L-01: Master Intelligence               │
│ Endpoint: /v1/services/leady/master-... │
└─────────────────────────────────────────┘
                  ↓
    ┌─────────────┴─────────────┐
    ↓                           ↓
[investment_finder]      [market_intelligence]
(port 9102)                   (port 9102)
    ↓                           ↓
    └─────────────┬─────────────┘
                  ↓
         [due_diligence]
         (port 9102)
                  ↓
         [ownership_analysis]
         (port 9102)
                  ↓
         [loan_assessment]
         (port 9100)
                  ↓
    ┌─────────────┴─────────────┐
    ↓                           ↓
[aml_compliance]         [legal_analysis]
(port 9101)                (port 9107)
    ↓                           ↓
    └─────────────┬─────────────┘
                  ↓
         [report_generator]
         (orchestrator)
                  ↓
         📄 FINAL REPORT

🔄 JAK TO VŠECHNO FUNGUJE DOHROMADY?

SCÉNÁŘ 1: KLIENT CHCE POSOUDIT ÚVĚR (JEDNODUCHÉ)

#	Kategorie	Služeb	Příklad
1	LEADY	14	L-01: Master Intelligence (150K/měs)
2	ŽIVNOSTNÍCI	10	Z-01: Generátor Zakázek (2-5K/měs)
3	POJIŠTĚNÍ	10	POJ-01: AI Underwriting (40-80K/měs)
4	OBECNÉ	10	O-01: Multi-platform scraping (varies)
5	REALITNÍ INTEL	8	RI-01: Due Diligence Swarm (50-100K/měs)
6	PRÁVNÍ	6	P-01: Legal Oracle AI (30-80K/měs)
7	REALITKY	10	RK-01: Lead Generation (25-60K/měs)
8	BANKOVNICTVÍ	11	B-01: Loan Assessment (30-70K/měs)
9	AUTOMATIZACE	11	A-01: N8N Workflow Builder (20-50K/měs)
10	FIRMY	11	F-01: Company Intelligence (40-90K/měs)

curl -X POST http://46.224.121.179:9090/api/banking/loan-assessment \
  -d '{"amount": 5000000}'

[Klient]
   ↓
[Gateway:9090] /api/banking/loan-assessment
   ↓
[Banking Server:9100] /loan_assessment
   ↓ (agent vypočítá)
[Response] {"approved": true, "risk_score": 72}
   ↓
[Gateway:9090] → [Klient]

SCÉNÁŘ 2: KLIENT CHCE KOMPLETNÍ INVESTIČNÍ ANALÝZU (KOMPLEXNÍ)

curl -X POST https://router.czechai.io/v1/services/leady/master-intelligence \
  -H "X-API-Key: client-xyz" \
  -d '{"region": "Praha", "budget": 10000000}'

[Klient]
   ↓
[Router Tower:8090] /v1/services/leady/master-intelligence
   ↓ (orchestrace)
   ├→ [Gateway:9090] /api/real-estate/investment_finder → najde 15 nemovitostí
   ├→ [Gateway:9090] /api/real-estate/market_intelligence → tržní analýza
   ├→ [Gateway:9090] /api/real-estate/due_diligence → 15× DD check
   ├→ [Gateway:9090] /api/real-estate/ownership_analysis → vlastníci
   ├→ [Gateway:9090] /api/banking/loan_assessment → 15× úvěr check
   ├→ [Gateway:9090] /api/legal-aml/aml_compliance → AML check
   ├→ [Gateway:9090] /api/legal/legal_analysis → právní rizika
   └→ [Orchestrator:9116] /report_generator → FINÁLNÍ REPORT (PDF)
   ↓
[Response] {
  "properties_found": 15,
  "top_3": [...],
  "report_url": "https://...",
  "total_time": "45s"
}
   ↓
[Router Tower:8090] → [Klient]

Použitá vrstva: VRSTVA 3 (Orchestrace) → VRSTVA 2 (Gateway) → VRSTVA 1 (7 agentů)

🎯 JAK SE ROZHODNOUT CO POUŽÍT?

POUŽIJ VRSTVU 1 (Přímý agent) KDYŽ:

# Jen spočítat LTV ratio
curl -X POST http://46.224.121.179:9100/ltv_calculator \
  -d '{"loan": 5000000, "value": 8000000}'

POUŽIJ VRSTVU 2 (Gateway) KDYŽ:

# Gateway automaticky najde správný port
curl -X POST http://46.224.121.179:9090/api/banking/ltv-calculator \
  -d '{"loan": 5000000, "value": 8000000}'

POUŽIJ VRSTVU 3 (Orchestrace) KDYŽ:

# Kompletní realitní due diligence + financování
curl -X POST https://router.czechai.io/v1/services/leady/master-intelligence \
  -H "X-API-Key: client-xyz" \
  -d '{"address": "Praha 1, Václavské nám. 1"}'

📍 KDE CO NAJDU?

DOKUMENTACE

LIVE ENDPOINTY

SPRÁVA

🎯 QUICK START EXAMPLES

1. Test že všechno běží

Soubor	Popis
JASNY_PREHLED_CO_A_JAK.md	TENTO SOUBOR - hlavní přehled
`unified_gateway/PRISTUP_A_POUZITI.md`	Gateway dokumentace
`KOMPLETNI_SLUZBY_101_ENDPOINTS.md`	101 služeb (Vrstva 3)
`AGENT_IMPLEMENTATION_STATUS.md`	Status 88 agentů (Vrstva 1)
`PRAKTICKE_PRIKLADY_POUZITI.md`	Praktické příklady
`BATCH_8_COMPLETE_SUMMARY.md`	Batch 8 implementace

Endpoint	Co vrací
`http://46.224.121.179:9090/`	Gateway info
`http://46.224.121.179:9090/health`	Health všech 11 služeb
`http://46.224.121.179:9090/api/services`	Seznam 11 služeb
`http://46.224.121.179:9090/api/agents`	Seznam 88 agentů (TODO fix)
`http://46.224.121.179:9090/docs`	Swagger UI
`http://46.224.121.179:9090/metrics`	Prometheus metrics

Operace	Příkaz
Start Gateway	`cd /root/.claude-code/unified_gateway && docker compose up -d`
Restart Gateway	`docker compose restart`
Logs Gateway	`docker compose logs -f`
Test všech agentů	`for p in 9100 9101 9102 9103 9104 9105 9106 9107 9108 9109 9116; do curl -s http://localhost:$p/health; done`

# SSH na server
ssh root@46.224.121.179

# Test Gateway
curl http://localhost:9090/health

# Mělo by vrátit: "overall": "healthy"

2. Zavolej jednoduchého agenta (LTV kalkulačka)

curl -X POST http://localhost:9090/api/banking/ltv-calculator \
  -H "Content-Type: application/json" \
  -d '{
    "loan_amount": 5000000,
    "property_value": 8000000
  }'

# Response:
# {
#   "ltv_ratio": 0.625,
#   "ltv_percentage": 62.5
# }

3. Zavolej složitou orchestraci (Master Intelligence)

# TODO - Router Tower (port 8090) zatím není připojen k Gateway
# Momentálně běží samostatně

❓ FAQ

Q: Proč máme 88 agentů ale 101 služeb?

A: - 88 agentů = Low-level implementace (Vrstva 1) - 101 služeb = High-level orchestrace (Vrstva 3) - 1 služba (Vrstva 3) může používat 5-10 agentů (Vrstva 1)

Q: Mám volat Gateway (9090) nebo přímo agenty (9100)?

A: - Development/Testing: Přímo agenty (9100) - rychlejší - Production: Gateway (9090) - unified, monitored, documented

Q: Jak přidám nového agenta?

A: 1. Implementuj agent na konkrétním portu (např. 9100) 2. Přidej do /health endpointu agenta 3. Gateway automaticky detekuje (restart není potřeba)

Q: Jak vytvořím novou orchestrační službu?

A: 1. Vytvoř endpoint na Router Tower (8090) 2. V endpointu volej Gateway (9090) pro jednotlivé agenty 3. Přidej do KOMPLETNI_SLUZBY_101_ENDPOINTS.md

Q: Co když agent spadne?

# 1. Zkontroluj health
curl http://localhost:9090/health | jq '.services.banking'

# 2. Pokud "unhealthy" - restart agent serveru
cd /opt/agents/banking  # (nebo kde je implementace)
# ...restart podle implementace (Docker/PM2/systemd)

# 3. Gateway automaticky detekuje obnovení

🚀 CO DÁLE?

BATCH 9 PRIORITY:

Vytvořeno: 2026-01-25 Autor: CzechAI Status: ✅ KOMPLETNÍ A AKTUÁLNÍ

Architektura - 88 Agentů

🎯 JASNÝ PŘEHLED - CO A JAK

🏗️ ARCHITEKTURA - 3 VRSTVY