Verktygsanrop: designen som avgör om agenten fungerar

Bygga agenter 9 min läsning

En rad märkta verktyg upphängda i ordning över en arbetsbänk
Smala verktyg med ärliga fel är billigaste träffsäkerhetsvinsten som finns.

När en agent beter sig illa är det första teamet gör att skriva om prompten. Vår erfarenhet är att prompten sällan är den bindande begränsningen. Verktygsytan är det.

En modell som får ett tvetydigt verktyg med lösa argument kommer att missbruka det. Ett smalt verktyg med ett strikt schema och ett ärligt felmeddelande är svårt att använda fel.

Sex regler för verktygsdesign#

  1. Ett verktyg, en avsikt. `boka_mote` slår `kalender_atgard(typ, ...)`.
  2. Strikta scheman: uppräkningar i stället för fritext, obligatoriska fält faktiskt obligatoriska.
  3. Beskrivningen är en prompt: säg när verktyget ska användas och när det inte ska.
  4. Fel ska instruera: `kunden hittades inte; be om e-postadress` slår `500`.
  5. Returnera lite: de fält agenten behöver, inte hela objektet.
  6. Sidoeffekter tar en idempotensnyckel.

Vad kostnaden ser ut som#

Verktygsanrop: designen som avgör om agenten fungerar — Vad kostnaden ser ut som
DesignTypiskt utfall
Ett brett verktyg med tolv valfria fältModellen gissar; hög felfrekvens
Fem smala verktyg med uppräkningarStabila argument; läsbara spår
Fel som stackspårningLoopen försöker igen blint
Fel som instruktionLoopen frågar användaren eller byter väg
Hela objektet returnerasKontexten svämmar över, kostnad stiger

Validera på serversidan, alltid#

Schemat vägleder modellen, det tvingar inte. Varje verktyg måste validera sina argument och kontrollera rättigheter för den verkliga slutanvändaren innan något händer.

Anta att argumenten kan komma från en angripare via ett dokument agenten läste.

Hur ni mäter förbättringen#

Räkna andelen giltiga verktygsanrop, andelen körningar som når mål utan mänsklig hjälp och medelantalet varv. En verktygssammanslagning som halverar antalet varv är oftast större vinst än ett modellbyte.

Vanliga frågor

Hur många verktyg klarar en agent?

I praktiken fem till åtta tydliga verktyg per agent.

Ska verktygsfel gå till modellen?

Ja, i kort och instruerande form — men logga det fulla felet på serversidan.

Hjälper strikta uppräkningar verkligen?

Mer än nästan allt annat. De tar bort hela klasser av ogiltiga argument.

verktygsanropfunktionsanrop llmverktygsdesign agentjson-schema verktygagentens träffsäkerhet

Alla guider

Senast uppdaterad 2026-08-05 av aiagentdevelopment.info · Om oss

Skrivet av byggare

Varje guide skrivs av ingenjörer som driver agenter i produktion, inte omskriven från andra sajter.

Granskat enligt schema

Fältet rör sig snabbt. Varje guide bär datum för senaste granskning, som publiceras även när inget ändrats.

Inga betalda placeringar

Ingen modellleverantör, ramverk eller agentplattform kan köpa omnämnande, placering eller länk.

Tolv språk

Varje guide är översatt, inte maskinbytt — varje språk har egen webbadress och eget granskningsdatum.

Gränser utskrivna

Vi säger rakt ut när en uppgift inte behöver en agent och ett vanligt skript blir billigare och pålitligare.