---
title: "Innebygde verktøy"
description: "Be ThunderPhone-stemmeagenter om å avslutte samtaler, videresende innringere, navigere tastevalg, vente på vent, søke i kunnskapsbasen, spille av lyder og sende e-post."
---

Innebygde verktøy lar en agent utføre vanlige samtalehandlinger uten å koble til ditt eget API. De fleste er tilgjengelige automatisk. E-post, lyder og kunnskapssøk vises først etter at du har konfigurert den tilhørende innstillingen eller kilden. Fortell agenten når den skal bruke hver handling i prompten.

| Verktøy | Bruk det til | Slik aktiverer du det | Støttede samtaler |
| --- | --- | --- | --- |
| `end_call` | Avslutt en fullført samtale | Alltid tilgjengelig | Telefon, Talk i nettleseren, widget, simulering og Realtime |
| `transfer_call` | Viderekoble en innringer | Konfigurer viderekobling i prompten | Vanlige telefonsamtaler; innebygd Realtime med `call_events` kan bruke kald viderekobling. Realtime for lagrede agenter utelater det. |
| `send_keypad_input` | Trykk på taster i en telefonmeny | Alltid tilgjengelig i vanlige telefonsamtaler | Telefonsamtaler; innebygd utgående Realtime med `call_events`. Realtime for lagrede agenter utelater det. |
| `no_response` | Fortsett å lytte mens en automatisk meny snakker eller en innringer tenker høyt; en innringer som ber agenten vente, får bare «Selvsagt.» | Alltid tilgjengelig | Alle samtaletyper |
| `wait_on_hold` | Vent stille på at en person kommer tilbake | Inkludert i utgående samtaler | Utgående telefonsamtaler og utgående innebygde Realtime-økter |
| `search_knowledge_base` | Svar basert på vedlagte kilder | Legg ved kunnskap til agenten | Samtaler med lagrede agenter og vedlagt kunnskap |
| `play_sound` | Spill av en konfigurert varslingslyd | **Avansert → Verktøylyd** | Samtaler med lagrede agenter |
| `send_email` | Send e-post til én fast mottaker | **Avansert → Send e-post** | Samtaler med lagrede agenter |

## `end_call`

Avslutter den gjeldende samtalen når prompten ber modellen om det. Den er tilgjengelig som standard og har ingen agentinnstilling.

Skriv betingelsen og eventuell nødvendig avskjed i prompten:

```text
When the caller confirms they need nothing else, say goodbye and end the call.
```

En samtale som avsluttes av modellen, har `end_reason: "ai_hangup"`, også når den avsluttes
etter advarselen om samtalens tidsgrense. Samtalen avsluttes med `max_duration` bare hvis
tidsgrensen nås først, og med `balance_exhausted` når forhåndsbetalt saldo er brukt opp.

## `transfer_call`

Viderekobler en telefoninnringer til et fast nummer oppgitt av modellen. Kald overføring skjer umiddelbart. En screenet varm overføring ringer destinasjonen privat før partene kobles sammen. Varm overføring krever et verifisert importert VoIP-nummer som kan foreta utgående samtaler.

Oppgi destinasjonsnummeret og den nøyaktige rutingbetingelsen i prompten:

```text
If the caller asks for billing, transfer them to +15551234567.
```

En vellykket kald overføring har `end_reason: "ai_transfer"`; en fullført varm overlevering har `end_reason: "ai_warm_transfer"`. Et mislykket varmt forsøk returnerer kontrollen til agenten, så samtalens senere avslutning avgjør avslutningsårsaken. I økter som ikke er telefonsamtaler, avslutter en forespørsel om overføring økten i stedet.

Se [Viderekoble samtaler](/nb/guides/call-transfers) for oppsett i dashbordet og API-et, ruting, screening, feilhåndtering, grenser og testing.

## `send_keypad_input`

Sender DTMF-sifre (telefonens tastatur) `0`–`9`, `*` og `#` til en telefonlinje. Modellen bruker det til å navigere i en IVR, den automatiserte menyen som ber innringere om å trykke på taster. Det er tilgjengelig som standard og har ingen agentinnstilling.

Fortell modellen hvilke menyer den kan navigere i, og hvor forespurte verdier kommer fra. Ikke be den gjette menyalternativer:

```text
Follow the phone menu for account status. Press a key only after the menu
states what that key does. Enter the account number supplied by the caller.
```

Plattformen fjerner tegn som ikke støttes og sender gyldige sifre i riktig rekkefølge. Hvis ingen gyldige sifre gjenstår, eller samtalen ikke kan sende tastaturinndata, returneres feilen til agenten slik at den kan håndtere situasjonen.

## `no_response`

Holder stemmeagenten stille mens et automatisert system fortsatt snakker eller ber den
fortsette å lytte, og mens en innringer tenker høyt («eh, la meg se») eller snur seg
for å snakke med noen andre. Når en innringer ber stemmeagenten vente mens de gjør
noe («ett sekund», «la meg sjekke», «kan du vente litt?») og ikke gir den noe annet
å svare på, sier stemmeagenten bare «Selvsagt.» (ikke «Ta den tiden du trenger») og
venter på at innringeren skal snakke igjen. Stemmeagentens oppfølginger ved stillhet
kjører fortsatt, og blir alltid sagt høyt hvis linjen forblir stille. Dette gjelder
ikke en hilsen fra en ekte person, et spørsmål eller en faktisk ventekø. Den er
tilgjengelig som standard og har ingen agentinnstilling.

Hvis prompten din forteller stemmeagenten hva den skal si når en innringer ber om et
øyeblikk, gjelder prompten.

Vanligvis er den innebygde beskrivelsen nok. For samtaler med mye IVR bør du forsterke grensen i prompten:

```text
Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.
```

Denne handlingen avslutter ikke samtalen.

## `wait_on_hold`

Setter en utgående agent i en stille ventetilstand til en person kommer tilbake.
Modellen bruker den bare etter at den andre parten uttrykkelig sier at agenten
settes på vent. Den er automatisk tilgjengelig i utgående samtaler og har ingen
innstilling i dashbordet.

```text
If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.
```

Ikke be agenten bruke den for en IVRs «vent litt»-melding. Venting varer som
standard i opptil 15 minutter. For vanlige utgående samtaler godtar
`POST /v1/call` en positiv heltallsverdi for `max_hold_seconds`; innebygd
Realtime begrenser `max_hold_seconds` til 10–900 sekunder. Hvis personen
kommer tilbake, fortsetter agenten uten å endre samtalens sluttårsak. Hvis
grensen utløper, avslutter plattformen samtalen med `end_reason: "ai_hangup"`.

## `search_knowledge_base`

Søker i dokumenter som er knyttet til agenten, og returnerer relevante
tekstutdrag. Knytt til en kunnskapsbase eller enkeltstående kunnskapsdokumenter
for å aktivere den, og fortell deretter modellen hvilke svar som må komme fra
disse kildene:

```text
Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.
```

Hvis et søk mislykkes, returneres resultatet til agenten. Se [Kunnskapsbase](/nb/guides/knowledge-base)
for oppsett i dashbordet og API-et.

## `play_sound`

Spiller av agentens konfigurerte varslingslyd etter all tale i samme tur. I
dashbordet angir du **Avansert → Verktøylyd** til **Klokkespill**, **Ding**
eller **Pip**, og distribuerer deretter agenten. **Ingen** fjerner verktøyet.

Med [Agents API](/api-reference/agents) angir du `play_sound_asset` som
`"chime"`, `"ding"` eller `"beep"`, og distribuerer deretter. Angi den som `""`
for å deaktivere verktøyet.

```text
After confirming that an appointment was saved, say "You're all set" and play
the notification sound.
```

En avspillingsfeil returneres til agenten og avslutter ikke samtalen.

## `send_email`

Sender en e-post i ren tekst til den ene mottakeren som er konfigurert av
agentens eier. Modellen oppgir emnet og brødteksten. Den ser aldri en
mottakerparameter og kan ikke velge eller endre adressen.

I dashbordet aktiverer du **Avansert → Send e-post**, lagrer en
mottakeradresse og distribuerer deretter agenten. Med [Agents API](/api-reference/agents)
angir du både `send_email_enabled: true` og en ikke-tom `send_email_recipient`,
og distribuerer deretter. Definer utløseren og det påkrevde innholdet i
prompten:

```text
When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.
```

En samtale kan forsøke å sende maksimalt tre e-poster. Hvert emne er begrenset
til 300 tegn, og hver brødtekst til 20 000 tegn. Manglende konfigurasjon,
ugyldig innhold, grensen per samtale og leveringsfeil returneres til agenten.
En mislykket levering bruker fortsatt ett av de tre forsøkene.

Test med en kontrollert mottaker før du distribuerer bredt. Nettleser-Talk og
simuleringer sender ekte e-post; det finnes ingen tørrkjøringsmodus.

## Kompatibilitetsmerknad

Innstillingen **Avansert → Avbrytelsessikre opplysninger** og det eldre feltet
`speak_uninterruptible_enabled` beholdes for kompatibilitet, men det har ingen
effekt å aktivere dem. La innstillingen være deaktivert; ingen prompt kan
aktivere dette verktøyet.

For en påkrevd opplysning ved starten av samtalen bruker du
**Samtykkemelding**. Den spilles av ordrett før vanlig samtale og kan ikke
avbrytes. Se [Lover om samtykke til samtaleopptak](/nb/guides/recording-consent-laws).

## Test og overvåk innebygde verktøy

Bruk nettleser-Talk eller en simulering for å kontrollere prompting,
kunnskapssøk, lyder og e-post. Disse miljøene kan ikke gjenskape atferd i
telefonnettverket. Test tastaturnavigasjon og venting i en utgående
telefonsamtale, og test en fullstendig varm overføring i en ekte samtale med et
kvalifisert importert VoIP-nummer. Realtime-støtte er begrenset som vist i
tabellen ovenfor.

## Samtaler, priser og webhooks

Innebygde handlinger har ingen verktøyavgift per bruk. Vanlige samtale- og leverandørkostnader
gjelder fortsatt; se [Priser](/nb/guides/pricing). Samtalene og resultatene deres kan vises
i det fullførte transkriptet, men de utløser ikke `telephony.tool` eller `web.tool`.
Disse hendelsene er for [brukerdefinerte funksjoner](/nb/tools/overview). Bare en fullført
avslutning eller viderekobling endrer samtalens `end_reason`; andre feil returneres
til agenten. Se [Fullføringswebhooks](/nb/webhooks/call-complete) for samtaleposten.