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:
@@ -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ä,
|
||||
|
||||
Reference in New Issue
Block a user