Skills in de console¶
Het concept achter agents staat in Agents.
In het onderdeel Skills voeg je herbruikbare instructiepakketten voor je organisatie toe en bekijk, vervang en verwijder je ze. Een skill beschrijft hoe je een taak uitvoert, zoals release notes schrijven of tickets beoordelen.
Je hebt een beheerdersaccount van de organisatie nodig, en de capability skills moet in het
plafond van de organisatie aanstaan. Hetzelfde doe je met een sleutel in
Skills via de API.
Een skill toevoegen¶
Kies Skill toevoegen. Het formulier opent als eigen pagina en biedt twee manieren om hetzelfde pakket in te vullen, te wisselen met de tabs Velden en SKILL.md.
Velden is de standaard: Identifier, Omschrijving en Instructies. De identifier is waarmee een aanroep en het model deze skill kiezen; het veld zet zelf om naar kleine letters en cijfers, woorden verbonden met een streepje, maximaal 64 tekens. Schrijf de omschrijving voor het model; daaruit besluit het of het de skill nodig heeft.
SKILL.md is het ruwe bestand: een metadatablok tussen ----regels met name en
description, gevolgd door de instructies.
---
name: release-notes
description: Schrijf release notes voor één versie op basis van een lijst gemergede wijzigingen.
---
Groepeer de wijzigingen onder Toegevoegd, Gewijzigd, Opgelost. Eén regel per stuk, in de
verleden tijd, die noemt wat een lezer nu kan. Noem nooit een intern ticketnummer.
Wissel je van Velden naar SKILL.md, dan worden de velden samengevoegd tot het bestand; wissel je
terug, dan wordt het ontleed. Een bestand dat niet ontleed kan worden houdt je op het tabblad
SKILL.md, met de reden. Front-matter-sleutels zonder veld (license, compatibility,
allowed-tools) blijven staan zoals geschreven.
Een bestaande skill bewerken opent in Velden met de opgeslagen waarden. De naam kan niet wijzigen: Core weigert een vervanging onder een andere naam, dus voeg dan een nieuwe skill toe.
Gebruik onder Bestanden de knop Bestand toevoegen om het pad en de inhoud van elk
ondersteunend tekstbestand in te vullen, of Map uploaden om een map in één keer toe te voegen:
een SKILL.md in de hoofdmap wordt de skill en elk ander tekstbestand wordt een rij met zijn
relatieve pad. Binaire bestanden en bestanden die de gezamenlijke groottegrens overschrijden worden
overgeslagen en genoemd. Paden moeten relatief en uniek zijn.
Een skill bekijken¶
Klik op een rij om de skill te openen. Haar eigen pagina toont de instructies, de maker en de bestandenlijst. Kies Toon bij een bestand om de inhoud te laden; die wordt pas dan opgehaald.
Aangemaakt door toont het id van de sleutel die de skill aanmaakte, of de consolegebruiker met
het voorvoegsel operator:.
Een skill wijzigen¶
Kies Bewerken op de pagina van de skill. Opslaan vervangt de volledige skill, inclusief alle bestanden, dus laadt het formulier eerst elk bestand. Bij grote pakketten kan dit even duren.
De naam van een skill kan niet worden gewijzigd. Maak voor een andere naam een nieuwe skill aan, pas de verwijzingen in aanroepers aan en verwijder de oude skill zodra die niet meer nodig is.
Concepten¶
Elke keer opslaan schrijft de volgende versie van de skill. Opslaan als v… publiceert haar meteen; Opslaan als concept v… houdt haar weg van elke sleutel tot je haar publiceert (elke knop noemt het nummer dat de versie krijgt). Een nieuwe skill die je als concept opslaat, heet concept in de lijst en op zijn pagina, en bestaat nog voor geen enkele sleutel.
De pagina van de skill toont onder de instructies de Versies, nieuwste eerst, elk concept gemarkeerd als concept. Wacht er een concept dat nieuwer is dan de gepubliceerde versie, dan opent Concept v… klaar het. Een geopend concept zegt dat geen sleutel het ziet en biedt Publiceren en Concept weggooien, elk na een bevestiging. Publiceren maakt het concept wat elke sleutel laadt waar die de skill zonder versie noemt; een agent die een eerdere versie vastzet, houdt die. Een concept dat een concept van een agent vastzet, kun je pas weggooien als dat concept van de agent verandert; de bevestiging noemt de agent, als link.
Een skill verwijderen¶
Verwijderen wist de skill. Zolang de laatste versie van een agent de skill nog koppelt, weigert
Core het verwijderen met een 409 die die agents noemt; de bevestiging blijft open en toont de
lijst, elke agent een link naar zijn pagina. Haal eerst de koppeling uit de agent weg. Is de skill
eenmaal verwijderd, dan krijgen verzoeken die haar rechtstreeks noemen 404.
Labels¶
Gebruik Labels om skills in te delen, bijvoorbeeld department: payroll. Je bewerkt ze in
het formulier; opslaan vervangt alle labels van de skill.
Regels over Skills in de policy van een sleutel vergelijken deze labels met de attributen van een persoon (Regels over een persoon). Onder de standaardregels bereikt elke persoon alles wat de sleutel bereikt. Zie Bouwen voor personen.
Lege lijsten en toegangsbeperkingen¶
“Nog geen skills” betekent dat er voor deze organisatie geen skills zijn aangemaakt.
Zie je skills staat uit voor deze organisatie, dan staat Skills registreren en gebruiken uit in het plafond van de organisatie. De beheerder van de organisatie erboven zet het aan bij Toegestane capabilities op Instellingen; voor een organisatie zonder bovenliggende organisatie doet je operator dat. De knop opent Instellingen.