---
title: "உள்ளமைக்கப்பட்ட கருவிகள்"
description: "அழைப்புகளை முடிக்க, அழைப்பாளர்களை மாற்ற, கீபேட்களில் வழிசெலுத்த, ஹோல்டில் காத்திருக்க, அறிவுத் தளத்தில் தேட, ஒலிகளை இயக்க மற்றும் மின்னஞ்சல் அனுப்ப ThunderPhone ஏஜென்ட்களுக்கு prompt வழங்குங்கள்."
---

உள்ளமைக்கப்பட்ட கருவிகள், உங்கள் சொந்த API-யை இணைக்காமல் பொதுவான அழைப்பு நடவடிக்கைகளைச் செய்ய ஏஜென்ட்டை அனுமதிக்கின்றன. பெரும்பாலானவை தானாகக் கிடைக்கும்; மின்னஞ்சல், ஒலிகள் மற்றும் அறிவுத் தேடல் ஆகியவை தொடர்புடைய அமைப்பு அல்லது மூலத்தை நீங்கள் கட்டமைத்த பிறகே தோன்றும். ஒவ்வொரு நடவடிக்கையையும் எப்போது பயன்படுத்த வேண்டும் என்பதை ஏஜென்ட்டிடம் அதன் prompt-இல் கூறுங்கள்.

| கருவி | இதற்குப் பயன்படுத்தவும் | இதை இயக்குவது எப்படி | ஆதரிக்கப்படும் அழைப்புகள் |
| --- | --- | --- | --- |
| `end_call` | முடிவடைந்த உரையாடலை நிறைவு செய்ய | எப்போதும் கிடைக்கும் | தொலைபேசி, உலாவி பேசு, விட்ஜெட், சிமுலேஷன் மற்றும் 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 அமைப்பு, வழிமாற்றம், திரையிடல், தோல்வி கையாளுதல், வரம்புகள் மற்றும் சோதனைக்கு [அழைப்புகளைப் பரிமாற்றுதல்](/ta/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-இன் "please wait" செய்திக்காக இதைப் பயன்படுத்த ஏஜென்டிடம் கூறாதீர்கள். இயல்பாகக் காத்திருப்பு
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
அமைப்பிற்கு [அறிவுத் தளம்](/ta/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 எழுத்துகளுக்கும் வரையறுக்கப்பட்டுள்ளது. காணாமல் போன அமைப்பு, தவறான
உள்ளடக்கம், அழைப்புக்கான வரம்பு மற்றும் அனுப்பல் தோல்விகள் ஏஜென்டுக்குத் திருப்பி அனுப்பப்படும்.
அனுப்பல் தோல்வியடைந்தாலும் அது மூன்று முயற்சிகளில் ஒன்றைப் பயன்படுத்தும்.

பரவலாக வெளியிடுவதற்கு முன் கட்டுப்படுத்தப்பட்ட பெறுநருடன் சோதிக்கவும். உலாவி பேசு மற்றும்
சிமுலேஷன்கள் உண்மையான மின்னஞ்சலை அனுப்பும்; சோதனை-மட்டும் பயன்முறை இல்லை.

## இணக்கத்தன்மை குறிப்பு

**மேம்பட்டது → இடைமறிக்க முடியாத அறிவிப்புகள்** அமைப்பும் பழைய
`speak_uninterruptible_enabled` புலமும் இணக்கத்தன்மைக்காகத் தொடர்கின்றன; ஆனால் அவற்றை இயக்குவது
எந்த விளைவையும் ஏற்படுத்தாது. அமைப்பை முடக்கியே வையுங்கள்; எந்த prompt-உம் இந்தக் கருவியை இயக்க முடியாது.

அழைப்பு தொடக்கத்தில் கட்டாயமான அறிவிப்புக்கு, **ஒப்புதல் அறிவிப்பு** என்பதைப் பயன்படுத்தவும். அது
சாதாரண உரையாடலுக்கு முன் சொற்சொறாக இயக்கப்படும்; இடைமறிக்க முடியாது. [அழைப்பு
பதிவு ஒப்புதல் சட்டங்கள்](/ta/guides/recording-consent-laws) என்பதைப் பார்க்கவும்.

## உள்ளமைந்த கருவிகளைச் சோதித்து கண்காணிக்கவும்

prompt-கள், அறிவுத் தேடல், ஒலிகள் மற்றும் மின்னஞ்சலைச் சரிபார்க்க உலாவி பேசு அல்லது
சிமுலேஷனைப் பயன்படுத்தவும். அந்தச் சூழல்களால் தொலைபேசி வலைப்பின்னல் செயல்பாட்டை மீளுருவாக்க முடியாது.
விசைப்பலகை வழிசெலுத்தலையும் காத்திருப்பையும் வெளிச்செல்லும் தொலைபேசி அழைப்பில் சோதித்து, தகுதியான
இறக்குமதி செய்யப்பட்ட VoIP எண்ணைப் பயன்படுத்தி உண்மையான அழைப்பில் முழுமையான அன்பான ஒப்படைப்பைச் சோதிக்கவும்.
மேலுள்ள அட்டவணையில் காட்டப்பட்டுள்ளபடி Realtime ஆதரவு வரையறுக்கப்பட்டுள்ளது.

## அழைப்புகள், விலையிடல் மற்றும் வெப்ஹுக்குகள்

உள்ளமைக்கப்பட்ட செயல்களுக்கு ஒவ்வொரு பயன்பாட்டிற்குமான கருவிக் கட்டணம் இல்லை. வழக்கமான அழைப்பு மற்றும் வழங்குநர் கட்டணங்கள்
தொடர்ந்தும் பொருந்தும்; [விலையிடல்](/ta/guides/pricing) பக்கத்தைப் பார்க்கவும். அவற்றின் அழைப்புகளும் முடிவுகளும்
நிறைவடைந்த உரையாடல் பதிவில் தோன்றலாம், ஆனால் அவை `telephony.tool` அல்லது `web.tool` நிகழ்வுகளை வெளியிடாது.
அந்த நிகழ்வுகள் [பயனர் வரையறுத்த செயல்பாடுகளுக்கானவை](/ta/tools/overview). நிறைவடைந்த
அழைப்பு முடித்தல் அல்லது மாற்றுதல் மட்டுமே அழைப்பின் `end_reason` ஐ மாற்றும்; பிற தோல்விகள் ஏஜென்ட்டுக்குத் திருப்பி அனுப்பப்படும்.
அழைப்பு பதிவுக்கு [நிறைவு வெப்ஹுக்குகள்](/ta/webhooks/call-complete) பக்கத்தைப் பார்க்கவும்.