Szablon • Projektowanie interakcji

Matryce i szablony promptów

Jak utrzymywać promptowanie jak inżynierię: matryca doboru wzorca, kontrakt formatu, wersjonowanie i testy regresji.

Powiązane: Biblioteka promptów Powiązane: Golden set
W skrócie
  • Matryca wybiera szablon na podstawie zadania i ryzyka.
  • Szablon to kontrakt: instrukcja + format + kryteria + no‑answer.
  • Wersjonowanie (SemVer) i testy regresji są równie ważne jak treść promptu.
  • Jeden repozytorium prawdy: biblioteka promptów + changelog + owner.

Ta strona zbiera szablony i matryce w formie, którą da się wdrożyć jako „prompt‑as‑code”. Nie chodzi o ładne przykłady — chodzi o powtarzalność i kontrolę zmian.

1. Po co matryce i szablony

W firmie prompt nie jest „tekstem”. Jest interfejsem pomiędzy intencją biznesową a mechaniką modelu. Bez matryc i szablonów promptowanie szybko zamienia się w kolekcję przypadków.

  • Skalowalność: nowy zespół dostaje gotowy wzorzec zamiast „tajemnej wiedzy”.
  • Jakość: ten sam kontrakt formatu można walidować i testować.
  • Bezpieczeństwo: łatwiej wbudować bramki (citations, DLP, no‑answer).

2. Matryca doboru szablonu

Typ zadania Szablon (kontrakt) Kryteria sukcesu Ryzyko / bramki
Ekstrakcja danych
formularze, faktury, CRM
 JSON Schemanull‑safe poprawne typy • kompletność • brak ozdobników DLP • walidacja • retry z naprawą formatu
Q&A z wiedzy
helpdesk, dokumentacja
 citationsno‑answer atrybucja • zgodność • styl firmowy RAG/GraphRAG • gating dowodowy • eskalacja
Redakcja / styl
teksty, e‑maile, polityki
 style‑lintdiff zgodność ze standardem • spójność • brak skrótów approval (dla high‑stakes) • rejestr wyjątków
Planowanie z narzędziami
agent, workflow
 tool contractReAct bezpieczne wywołania • deterministyka Tool Gateway • allowlist • timeouts

3. Zestaw bazowych szablonów

Poniżej jest generator, który wybiera jeden z bazowych kontraktów. W praktyce każdy szablon powinien mieć: owner, wersję, testy i changelog.

Generator szablonu
Zachowaj jako prompt@ver w bibliotece.
Szablon (prompt)
Kontrakt odpowiedzi

4. Wersjonowanie i testy

Szablony są wartościowe wtedy, gdy da się je utrzymać. Minimum:

  1. SemVer: patch/minor/major zgodnie z wpływem na konsumentów (workflow, narzędzia, dokumenty).
  2. Golden set: zestaw przypadków, które muszą przechodzić zawsze.
  3. Regresje: porównanie jakości i kosztu (tokeny, latencja) po zmianie.
  4. Changelog: jawny opis zmiany i decyzji.

5. Antywzorce

  • Prompt‑patching w UI: szybkie, ale bez śladu i bez testów.
  • Jedna gigantyczna instrukcja: brak modularności, trudne debugowanie.
  • „Magiczne słowa”: brak kryteriów sukcesu, brak formatu.

6. Checklist wdrożeniowy

  • Matryca: dla każdego typu zadania jest rekomendowany szablon.
  • Każdy szablon ma kontrakt formatu, no‑answer i kryteria jakości.
  • Biblioteka promptów ma wersjonowanie i testy regresji.
  • Zmiany są widoczne w rejestrze (changelog) i mają ownera.
Powiązane
Na tej stronie
Spis
    Nawigacja
    ← Poprzedni Następny →
    Status merytoryczny
    Metryka (wersja, owner, terminy przeglądu) jest wypełniana automatycznie na podstawie manifestu.