Mermaid-kaaviot oppaaseen + mallitiedot agents-sivun status-palkkiin

GUIDE.md:n ASCII-kaaviot korvattu Mermaid-kaavioilla:
- Projekti-pipeline: flowchart TD värikoodatuilla vaiheilla
- Prompttirakenne: system → agent → user → prefill ketju

Mermaid ladataan CDN:stä ja renderöidään automaattisesti dark-teemalla.
Fallback: kaavion lähdekoodi näkyy tekstinä jos Mermaid ei lataudu.

Agents-sivun compute-status näyttää nyt tarkan mallitiedon:
- "Qwen2.5-Coder-0.5B" tai "Qwen2.5-Coder-3B"
- Tooltip: parametrimäärä, runtime, max tokenit

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jaakko Vanhala
2026-04-06 08:23:19 +03:00
parent dd1945ab28
commit 176f2d6915
2 changed files with 45 additions and 60 deletions

View File

@@ -73,31 +73,20 @@ vaan **mallin kyky ymmärtää pitkää kontekstia** — 0.5B-malli alkaa
### Kolmitasoinen prompttirakenne
```
┌─ System prompt (kiinteä, kovakoodattu) ─────────────────────┐
│ "You are a coding assistant. Respond with ONLY code." │
│ → Määrittää mallin roolin ja rajoitteet │
│ → Tämä on tehokkain ohje koska malli priorisoi sen │
└─────────────────────────────────────────────────────────────┘
┌─ Agent prompt (käyttäjän muokattavissa) ────────────────────┐
│ "Olet kokenut ohjelmistokehittäjä. Kirjoita selkeää..." │
│ → Agenttikohtainen persoonallisuus ja erikoisosaaminen │
│ → Tallennetaan localStorageen, voi muokata UI:ssa │
└─────────────────────────────────────────────────────────────┘
┌─ User prompt (vaihtelee joka kutsussa) ─────────────────────┐
│ "Write ONLY the file main.py: FastAPI app with endpoints." │
│ → Konkreettinen tehtävä tällä kerralla │
│ → Sisältää kontekstin (aiemmat tiedostot) pipeline-tilassa │
└─────────────────────────────────────────────────────────────┘
┌─ Prefill (pakottaa vastausformaatin) ───────────────────────┐
│ ``` │
│ → Malli luulee aloittaneensa koodiblokin ja jatkaa koodilla │
│ → Estää "Sure! Here is..." -johdantotekstit │
│ → Säästää ~10-20 tokenia per vastaus │
└─────────────────────────────────────────────────────────────┘
```mermaid
flowchart TD
S["System prompt<br/><i>You are a coding assistant. Respond with ONLY code.</i><br/>🔒 Kiinteä, kovakoodattu — malli priorisoi tämän"]
A["Agent prompt<br/><i>Olet kokenut ohjelmistokehittäjä...</i><br/>✏️ Käyttäjän muokattavissa UI:ssa"]
U["User prompt<br/><i>Write ONLY the file main.py...</i><br/>📋 Vaihtelee joka kutsussa, sisältää kontekstin"]
P["Prefill: ``` <br/>🎯 Pakottaa mallin aloittamaan koodilla"]
S --> A --> U --> P
P -->|malli jatkaa| R["Generoitu koodi"]
style S fill:#1a1e2e,stroke:#f85149,color:#c9d1d9
style A fill:#1a1e2e,stroke:#d29922,color:#c9d1d9
style U fill:#1a1e2e,stroke:#3fb950,color:#c9d1d9
style P fill:#1a1e2e,stroke:#a371f7,color:#c9d1d9
style R fill:#0d1117,stroke:#58a6ff,color:#58a6ff
```
### Miksi promptit ovat englanniksi?
@@ -207,38 +196,17 @@ stop-kohtaan.
## Projekti-pipeline — miten agenttitiimi toimii
```
┌──────────┐
Käyttäjä │ "FastAPI + SQLite REST API for users"
└────┬─────┘
┌──────────┐ "Pilko tiedostoiksi"
│ Manageri │ → models.py, main.py, pyproject.toml
└────┬─────┘
↓ (tiedostolista)
┌──────────┐ "Kirjoita models.py"
│ Koodari │ → from sqlalchemy import ...
└────┬─────┘
↓ (models.py kontekstina)
┌──────────┐ "Kirjoita main.py, käytä models.py:tä"
│ Koodari │ → from fastapi import ...
└────┬─────┘
↓ (kaikki tiedostot kontekstina)
┌──────────┐ "Kirjoita pyproject.toml"
│ Koodari │ → [project] dependencies = [...]
└────┬─────┘
↓ (kaikki tiedostot yhdessä)
┌──────────┐ "Review: onko bugeja?"
│ Testaaja │ → "Missing db.close(), no error handling"
└────┬─────┘
↓ (review-palaute + koodi)
┌──────────┐ "Korjaa nämä ongelmat"
│ Koodari │ → Korjattu koodi
└────┬─────┘
┌──────────┐ "Tarkista korjaukset"
│ Testaaja │ → "LGTM" tai lisäkorjauksia
└──────────┘
```mermaid
flowchart TD
U["Käyttäjä: FastAPI + SQLite REST API for users"] --> M
M["🟡 Manageri: Pilko tiedostoiksi"] -->|tiedostolista| C1
C1["🟢 Koodari: models.py"] -->|"konteksti: models.py"| C2
C2["🟢 Koodari: main.py"] -->|"konteksti: models + main"| C3
C3["🟢 Koodari: pyproject.toml"] -->|kaikki tiedostot| T1
T1["🔵 Testaaja: Review"] -->|bugeja löytyi| C4
T1 -->|LGTM| Done["✅ Projekti valmis"]
C4["🟡 Koodari: Korjaukset"] --> T2
T2["🔵 Testaaja: Uudelleenarviointi"] --> Done
```
**Kontekstin ketjutus** on kriittistä: kun koodari kirjoittaa `main.py`:tä,