diff --git a/network-poc/static/GUIDE.md b/network-poc/static/GUIDE.md index 669df75..be34f09 100644 --- a/network-poc/static/GUIDE.md +++ b/network-poc/static/GUIDE.md @@ -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
You are a coding assistant. Respond with ONLY code.
🔒 Kiinteä, kovakoodattu — malli priorisoi tämän"] + A["Agent prompt
Olet kokenut ohjelmistokehittäjä...
✏️ Käyttäjän muokattavissa UI:ssa"] + U["User prompt
Write ONLY the file main.py...
📋 Vaihtelee joka kutsussa, sisältää kontekstin"] + P["Prefill: ```
🎯 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ä, diff --git a/network-poc/static/index.html b/network-poc/static/index.html index aa78c76..8b3cf8a 100644 --- a/network-poc/static/index.html +++ b/network-poc/static/index.html @@ -6,6 +6,7 @@ Kipinä Agentic Playground +