Beskrivelse og plan
Et projekt har to kernedokumenter: Beskrivelsen, som står under Beskriv, og Planen, som står under Planlæg. De ligger i projektets mappe Kerne og findes fra start, når projektet oprettes. Beskrivelsen skriver I selv, med assistentens hjælp, hvis I vil; planen kan assistenten skrive et udkast til.
Hvordan et godt resultat ser ud, viser I med jeres sager: en sag kan have sit facit, det færdige svar en sagsbehandler har lavet. Det er det, løsningen bygges efter og vurderes mod.
Beskrivelse
Beskrivelsen er projektgruppens fælles aftale om, hvad I beder om. En fagperson godkender den. Den er ikke et design af løsningen: hvordan der bygges, står i planen.
Den har to dele. Tekst i kursiv er spørgsmål, I mangler at svare på: skriv svaret i almindelig tekst, og slet spørgsmålet.
Sådan gør I i dag
Her skriver I med jeres egne ord, hvordan opgaven løses nu — som hvis I forklarede den til en ny kollega: hvad opgaven er, hvordan en typisk sag forløber, hvad I kigger efter, hvor reglerne står, hvordan sagerne er forskellige, og hvor ofte opgaven kommer. Det er her, reglerne og undtagelserne kommer fra, så skriv hellere for meget end for lidt. Der er ingen faste overskrifter; spørgsmålene er kun en hjælp.
I skal ikke beskrive løsningen her. I er eksperterne i arbejdet, som det er i dag.
Det ændrer vi
Her vælger I, hvad der skal ændres, under faste overskrifter. Lad overskrifterne stå, som de er: AgentBase finder afsnittene på dem.
| Afsnit | Det skriver I |
|---|---|
| Hvilke dele skal ligne det, I gør i dag, og hvilke må gerne se anderledes ud? | Et spørgsmål til jer, ikke til systemet: skal løsningen gøre præcis det samme som i dag (automatisering), eller må den gøre det anderledes og bedre (optimering)? Et resultat, der ser anderledes ud end jeres, er ikke nødvendigvis forkert — men det skal I være enige om, før I vurderer. Kun I kan svare; assistenten gør det ikke |
| Fokus | Hvilken del af arbejdet I tager først |
| Ind | Hvad brugeren giver løsningen. Som regel uploader man sagens filer direkte i løsningen |
| Ud | Hvad løsningen skal give tilbage, i hvilken form, og hvem der bruger det — fx en PDF med et overblik eller et regneark med én række pr. bilag |
| Kontrol | Hvem der ser resultatet, før det bruges, og hvad de gør med det |
| Afgrænsning | Hvad løsningen ikke skal håndtere, og hvad der altid skal behandles af en person |
| Godt nok | Et mål, der kan måles på sagerne, fx »9 ud af 10 sager vurderes korrekte af en fagperson«. Det står ved siden af tallene under Test |
Materialet under Materiale er til jer og til arbejdet med at bygge løsningen. Det, løsningen arbejder på i drift, uploader brugeren i løsningen. Skal løsningen slå op i et dokument fra Vidensbank, mens den kører — fx en lovtekst eller en paradigmeliste — bliver det besluttet i planen, under Indbygget viden.
Få hjælp af assistenten
Så længe beskrivelsen ikke er godkendt, står der en linje over teksten med knappen Få hjælp af assistenten. Assistenten skriver ikke beskrivelsen for jer. Den spørger sig frem ud fra én rigtig sag:
- Knappen åbner Ny sag. Læg dokumenterne fra én rigtig henvendelse ind, og gerne det færdige svar som facit. Sagen er en almindelig sag og ligger under Materiale bagefter. I kan også vælge Fortsæt uden sag.
- Assistentens skrivefelt bliver udfyldt med opgaven. I læser, retter og sender selv.
- Assistenten læser beskrivelsen og sagen, stiller ét eller to spørgsmål ad gangen og går sagen igennem med jer: »Her står der X. Hvad gør I med det?«
- Det, I svarer, skriver den ind i beskrivelsen som almindelig tekst. Det, den ikke ved, lader den stå som spørgsmål i kursiv, og den slutter med at sige, hvad der stadig er åbent.
Har I ikke et facit, spørger assistenten grundigt til, hvad løsningen skal give tilbage: form, indhold og detaljeringsgrad. Uden et billede af et godt resultat bliver der bygget på et gæt, og så går tiden med at rette. Læg gerne et facit ind senere.
Ønsker I noget, AgentBase ikke kan i dag, lover assistenten det ikke. Det bliver stående som et spørgsmål, en udvikler tager stilling til i planen.
Det mangler beskrivelsen
Når nogen har skrevet i beskrivelsen, viser siden, hvad den stadig mangler, før en plan kan skrives godt: hvad løsningen skal give tilbage (Ud), en sag med et facit, hvad brugeren giver løsningen (Ind), hvad I tager først (Fokus), nok tekst om, hvordan I løser opgaven i dag, hvem der kontrollerer resultatet (Kontrol), hvornår det er godt nok (Godt nok), og svaret på spørgsmålet om, hvad der skal ligne det, I gør i dag.
Det er en advarsel, ikke en spærring: I kan godt godkende beskrivelsen alligevel. Det, der mangler, når planen skrives, bliver til åbne spørgsmål i planen i stedet for gæt. Rækkerne gælder den gemte tekst og regnes ud, hver gang siden åbnes. Tjekket ser kun, om der står noget — ikke om det er godt. »Ud: et dokument« tæller som et svar, men det er for løst til at bygge efter.
En beskrivelse, der er skrevet før de to dele kom, bliver ikke ændret og bliver ikke tjekket.
Det når frem til løsningen
Planen bliver skrevet ud fra hele beskrivelsen. Når assistenten bygger, får byggeren desuden afsnittene Ud, Kontrol, Afgrænsning og Godt nok og jeres svar på spørgsmålet om, hvad der skal ligne det, I gør i dag — ord for ord, som I har skrevet dem, og kun når beskrivelsen er godkendt i den version, der står nu. Retter I i en godkendt beskrivelse, skal den godkendes igen, før afsnittene kommer med.
»Sådan gør I i dag« når ikke byggeren direkte. Reglerne derfra kommer med gennem planen.
Plan
Planen står under Planlæg, efter Materiale, fordi den skrives ud fra beskrivelsen og sagerne. Den siger, hvad der skal bygges. Projektassistenten bygger kun ud fra en godkendt plan, og kun en udvikler i projektets team kan godkende den. Ændres planen, skal den godkendes igen, før assistenten bygger eller retter mere.
Planens format
Planen er et almindeligt dokument, som I kan læse og rette. En lille, fast del af den bliver tjekket, så formatet skal holdes dér:
# Plan
## Formål
## Input
## Regler
## Agenter
### Ejeropslag
**Opgave:** Slår ejendommens ejere op og sammenligner med ansøgeren.
**Byggeklodser:** Datafordeler, Sprogmodel
**Lukkede registre:** EJF
**Input:** Adresse
**Output:** Ejere, og om ansøgeren er ejer
## Miniapp
## Indbygget viden
## Forudsætninger
## Åbne spørgsmål
- Under Agenter er hver overskrift med
###én agent. - Linjen Byggeklodser: er en liste med komma imellem. Hvert navn skal være en byggeklods, der findes i AgentBase (navn eller id), en af teamets egne byggeklodser, eller en anden agent i samme plan. En kort bemærkning i parentes efter navnet er i orden:
Sprogmodel (udtræk af beløb). Listen må også stå som en punktliste på linjerne lige under Byggeklodser:. - Linjen Lukkede registre: bruges kun, når agenten læser et lukket register i Datafordeler: EJF, CPR, CPRPERSON eller SVR.
- Under Regler står hver regel kort, med hvor den kommer fra: beskrivelsen, en sags facit eller et dokument i Vidensbank.
- Under Indbygget viden står de dokumenter fra Vidensbank, løsningen skal slå op i, når den kører. Kun dem; resten af projektets materiale bruges ikke af løsningen.
- Er et af dem en fil, I har uploadet — fx en Excel-skabelon, der skal udfyldes — kan løsningen bruge selve filen med ark, formater og formler, ikke kun teksten. Filen skal ikke uploades igen.
- Resten er fri tekst til jer og til assistenten, når den bygger.
Et nyt projekt starter med overskrifterne. En plan, der er skrevet før formatet kom, bliver ikke ændret af sig selv.
Assistenten gemmer kun en plan, der kan bygges
Når assistenten skriver eller retter planen, bliver den tjekket, før den gemmes. Nævner planen en byggeklods, AgentBase ikke har, eller mangler en agent linjen Byggeklodser:, bliver planen ikke gemt, og assistenten skriver den om. Den plan ser I aldrig.
Har opgaven brug for noget, AgentBase ikke kan i dag — fx et opslag i et fagsystem, der ikke findes en byggeklods til — skriver assistenten det under Åbne spørgsmål og siger det i sit svar. Den skriver det ikke som en agent.
Fund under planen
Retter I selv i planen, bliver den altid gemt. Tjekket vises i stedet som rækker over planens tekst, lige under linjen med Rediger og Godkend planen. Rækkerne gælder den gemte plan og bliver stående, mens I redigerer, så I kan se, hvad der skal rettes. Det regnes ud, hver gang siden åbnes, så en byggeklods, der er udfaset, eller en adgang, der er fjernet, også viser sig på en plan, der var i orden i går.
| Fund | Betyder | Det gør I | Godkendelse |
|---|---|---|---|
| Findes ikke | Planen nævner en byggeklods, der ikke findes i AgentBase, eller som er udfaset | Tryk Bed assistenten rette planen, eller ret navnet selv. Rækken forsvinder, når planen ikke længere nævner den | Kan ikke godkendes, så længe rækken står der. Godkend planen er slået fra, og grunden står som første linje over rækkerne |
| Forudsætning | Planen er i orden, men teamet mangler en adgang, den bruger — fx et lukket register i Datafordeler | Tryk Opret opgave. Opgaveformularen åbner under rækken, udfyldt med, hvilken adgang det er, og hvor en administrator sætter den op (Organisation → Integrationer). Du vælger den ansvarlige og trykker Tilføj | Kan godkendes. Agenten kan ikke testes, før adgangen er på plads; den samme række står øverst under Byg med et link tilbage til planen |
| Ikke tjekket | Planen har ingen agenter i formatet, eller en agent mangler linjen Byggeklodser: | Ret formatet, eller bed assistenten gøre det. Det er ikke en fejl i planen | Kan godkendes. Rækken siger blot, at planen ikke er tjekket |
Hvilke adgange et team har, kan kun udviklere og administratorer se. En anmelder ser derfor ikke rækkerne med forudsætninger, men får at vide, hvor mange en udvikler kan se.
Tjekket viser, at de byggeklodser, planen nævner, findes, og hvilke adgange der mangler. Det viser ikke, at løsningen virker på jeres sager. Det finder I ud af under Byg og Afprøv.
En godkendelse gælder én version
Hvert kernedokument har et mærke:
| Mærke | Betyder |
|---|---|
| Godkendt af navn, dato | Den version, der står nu, er godkendt |
| Ændret siden godkendelse | Dokumentet var godkendt, men teksten er ændret siden |
| Ikke godkendt | Ingen har godkendt det endnu |
Godkendelsen gælder præcis den version, du læste. Retter nogen i dokumentet bagefter, skal det godkendes igen. Har du selv ændringer, der ikke er gemt, er Godkend slået fra — gem først, så du godkender det, du ser.
Beskrivelsen kan godkendes af alle i projektgruppen, planen kun af en udvikler. Godkendelser skrives i projektets samtale, så alle kan se, hvem der gjorde hvad.
Har en kollega gemt dokumentet, mens du skrev, får du besked og mister ikke din tekst.