PPROMPTGUIDE Bygg en prompt
Når modellen får gjøre mer enn å svare

Verktøykall og funksjoner for KI-agenter

Et verktøykall er et forslag fra modellen til applikasjonen. Koden må validere argumentene, kontrollere tillatelsen, utføre handlingen og returnere resultatet.

Fem ledd i et verktøykall

  1. Applikasjonen gir modellen navn, beskrivelse og argumenter for tillatte verktøy.
  2. Modellen foreslår null, ett eller flere kall.
  3. Applikasjonen validerer navn, argumenter, identitet og tillatelse.
  4. Koden utfører verktøyet og returnerer et strukturert resultat.
  5. Modellen bruker resultatet i neste svar eller foreslår et nytt kall.
Viktig: Modellen har ikke «utført» noe bare fordi den produserte et funksjonskall. Applikasjonen bestemmer om og hvordan det kjøres.

Skriv verktøybeskrivelsen som en kontrakt

Navn: finn_kunde
Formål: Hent en eksisterende kunde når en entydig kunde-ID er kjent.

Bruk når:
- brukeren ber om informasjon om én bestemt kunde

Ikke bruk når:
- kunde-ID mangler; be først om avklaring
- oppgaven gjelder fritekstsøk; bruk sok_kunder

Argumenter:
- kunde_id: streng, påkrevd, må matche ^K-[0-9]{6}$

Returnerer:
- id, navn, status og tidspunkt for siste oppdatering

Feil:
- NOT_FOUND betyr at ingen kunde matcher; ikke gjett en annen ID.

Minste nødvendige verktøyflate

Overlappende verktøy og uklare parametere øker feilvalg. Bruk tydelige navn, strenge skjemaer og minst mulig returdata. Skill lesing fra skriving, og legg godkjenning foran irreversible eller eksterne handlinger.

Evaluer ruten, ikke bare svaret

Test om agenten velger riktig verktøy, sender gyldige argumenter, håndterer tomme treff og bruker resultatet korrekt. Se også menneskelige godkjenningspunkter og MCP.

Kilder