---
title: "બિલ્ટ-ઇન ટૂલ્સ"
description: "ThunderPhone એજન્ટોને કૉલ સમાપ્ત કરવા, કૉલર્સને ટ્રાન્સફર કરવા, કીપેડમાં નેવિગેટ કરવા, હોલ્ડ પર રાહ જોવા, જ્ઞાન શોધવા, અવાજો વગાડવા અને ઇમેઇલ મોકલવા માટે prompt આપો."
---

બિલ્ટ-ઇન ટૂલ્સ એજન્ટને તમારી પોતાની API કનેક્ટ કર્યા વિના સામાન્ય કૉલ ક્રિયાઓ કરવાની સુવિધા આપે છે. મોટાભાગનાં ટૂલ્સ આપમેળે ઉપલબ્ધ હોય છે; ઇમેઇલ, સાઉન્ડ્સ અને નૉલેજ સર્ચ સંબંધિત સેટિંગ અથવા સોર્સ કન્ફિગર કર્યા પછી જ દેખાય છે. એજન્ટને તેના promptમાં દરેક ક્રિયાનો ઉપયોગ ક્યારે કરવો તે જણાવો.

| ટૂલ | તેનો ઉપયોગ | તેને કેવી રીતે સક્ષમ કરવું | સપોર્ટેડ કૉલ્સ |
| --- | --- | --- | --- |
| `end_call` | પૂર્ણ થયેલી વાતચીત સમાપ્ત કરો | હંમેશાં ઉપલબ્ધ | ફોન, બ્રાઉઝર Talk, વિજેટ, સિમ્યુલેશન અને Realtime |
| `transfer_call` | ફોન કૉલરને રૂટ કરો | promptમાં રૂટિંગ કન્ફિગર કરો | સામાન્ય ફોન કૉલ્સ; `call_events` સાથેનું ઇનલાઇન Realtime કોલ્ડ ટ્રાન્સફરનો ઉપયોગ કરી શકે છે. સેવ કરેલા એજન્ટનું Realtime તેને સામેલ કરતું નથી. |
| `send_keypad_input` | ફોન મેનૂમાં કી દબાવો | સામાન્ય ફોન કૉલ્સમાં હંમેશાં ઉપલબ્ધ | ફોન કૉલ્સ; `call_events` સાથેનું ઇનલાઇન આઉટબાઉન્ડ Realtime. સેવ કરેલા એજન્ટનું Realtime તેને સામેલ કરતું નથી. |
| `no_response` | ઑટોમેટેડ મેનૂ બોલતું હોય ત્યારે સાંભળતા રહો | હંમેશાં ઉપલબ્ધ | તમામ કૉલ પ્રકારો |
| `wait_on_hold` | વ્યક્તિ પાછી આવે તેની શાંતિથી રાહ જુઓ | આઉટબાઉન્ડ કૉલ્સમાં સામેલ | આઉટબાઉન્ડ ફોન અને આઉટબાઉન્ડ ઇનલાઇન Realtime સેશન્સ |
| `search_knowledge_base` | જોડાયેલા સોર્સમાંથી જવાબ આપો | એજન્ટ સાથે નૉલેજ જોડો | જોડાયેલા નૉલેજ સાથેના સેવ કરેલા એજન્ટ કૉલ્સ |
| `play_sound` | કન્ફિગર કરેલો નોટિફિકેશન સાઉન્ડ વગાડો | **એડવાન્સ્ડ → ટૂલ સાઉન્ડ** | સેવ કરેલા એજન્ટ કૉલ્સ |
| `send_email` | એક નિશ્ચિત પ્રાપ્તકર્તાને ઇમેઇલ મોકલો | **એડવાન્સ્ડ → ઇમેઇલ મોકલો** | સેવ કરેલા એજન્ટ કૉલ્સ |

## `end_call`

જ્યારે prompt મોડલને આમ કરવા કહે ત્યારે વર્તમાન કૉલ સમાપ્ત કરે છે. તે ડિફૉલ્ટ રૂપે ઉપલબ્ધ છે અને તેમાં કોઈ એજન્ટ સેટિંગ નથી.

promptમાં શરત અને જરૂરી હોય તો વિદાય ઉમેરો:

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

સામાન્ય મોડલ-સમાપ્ત કૉલમાં `end_reason: "ai_hangup"` હોય છે. સમયગાળા અથવા બેલેન્સને કારણે થતા શટડાઉનમાં તેના બદલે વધુ ચોક્કસ એન્ડ રીઝન હોઈ શકે છે.

## `transfer_call`

મોડલ દ્વારા આપવામાં આવેલા નિશ્ચિત નંબર પર ફોન કૉલરને ટ્રાન્સફર કરે છે. કોલ્ડ ટ્રાન્સફર તાત્કાલિક થાય છે. સ્ક્રીન કરેલું વૉર્મ ટ્રાન્સફર પક્ષોને કનેક્ટ કરતાં પહેલાં ખાનગી રીતે ગંતવ્યને કૉલ કરે છે. વૉર્મ ટ્રાન્સફર માટે ચકાસાયેલ ઇમ્પોર્ટેડ VoIP નંબર જરૂરી છે જે આઉટબાઉન્ડ કૉલ કરી શકે.

promptમાં ગંતવ્ય નંબર અને ચોક્કસ રૂટિંગ શરત મૂકો:

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

સફળ કોલ્ડ ટ્રાન્સફરમાં `end_reason: "ai_transfer"` હોય છે; પૂર્ણ થયેલા વૉર્મ હેન્ડઓફમાં `end_reason: "ai_warm_transfer"` હોય છે. નિષ્ફળ વૉર્મ પ્રયાસ નિયંત્રણ એજન્ટને પરત આપે છે, તેથી કૉલનો પછીનો અંત તેનો એન્ડ રીઝન નક્કી કરે છે. નૉન-ફોન સેશન્સમાં, ટ્રાન્સફર વિનંતી તેના બદલે સેશન સમાપ્ત કરે છે.

ડેશબોર્ડ અને API સેટઅપ, રૂટિંગ, સ્ક્રીનિંગ, નિષ્ફળતા હેન્ડલિંગ, મર્યાદાઓ અને ટેસ્ટિંગ માટે [કૉલ ટ્રાન્સફર](/gu/guides/call-transfers) જુઓ.

## `send_keypad_input`

ફોન લાઇન પર DTMF (ફોન કીપેડ) અંકો `0`–`9`, `*`, અને `#` મોકલે છે. મોડલ તેનો ઉપયોગ IVR ને નેવિગેટ કરવા માટે કરે છે, જે ઑટોમેટેડ મેનૂ કૉલરને કી દબાવવા કહે છે. તે ડિફૉલ્ટ રૂપે ઉપલબ્ધ છે અને તેમાં કોઈ એજન્ટ સેટિંગ નથી.

મોડલને જણાવો કે તે કયા મેનૂ નેવિગેટ કરી શકે છે અને વિનંતી કરેલા મૂલ્યો ક્યાંથી આવે છે. તેને મેનૂ વિકલ્પોનો અંદાજ લગાવવા ન કહો:

```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.
```

પ્લેટફૉર્મ અસપોર્ટેડ અક્ષરો દૂર કરે છે અને માન્ય અંકો ક્રમમાં મોકલે છે. જો કોઈ માન્ય અંક બાકી ન રહે અથવા કૉલ કીપેડ ઇનપુટ મોકલી ન શકે, તો નિષ્ફળતા એજન્ટને પરત કરવામાં આવે છે જેથી તે પુનઃપ્રાપ્તિ કરી શકે.

## `no_response`

જ્યારે ઑટોમેટેડ સિસ્ટમ હજી બોલતી હોય અથવા એજન્ટને સાંભળતા રહેવા કહે ત્યારે એજન્ટને શાંત રાખે છે. તે જીવંત વ્યક્તિના અભિવાદન, પ્રશ્ન અથવા વાસ્તવિક હોલ્ડ ક્યૂ માટે નથી. તે ડિફૉલ્ટ રૂપે ઉપલબ્ધ છે અને તેમાં કોઈ એજન્ટ સેટિંગ નથી.

સામાન્ય રીતે બિલ્ટ-ઇન વર્ણન પૂરતું હોય છે. IVR-પ્રધાન કૉલ્સ માટે, promptમાં સીમાને વધુ સ્પષ્ટ કરો:

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

આ ક્રિયા કૉલ સમાપ્ત કરતી નથી.

## `wait_on_hold`

કોઈ વાસ્તવિક વ્યક્તિ પાછી આવે ત્યાં સુધી આઉટબાઉન્ડ એજન્ટને શાંત હોલ્ડ સ્થિતિમાં મૂકે છે.
મોડેલ તેનો ઉપયોગ ફક્ત ત્યારે કરે છે જ્યારે બીજી વ્યક્તિ સ્પષ્ટપણે કહે કે એજન્ટને
હોલ્ડ પર મૂકવામાં આવી રહ્યો છે. તે આઉટબાઉન્ડ કૉલ્સ પર આપમેળે ઉપલબ્ધ છે અને તેની
માટે કોઈ ડેશબોર્ડ સેટિંગ નથી.

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

IVRના "કૃપા કરીને રાહ જુઓ" સંદેશ માટે એજન્ટને તેનો ઉપયોગ કરવા prompt ન કરો. હોલ્ડ
મૂળભૂત રીતે 15 મિનિટ સુધી રહે છે. સામાન્ય આઉટબાઉન્ડ કૉલ્સ માટે, `POST /v1/call`
ધન પૂર્ણાંક `max_hold_seconds` સ્વીકારે છે; ઇનલાઇન Realtime `max_hold_seconds`ને
10–900 સેકન્ડ સુધી મર્યાદિત રાખે છે. જો વ્યક્તિ પાછી આવે, તો એજન્ટ કૉલના સમાપ્તિ
કારણમાં ફેરફાર કર્યા વિના ફરી શરૂ કરે છે. જો મર્યાદા સમાપ્ત થાય, તો પ્લેટફોર્મ
`end_reason: "ai_hangup"` સાથે કૉલ સમાપ્ત કરે છે.

## `search_knowledge_base`

એજન્ટ સાથે જોડાયેલા દસ્તાવેજોમાં શોધ કરે છે અને સંબંધિત અંશો પરત કરે છે. તેને
સક્રિય કરવા માટે જ્ઞાન આધાર અથવા વ્યક્તિગત જ્ઞાન દસ્તાવેજો જોડો, પછી મોડેલને
જણાવો કે કયા જવાબો આ સ્રોતોમાંથી આવવા જોઈએ:

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

જો શોધ નિષ્ફળ જાય, તો પરિણામ એજન્ટને પરત કરવામાં આવે છે. ડેશબોર્ડ અને API સેટઅપ
માટે [જ્ઞાન આધાર](/gu/guides/knowledge-base) જુઓ.

## `play_sound`

એ જ ટર્નમાં થયેલા કોઈપણ બોલ્યા પછી એજન્ટનો ગોઠવેલ સૂચના ધ્વનિ વગાડે છે.
ડેશબોર્ડમાં, **ઉન્નત → ટૂલ સાઉન્ડ**ને **ચાઇમ**, **ડિંગ**, અથવા **બીપ** પર સેટ કરો,
પછી એજન્ટ ડિપ્લોય કરો. **કોઈ નહીં** ટૂલને દૂર કરે છે.

[Agents API](/api-reference/agents) સાથે, `play_sound_asset`ને `"chime"`,
`"ding"`, અથવા `"beep"` તરીકે સ્ટેજ કરો, પછી ડિપ્લોય કરો. ટૂલને નિષ્ક્રિય કરવા
માટે તેને `""` પર સેટ કરો.

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

પ્લેબેક નિષ્ફળતા એજન્ટને પરત કરવામાં આવે છે અને કૉલ સમાપ્ત થતો નથી.

## `send_email`

એજન્ટના માલિક દ્વારા ગોઠવાયેલા એક પ્રાપ્તકર્તાને સાદા-ટેક્સ્ટ ઇમેઇલ મોકલે છે.
મોડેલ વિષય અને મુખ્ય ભાગ પૂરા પાડે છે. તેને પ્રાપ્તકર્તા પેરામીટર ક્યારેય દેખાતું
નથી અને તે સરનામું પસંદ કે બદલી શકતું નથી.

ડેશબોર્ડમાં, **ઉન્નત → ઇમેઇલ મોકલો** સક્રિય કરો, પ્રાપ્તકર્તાનું સરનામું સાચવો,
પછી એજન્ટ ડિપ્લોય કરો. [Agents API](/api-reference/agents) સાથે, `send_email_enabled: true`
અને ખાલી ન હોય તેવું `send_email_recipient` બંને સ્ટેજ કરો, પછી ડિપ્લોય કરો.
promptમાં ટ્રિગર અને જરૂરી સામગ્રી નિર્ધારિત કરો:

```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.
```

એક કૉલ વધુમાં વધુ ત્રણ ઇમેઇલનો પ્રયાસ કરી શકે છે. દરેક વિષય 300 અક્ષરો સુધી અને
દરેક મુખ્ય ભાગ 20,000 અક્ષરો સુધી મર્યાદિત છે. ખૂટતી ગોઠવણી, અમાન્ય સામગ્રી,
પ્રતિ-કૉલ મર્યાદા અને ડિલિવરી નિષ્ફળતાઓ એજન્ટને પરત કરવામાં આવે છે.
નિષ્ફળ ડિલિવરી પણ ત્રણ પ્રયાસોમાંથી એકનો ઉપયોગ કરે છે.

વ્યાપક રીતે ડિપ્લોય કરતા પહેલાં નિયંત્રિત પ્રાપ્તકર્તા સાથે પરીક્ષણ કરો. બ્રાઉઝર
Talk અને સિમ્યુલેશન્સ વાસ્તવિક ઇમેઇલ મોકલે છે; કોઈ ડ્રાય-રન મોડ નથી.

## સુસંગતતા નોંધ

**ઉન્નત → અટકાવી ન શકાય તેવા ખુલાસા** સેટિંગ અને લેગસી
`speak_uninterruptible_enabled` ફીલ્ડ સુસંગતતા માટે જાળવવામાં આવ્યા છે, પરંતુ
તેમને સક્રિય કરવાથી કોઈ અસર થતી નથી. સેટિંગ બંધ રાખો; કોઈ prompt આ ટૂલ સક્રિય
કરી શકતું નથી.

ફરજિયાત કૉલ-શરૂઆતના ખુલાસા માટે **સંમતિ જાહેરાત**નો ઉપયોગ કરો. તે સામાન્ય
વાતચીત પહેલાં શબ્દશઃ વગાડવામાં આવે છે અને તેને અટકાવી શકાતી નથી. [કૉલ રેકોર્ડિંગ
સંમતિ કાયદા](/gu/guides/recording-consent-laws) જુઓ.

## બિલ્ટ-ઇન ટૂલ્સનું પરીક્ષણ અને નિરીક્ષણ કરો

prompting, જ્ઞાન શોધ, ધ્વનિઓ અને ઇમેઇલ તપાસવા માટે બ્રાઉઝર Talk અથવા સિમ્યુલેશનનો
ઉપયોગ કરો. આ પર્યાવરણો ફોન-નેટવર્કનું વર્તન પુનઃસર્જિત કરી શકતા નથી. આઉટબાઉન્ડ
ફોન કૉલ પર કીપેડ નેવિગેશન અને હોલ્ડનું પરીક્ષણ કરો, અને પાત્ર આયાત કરેલા VoIP
નંબરનો ઉપયોગ કરીને વાસ્તવિક કૉલ પર સંપૂર્ણ વોર્મ હેન્ડઓફનું પરીક્ષણ કરો. ઉપરના
કોષ્ટકમાં દર્શાવ્યા મુજબ Realtime સપોર્ટ મર્યાદિત છે.

## કૉલ્સ, કિંમતનિર્ધારણ અને વેબહુક્સ

બિલ્ટ-ઇન ક્રિયાઓ માટે પ્રતિ-ઉપયોગ ટૂલ ફી નથી. સામાન્ય કૉલ અને પ્રદાતા શુલ્ક
હજુ પણ લાગુ પડે છે; [કિંમતનિર્ધારણ](/gu/guides/pricing) જુઓ. તેમના કૉલ્સ અને પરિણામો
પૂર્ણ થયેલા ટ્રાન્સક્રિપ્ટમાં દેખાઈ શકે છે, પરંતુ તેઓ `telephony.tool` અથવા `web.tool`
emit કરતા નથી. તે ઇવેન્ટ્સ [વપરાશકર્તા-નિર્ધારિત ફંક્શન્સ](/gu/tools/overview) માટે છે. માત્ર પૂર્ણ થયેલો
હેંગઅપ અથવા ટ્રાન્સફર કૉલનું `end_reason` બદલે છે; અન્ય નિષ્ફળતાઓ એજન્ટને પરત કરવામાં આવે છે.
કૉલ રેકોર્ડ માટે [પૂર્ણતા વેબહુક્સ](/gu/webhooks/call-complete) જુઓ.