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 og beskrivelse. 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
- Aktivér som chat-værktøj — lader Chat kalde appen som et værktøj. Beskrivelsen fortæller sprogmodellen, hvad værktøjet gør, og er derfor påkrævet, når kontakten er slået til
- Beskrivelse — hvad appen gør
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. To ting blokerer ikke knappen, men afvises først, når du har bekræftet: en privat udgivelse (se Adgang under Drift) og en app, der allerede er udgivet i Galleriet (se Udgiv som byggeklods).