Udgivelsessiden
Udgivelse er den ene side, hvor du bestemmer, hvad omverdenen ser af din
agent — og hvorfra du udgiver den. Ruten er /agenter/:id/konfiguration.
Siden beskriver én kontrakt: hvilke inputs agenten beder om, og hvilke outputs den leverer. Den kontrakt læses af begge de udgange, siden har — appens brugere ser den som en formular, og et flow, der bruger agenten som byggeklods, forbinder til den som handles. Derfor forgrener vejen sig først nederst på siden, ikke i to forskellige opsætninger.
Adgang
- Udvikler, Administrator: Kan åbne siden og udgive
- Du skal desuden have redigeringsadgang til den konkrete agent
Sådan åbner du siden
| Fra | Hvordan |
|---|---|
| Editoren | Knappen Udgivelse i værktøjslinjen. Den gemmer agenten først og åbner så siden |
| Agentens detaljeside | Knappen Udgivelse øverst — eller under Hurtige handlinger |
| Apps → Ny app | Vælg en agent og klik Gå til Udgivelse |
Editoren indsender og udgiver aldrig selv. Al udgivelse sker herfra, så en version aldrig kan nå ud med en kontrakt, ingen har set på.
Siden har to halvdele
Øverst på siden står, hvad det betyder at gemme her:
Konfigurationen her er en del af agentens indhold og fryses sammen med agenten, når du sender til kvalitetskontrol. Versionen ændrer sig ikke, når du gemmer, så dine tests gælder stadig — men en godkendt agent sættes tilbage til kladde og skal godkendes i kvalitetskontrol igen, før den kan udgives.
Det er den vigtigste skelnen på siden:
| Halvdel | Overskrift på siden | Betydning |
|---|---|---|
| Kontrakten | Fryses med versionen | Inputs, outputs, chat-værktøj, beskrivelse og godkendelsestrin. Fryses ind i versionen og indgår i kvalitetskontrol og forsegling |
| Drift | Kan ændres uden ny kvalitetskontrol | Brugervejledning, service-besked og adgang. Kan rettes når som helst — også på en udgivet app — uden at røre versionen |
Inputs og outputs
De to lister er udledt af flowet: hvert input, agenten kan modtage, og hvert færdigt output, den producerer.
For hvert felt kan du:
- Slå det til eller fra med kontakten — slukkede felter vises ikke for brugerne og eksponeres ikke som handles
- Omdøbe det — navnet er det, appens brugere og andre flows ser
For inputs er der desuden:
| Kontrol | Betyder |
|---|---|
| Påkrævet | Feltet skal udfyldes, før appen kan køre |
| Gruppe | Betinget påkrævet: inputs med samme gruppenavn kræver, at mindst ét af dem udfyldes. Fx "Upload dokument" og "Indsæt tekst" i gruppen kilde |
| Brug standardværdi | Vis agentens egen standardværdi som udgangspunkt i stedet for et tomt felt. Vises kun for inputs, der har en standardværdi |
Første gang du åbner siden for en agent, læser AgentBase flowet og foreslår feltnavne, beskrivelse og brugervejledning. Forslag er markeret med chippen Forslag, som forsvinder, så snart du selv retter feltet. Vil du have et nyt bud på en hel sektion, klikker du Foreslå igen ved Inputs eller Outputs — har du selv navngivet felter dér, bliver du spurgt først.
Kan en byggeklods i flowet ikke indlæses, vises en advarsel, og den gemte opsætning for dens felter bevares uændret.
Fryses med versionen
- Beskrivelse — hvad appen gør. Den bruges som værktøjsbeskrivelse for sprogmodellen, hvis appen udgives som chat-værktøj; selve kontakten Chat-værktøj sættes, når appen udgives (Aktivér som i kvalitetskontrollen), ikke her
- Godkendelsestrin — se nedenfor
Godkendelsestrin
Et godkendelsestrin får kørslen til at stoppe ved et bestemt output og vente, til en person har set værdien og godkendt den. Godkendes den, fortsætter kørslen med de næste trin. Afvises den, stopper kørslen helt. Værdien kan ikke rettes undervejs. Brug det fx til et brev, der skal læses, før det sendes.
- Klik Tilføj godkendelsestrin
- Vælg under Hvilket output skal godkendes? det output, der skal godkendes. Du kan vælge output fra alle byggeklodser i flowet — ikke kun de færdige resultater — for det, en person skal se, ligger typisk lige før det trin, der sender det
- Udfyld felterne, og klik Gem konfiguration
| Felt | Betyder |
|---|---|
| Spørgsmål til godkenderen | Overskriften godkenderen ser, fx Skal opsigelsen sendes? Står feltet tomt, bruges Godkend kørsel |
| Hvad sker der, når det godkendes? | Vises under værdien. Fortæl, hvad kørslen gør bagefter |
| Hvem må godkende | Teamet (Reviewer og op): alle i flowets team med rollen Anmelder eller højere. Navngivne personer: præcis de personer, du vælger under Navngivne godkendere — de behøver ikke være anmeldere, for valget her giver dem retten. Vælg mindst én |
| Svarfrist (timer) | Så længe kørslen venter på svar. Standard er 72 timer, højst 720 (30 dage). Uden svar stopper kørslen |
| Den, der startede kørslen, må selv godkende | Slået til som standard. Slå fra for at kræve, at en anden ser værdien først |
Står Hvem må godkende på Navngivne personer, uden at du har valgt nogen, kan du ikke gemme — siden siger det, når du klikker Gem konfiguration.
Du fjerner et trin igen med Fjern godkendelsestrin. Sletter du den byggeklods, trinnet sidder på, vises en advarsel, og trinnet fjernes, når du gemmer.
Godkendelsestrin er en del af kontrakten: de fryses med versionen og ses i kvalitetskontrollen. Når kvalitetskontrollen kører agentens tests, stopper de ikke ved trinnet. Hvor godkenderne får besked — indbakke, e-mail eller app-skærm — vælges bagefter på appen, se App-indstillinger. Selve beslutningen tages under Godkendelser.
Der gælder tre begrænsninger:
- Ikke inde i en løkke. Et output mellem Løkke Start og Løkke Slut kan ikke vælges. Læg trinnet på Løkke Slut eller på et trin uden for løkken
- Ikke som byggeklods. Et flow med et godkendelsestrin kan ikke udgives som byggeklods — trinnet skal sidde i det flow, brugeren selv kører
- Ikke indlejret. En app med et godkendelsestrin kan ikke bruges i Embed Widget
Drift
- Brugervejledning — vises til brugerne, når de åbner appen. Markdown understøttes
- Service-besked — kort besked til appens brugere, fx om nedetid
- Adgang — hvem må bruge udgivelsen
Adgang
Niveauet gælder både appen i Galleriet og byggeklodsen i andre flows — det er én udgivelse med to eksponeringer.
| Niveau | Betyder |
|---|---|
| Team | Teamets medlemmer kan bruge udgivelsen |
| Organisation | Alle i organisationen kan bruge udgivelsen |
| Privat | Kun dig. Kan ikke vælges her, men vises, hvis udgivelsen allerede er privat — en byggeklods kan ikke være privat |
Er udgivelsen privat, står der en advarsel i sektionen:
Udgivelsen er privat. En byggeklods skal kunne bruges af andre, så vælg Team eller Organisation for at udgive den som byggeklods.
Knappen Udgiv som byggeklods er ikke slået fra af det — bekræftelsesdialogen gentager sætningen, og først når du bekræfter, afviser AgentBase udgivelsen. Vælg Team eller Organisation under Adgang først.
Hvor et valg lander, afhænger af, om agenten allerede har en udgivelse:
- Ingen udgivelse endnu: felterne er en skabelon, som den første udgivelse arver
- Har en app: felterne er appens, og en ændring gælder appen med det samme, når du gemmer — også mens den er udgivet
Gem konfiguration
Gem konfiguration nederst gemmer begge halvdele. Knappen er slået fra, når der ikke er noget at gemme.
At gemme kontrakten er en indholdsændring: den bumper ikke versionen (dine tests gælder stadig), men en godkendt agent sættes tilbage til kladde og skal gennem kvalitetskontrol igen, før den kan udgives. En ændring i Drift-halvdelen gør ingen af delene.
Forlader du siden med ugemte ændringer, bliver du spurgt først.
Udgang 1: Send til kvalitetskontrol
Sektionen ligger nederst på siden med de felter, indsendelsen bærer — versionsnavn og udgivelsesnoter, begge foreslået af AgentBase — og en kvittering for, hvilke af agentens tests der følger med. Klikker du Send til kvalitetskontrol, gemmes konfigurationen først, og derefter fryses versionen.
Se Send til kvalitetskontrol for hele forløbet.
Udgang 2: Udgiv som byggeklods
Udgiv som byggeklods gør agenten tilgængelig som ét step i andre flows — uden kvalitetskontrol. Kvaliteten bedømmes dér, hvor den færdige app anmeldes, fordi det er der, den samlede adfærd kan vurderes.
Knappen gemmer konfigurationen og spørger så, hvem byggeklodsen når ud til:
Bekræfter du:
- Den gemte version fryses som en byggeklods-udgivelse
- Agenten dukker op i byggeklods-vælgeren under kategorien Agent-byggeklodser for alle, der har adgang
- Agentens status ændres ikke, men pillen på agent-listen viser Udgivet som byggeklods
Så længe andre flows bruger byggeklodsen, kan du ikke slå den fra — de flows skal først fjerne den. Det er med vilje: ellers ville deres step holde op med at virke uden varsel.
Kontakten sidder bagefter på appen under Eksponering, se App-indstillinger.
En udgivelse serverer én version, så den strengeste eksponering bestemmer. Er appen udgivet i Galleriet, kan den kun køre en version, der er godkendt i kvalitetskontrollen — og AgentBase spørger om det, før versionen fryses. En version, der ikke findes endnu, er aldrig godkendt, så Udgiv som byggeklods her på siden kan aldrig lykkes for sådan en app. Det gælder også, selv om du lige har fået en version godkendt.
Afvisningen er ikke en slukket knap: du klikker, bekræfter i dialogen, og får så beskeden
Appen "…" er udgivet i Galleriet, så den kan kun køre en version, der er godkendt i kvalitetskontrollen. Send versionen til kvalitetskontrol, eller fjern appen fra Galleriet.
Vejen videre går ikke herfra: en app i Galleriet gøres til byggeklods med kontakten Eksponering på selve appen, som kun kræver, at appen er udgivet. Se App-indstillinger.
Nye versioner af en byggeklods
En byggeklods er versioneret som enhver anden byggeklods: versionen ligger i
dens type (app:…@2). Udgiver du en ny version, får den et nyt nummer, og
flows, der allerede bruger den gamle, bliver på den, indtil deres ejer
opgraderer. Ingen byggeklods-version fjernes.
Husk, at en udgivelse kun serverer én version ad gangen: er den samme udgivelse også en app i Galleriet, er det den strengeste eksponering, der bestemmer, hvilken version der må serveres — og så skal versionen godkendes i kvalitetskontrollen først.
Hvad kan blokere udgivelsen
| Besked | Hvor | Årsag |
|---|---|---|
| Tilføj en byggeklods før du kan udgive agenten | Editorens Udgivelse-knap | Flowet er tomt, så døren hertil er lukket |
| Denne version er arkiveret og kan ikke sendes til kvalitetskontrol | Send til kvalitetskontrol | Agenten er arkiveret — gendan den først |
| Denne version er arkiveret og kan ikke udgives | Udgiv som byggeklods (og editorens Udgivelse-knap) | Samme årsag — gendan agenten først |
| Denne version blev afvist i kvalitetskontrollen … | Send til kvalitetskontrol | Gem en reel ændring af agenten eller konfigurationen, før du kan indsende igen |
Beskederne vises som hover-tekst på den slukkede knap. Tre ting blokerer ikke knappen, men afvises først, når du har bekræftet: en privat udgivelse (se Adgang under Drift), en app, der allerede er udgivet i Galleriet (se Udgiv som byggeklods), og et flow med et godkendelsestrin.