Lägga till kunskaper

Föregående sida visade hur verktyg låter agenter agera – anropa funktioner, fråga API:er, söka på webben. Men när du skapar fler agenter uppstår ett mönster: samma kluster med verktyg, instruktioner och referensmaterial visas hela tiden tillsammans. Funktionen "fila en utgiftsrapport" är inte bara ett verktyg – det är ett valideringsskript, en uppsättning principdokument, stegvisa instruktioner om hur du fyller i formuläret och kunskap om utgiftsgränser. Det slutar med att du kopierar det här paketet från agent till agent och att det inte är synkroniserat.

Kunskaper löser det här problemet. En färdighet är ett bärbart paket som paketera instruktioner, referensmaterial och valfria skript i en enda enhet som alla agenter kan identifiera och läsa in på begäran. Färdigheter följer en öppen specifikation så att de kan återanvändas mellan agenter, team och till och med produkter.

När du ska använda detta

Lägg till färdigheter i din agent när:

  • Du har ett kluster med relaterade kunskaper – instruktioner, referensdokument och skript – som logiskt hör ihop (till exempel "kostnadsrapportering" eller "riktlinjer för kodgranskning").
  • Flera agenter behöver samma domänexpertis och du vill ha en enda sanningskälla i stället för duplicerade instruktioner.
  • Du vill dela och distribuera agentfunktioner mellan team, projekt eller organisationer som fristående paket.
  • Du måste hantera kontexten effektivt – färdigheter använder progressivt avslöjande så att agenter bara läser in den information de behöver, när de behöver det.

Överväganden

Att tänka på Detaljer
Återanvändbarhet En färdighet är ett fristående paket. När den är skapad kan vilken agent som helst hämta upp den – inget klipp och klistra, inga skillnader mellan kopior.
Kontexteffektivitet Färdigheter använder progressiv avslöjning: agenten ser en kort beskrivning (~100 tokens) från början och läser in fullständiga instruktioner endast när det är relevant. Detta håller kontextfönstret enkelt när färdigheten inte behövs.
Abstraktionskostnad Färdigheter lägger till ett abstraktionslager ovanpå verktyg. För ett enda fristående funktionsverktyg är det onödigt att lägga till en kompetensomslutning.
Designarbete Du måste tänka på kunskapsgränser direkt: vad som hör hemma i färdigheten och vad som stannar utanför. Dåliga gränser leder till färdigheter som är för breda (slösar kontext) eller för smala (förlorar paketeringsförmånen).

Hur färdigheter skiljer sig från verktyg

Verktyg och färdigheter kompletterar varandra, inte konkurrerar. Att förstå skillnaden hjälper dig att bestämma när du ska nå för var och en.

Ett verktyg är en enda anropsbar åtgärd – en funktion med ett namn, en beskrivning och ett parameterschema. När modellen bestämmer att ett verktyg behövs genererar den ett strukturerat anrop, Agent Framework kör det och resultatet återgår till modellen. Verktyg är atomerna i agentbeteendet.

En färdighet är ett paket med domänexpertis. Den kan omfatta:

  • Instruktioner – stegvis vägledning, beslutsregler och exempel som talar om för agenten hur de ska närma sig en domän.
  • Referensmaterial – principdokument, vanliga frågor och svar, mallar och annan kunskap som agenten kan konsultera på begäran.
  • Skript – körbar kod som agenten kan köra för att utföra specifika åtgärder (till exempel ett valideringsskript som kontrollerar utgiftsdata mot principregler).

Den viktigaste skillnaden är en av omfånget: ett verktyg ger agenten möjlighet att utföra en åtgärd. en färdighet ger agenten kunskap och resurser för att hantera en hel domän.

Verktyg Färdighet
Vad det ger En enda exekverbar åtgärd Instruktioner + referensmaterial + valfria skript
Hur agenten använder den Anropar den när den behöver agera Läser in den när den stöter på en relevant uppgift, läser instruktioner och kan anropa skript eller konsultera resurser
Kontextkostnad Verktygsschemat finns alltid i prompten Endast kunskapsnamnet och beskrivningen (~100 token) finns i prompten. fullständigt innehåll läses in på begäran
Portabilitet Knuten till agenten som registrerar den Fristående paket som alla kompatibla agenter kan identifiera
Bäst för Enskilda åtgärder (fråga en databas, skicka ett e-postmeddelande) Domänexpertis (utgiftsprinciper, riktlinjer för kodgranskning, registreringsförfaranden)

Tips/Råd

Tänk på verktyg som verb (sökning, bok, validering) och färdigheter som expertis (resebokningskunskap, kunskap om utgiftspolicy). En agent använder verktyg för att agera och färdigheter för att veta hur man agerar.

Hur färdigheter fungerar: progressivt avslöjande

Färdigheter är utformade för att vara kontexteffektiva. I stället för att mata in allt i prompten direkt använder färdigheterna ett mönster i tre steg:

┌──────────────────────────────────────────────────────────────────┐
│  Stage 1: Advertise                                              │
│  Agent sees skill names and descriptions (~100 tokens each)      │
│  in its system prompt at the start of every run.                 │
└──────────────┬───────────────────────────────────────────────────┘
               ▼ (task matches a skill's domain)
┌──────────────────────────────────────────────────────────────────┐
│  Stage 2: Load                                                   │
│  Agent calls load_skill to get the full instructions             │
│  (< 5000 tokens recommended).                                   │
└──────────────┬───────────────────────────────────────────────────┘
               ▼ (agent needs more detail)
┌──────────────────────────────────────────────────────────────────┐
│  Stage 3: Read resources                                         │
│  Agent calls read_skill_resource to fetch supplementary files    │
│  (FAQs, templates, reference docs) only when needed.            │
└──────────────────────────────────────────────────────────────────┘

Det här mönstret innebär att en agent med 10 registrerade kunskaper betalar ungefär 1 000 token för kontextkostnader – inte 50 000. Agenten fördjupar bara sina kunskaper när den aktuella uppgiften kräver det.

Dessutom byggs färdigheter ovanpå verktygsinfrastrukturen. Agent Framework annonserar tillgängliga färdigheter i agentens systemprompt och exponerar sedan load_skill och read_skill_resource som verktygsanrop som agenten använder för att successivt ladda in innehåll.

Tips/Råd

Fullständig information om kunskapsstruktur, konfiguration och kodexempel finns i referensen agentkunskaper .

När du ska använda färdigheter jämfört med andra mönster

När agenten blir mer kapabel kan du ordna dess beteende på flera olika sätt. Så här jämför du kunskaper med verktyg:

Mönster Passar bäst för Exempel
Enskilda verktyg Engångsåtgärder som inte behöver en delad kontext Ett get_weather funktionsverktyg
Färdigheter Domänexpertis med instruktioner, referenser och valfria skript En "utgiftsrapport"-färdighet med principdokument, valideringsskript och stegvisa arkiveringsinstruktioner

Vanliga problem

Fallgrop Riktlinjer
Alltför breda färdigheter En färdighet som kallas "allt-om-ekonomi" som försöker täcka redovisning, skatter, utgiftsrapporter och löner kommer att ha instruktioner som är för långa och ofokuserade. Håll kunskaperna fokuserade på en domän.
Hoppar över säkerhetsgranskning Kunskapsinstruktioner matas in i agentens kontext och skript kör kod. Behandla kunskaper som beroenden från tredje part – granska dem innan du distribuerar dem. Se metodtipsen för säkerhet i kunskapsreferensen.
Ignorera progressivt avslöjande Om din SKILL.md är 2 000 rader lång betalar agenten en stor kontextkostnad när den läser in färdigheten. Håll instruktionerna koncisa och flytta detaljerat referensmaterial för att separera resursfiler för att dra full nytta av progressivt avslöjande.

Nästa steg

När din agent har verktyg och färdigheter är nästa steg att lägga till mellanprogram – övergripande beteenden som skyddsräcken, loggning och innehållsfiltrering som gäller för varje interaktion utan att ändra agentens kärnlogik.

Lägga till mellanprogram

Gå djupare:

  • Last updated on