---
title: "כלים מובנים"
description: "הנחו סוכני ThunderPhone לסיים שיחות, להעביר מתקשרים, לנווט בלוחות מקשים, להמתין בהמתנה, לחפש בידע, להשמיע צלילים, לשלוח אימייל ולחשב סכומים כוללים."
---

כלים מובנים מאפשרים לסוכן לבצע פעולות שיחה נפוצות בלי לחבר API משלכם. רובם זמינים אוטומטית; אימייל, צלילים, המחשבון וחיפוש הידע מופיעים רק לאחר שתגדירו את ההגדרה או המקור הקשורים. הנחו את הסוכן מתי להשתמש בכל פעולה בהנחיה שלו.

| כלי | שימוש | כיצד להפעיל | שיחות נתמכות |
| --- | --- | --- | --- |
| `end_call` | סיום שיחה שהושלמה | זמין תמיד | טלפון, Talk בדפדפן, וידג'ט, סימולציה ו-Realtime |
| `transfer_call` | ניתוב מתקשר טלפוני | הגדירו את הניתוב בהנחיה | שיחות טלפון רגילות; Realtime מוטבע עם `call_events` יכול להשתמש בהעברה עיוורת. Realtime של סוכן שמור אינו כולל אותו. |
| `send_keypad_input` | לחיצה על מקשים בתפריט טלפוני | זמין תמיד בשיחות טלפון רגילות | שיחות טלפון; Realtime יוצא מוטבע עם `call_events`. Realtime של סוכן שמור אינו כולל אותו. |
| `no_response` | המשיכו להאזין בזמן שתפריט אוטומטי מדבר או שמתקשר חושב בקול; מתקשר שמבקש מהסוכן להמתין מקבל רק "בוודאי." | זמין תמיד | כל סוגי השיחות |
| `wait_on_hold` | המתנה בשקט עד שאדם יחזור | כלול בשיחות יוצאות | שיחות טלפון יוצאות והפעלות Realtime יוצאות מוטבעות |
| `search_knowledge_base` | מענה על סמך מקורות מצורפים | צרפו ידע לסוכן | שיחות של סוכן שמור עם ידע מצורף |
| `play_sound` | השמעת צליל התראה שהוגדר | **מתקדם → צליל כלי** | שיחות של סוכן שמור |
| `send_email` | שליחת אימייל לנמען קבוע אחד | **מתקדם → שליחת אימייל** | שיחות של סוכן שמור |
| `calculate` | חישוב מדויק של סכומים, עמלות ועודף | **מתקדם → מחשבון** | שיחות של סוכן שמור |

## `end_call`

מסיים את השיחה הנוכחית כאשר ההנחיה מורה למודל לעשות זאת. הוא זמין כברירת מחדל ואין לו הגדרת סוכן.

כתבו בהנחיה את התנאי ואת כל ברכת הפרידה הנדרשת:

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

לשיחה שהסתיימה על ידי המודל יש `end_reason: "ai_hangup"`, כולל שיחה שמסתיימת
לאחר אזהרת מגבלת זמן השיחה. השיחה מסתיימת עם `max_duration` רק אם
מגבלת הזמן מושגת קודם, ועם `balance_exhausted` כאשר היתרה מראש מתרוקנת.

## `transfer_call`

מעביר מתקשר טלפוני למספר קבוע שמספק המודל. העברה ללא תיווך מתבצעת מיידית. העברה חמה מסוננת מתקשרת באופן פרטי ליעד לפני חיבור הצדדים. העברה חמה דורשת מספר VoIP מיובא ומאומת שיכול לבצע שיחות יוצאות.

הציבו בהנחיה את מספר היעד ואת תנאי הניתוב המדויק:

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

בהעברה מוצלחת ללא תיווך הערך הוא `end_reason: "ai_transfer"`; בהעברה חמה שהושלמה הערך הוא `end_reason: "ai_warm_transfer"`. ניסיון העברה חמה שנכשל מחזיר את השליטה לסוכן, ולכן סיום השיחה בהמשך קובע את סיבת הסיום שלה. בהפעלות שאינן טלפוניות, בקשת העברה מסיימת את ההפעלה במקום זאת.

עיינו ב-[העברת שיחות](/he/guides/call-transfers) להגדרה בלוח הבקרה וב-API, ניתוב, סינון, טיפול בכשלים, מגבלות ובדיקות.

## `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, חזקו את הגבול בהנחיה:

```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. ההמתנה נמשכת
עד 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.
```

אם חיפוש נכשל, התוצאה מוחזרת לסוכן. עיינו ב[בסיס
הידע](/he/guides/knowledge-base) להגדרה בלוח הבקרה וב-API.

## `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` שאינו ריק, ולאחר מכן פרסמו.
הגדירו בהנחיה את התנאי להפעלה ואת התוכן הנדרש:

```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 בדפדפן
וסימולציות שולחים אימייל אמיתי; אין מצב הרצה יבשה.

## `calculate`

מעריך ביטוי חשבוני בדיוק ומחזיר את התוצאה, כך שהסוכן
לא מחשב מחירים בראשו. הוא מושבת כברירת מחדל. בלוח הבקרה,
הפעילו **מתקדם → מחשבון**, ואז פרסמו את הסוכן. באמצעות [Agents
API](/api-reference/agents), הגדירו `calculator_enabled: true`, ואז פרסמו.

המודל כותב את הביטוי, כגון `2*23.5 + 16.5 + 4`, ומקריא את
התוצאה בחזרה למתקשר. ביטויים יכולים להשתמש במספרים, `+`, `-`, `*`, `/` ו-
סוגריים. שיחה אחת יכולה לכלול עד 10 ביטויים המופרדים באמצעות `;`, כגון
סכום ביניים והסכום הכולל עם דמי משלוח, ועד 500 תווים בסך הכול.
התוצאות מעוגלות ל-10 ספרות אחרי הנקודה העשרונית. החישוב הוא חשבון עשרוני מדויק, לכן
`0.1 + 0.2` מחזיר `0.3`. חלוקה באפס וכל דבר אחר בביטוי
מוחזרים לסוכן כשגיאה לתיקון. הכלי פועל ב-ThunderPhone ומחזיר תשובה מיידית,
ללא משפט מילוי או צליל הקלדה.

הפעילו אותו עבור סוכנים שמוסרים סכומי הזמנה, עמלות או עודף. אין צורך
בשינוי ההנחיה.

## הערת תאימות

ההגדרה **מתקדם → גילויים שלא ניתנים להפרעה** והשדה הישן
`speak_uninterruptible_enabled` נשארים לצורכי תאימות, אך הפעלתם
אינה משפיעה. השאירו את ההגדרה כבויה; שום הנחיה אינה יכולה להפעיל כלי זה.

עבור הודעת גילוי נדרשת בפתיחת שיחה, השתמשו ב**הודעת הסכמה**. היא מושמעת
מילה במילה לפני שיחה רגילה ואי אפשר להפריע לה. עיינו ב[חוקי הסכמה להקלטת
שיחות](/he/guides/recording-consent-laws).

## בדיקה וניטור של כלים מובנים

השתמשו ב-Talk בדפדפן או בסימולציה כדי לבדוק הנחיות, חיפוש ידע, צלילים
ואימייל. סביבות אלה אינן יכולות לשחזר התנהגות של רשת טלפונית. בדקו
ניווט במקשי הטלפון והמתנה בשיחת טלפון יוצאת, ובדקו העברה חמה מלאה
בשיחה אמיתית באמצעות מספר VoIP מיובא שעומד בתנאים. התמיכה ב-Realtime
מוגבלת כפי שמוצג בטבלה לעיל.

## שיחות, תמחור ו-webhooks

לפעולות מובנות אין עמלת כלי לכל שימוש. חיובי שיחה וספק רגילים
עדיין חלים; ראו [תמחור](/he/guides/pricing). השיחות והתוצאות שלהן עשויות להופיע
בתמליל שהושלם, אך הן אינן מפיקות `telephony.tool` או `web.tool`.
אירועים אלה מיועדים ל[פונקציות המוגדרות על ידיכם](/he/tools/overview). רק ניתוק
או העברה שהושלמו משנים את `end_reason` של השיחה; כשלים אחרים מוחזרים לסוכן. ראו [webhooks להשלמה](/he/webhooks/call-complete) עבור רשומת השיחה.