# כלי עזר, מתכונים וסקילים

> בדקו את החיבור עם ping, טענו מתכונים בדוקים עם get_recipe, התחילו לעבוד עם הסקיל של במאי הקולנוע והכינו סרטוני UGC לאתרים עם כלי הבנייה.

Source: https://nodaro.ai/he/docs/mcp/tools/utility

**כלי העזר, המתכונים והסקילים** נותנים לעוזר AI התחלה טובה. הכלי `ping` בודק את החיבור, `get_recipe` טוען מתכונים בדוקים של כמה שלבים, `start_film_director` טוען את הסקיל של במאי הקולנוע ושלושת כלי הבנייה של UGC מכינים סרטון שבו יוצר/ת מדבר על אתר אינטרנט. אף אחד מהם לא יוצר מדיה ולא מוציא קרדיטים. שלושה כלים נוספים בדף הזה כן מוציאים קרדיטים: הכלי `capture_site` מצלם עמוד אינטרנט כצילומי מסך, ו-`ugc_split_speech` ו-`ugc_finish_clips` חותכים את הדיבור ומבצעים את הגימור של הקליפים בסרטון UGC.

כלים אחרים שמחזירים הוראות מתוארים יחד עם המשפחה שלהם: [`start_workflow_editor` ו-`get_node_skill`](https://nodaro.ai/docs/mcp/tools/projects-and-workflows#start_workflow_editor), [`start_video_director`](https://nodaro.ai/docs/mcp/tools/shot-sequence-and-video-director#start_video_director), [`get_studio_production_skill`](https://nodaro.ai/docs/mcp/tools/studio-productions#get_studio_production_skill) ו-[`get_recast_authoring_skill`](https://nodaro.ai/docs/mcp/tools/recast#get_recast_authoring_skill).

## `ping`
מחזיר `pong`, את מזהה המשתמש שלכם ב-Nodaro ואת השם של הלקוח שקרא לכלי. השתמשו בו כדי לבדוק שהמחבר עובד.

**הרשאה:** אין, הכלי תמיד גלוי. **קרדיטים:** חינם.

לכלי הזה אין פרמטרים.

## `get_recipe`
מציג וטוען מתכוני תוכן: תוכניות עבודה בדוקות שמובילות עוזר AI לאורך רצף עבודה מלא עם כמה כלים, כגון סרטון הסבר מונפש עם קריינות. הכלי מחזיר טקסט בלבד. את הפעולות שמתכון מבקש מבצעים בעזרת הכלים האחרים, ולכל אחד מהם הרשאה ומחיר משלו. הקטלוג נמצא בדף [מתכוני תוכן](https://nodaro.ai/docs/mcp/recipes).

**הרשאה:** אין, הכלי תמיד גלוי. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `recipe` | string | שם של מתכון, כגון `video-explainer`. השמיטו אותו כדי לקבל את כל המתכונים ברשימה. |
| `file` | string | קובץ עזר בתוך המתכון, כגון `references/prompts.md`. דורש את `recipe`. |

**מה חוזר:** בלי ארגומנטים, השם, התיאור וביטויי ההפעלה של כל מתכון. עם `recipe`, ההוראות המלאות של המתכון. עם `file`, הקובץ הזה. שם לא מוכר מחזיר שגיאה עם השמות התקפים.

ב-Nodaro Cloud, הרשימה כוללת גם סרטון UGC לאתר: יוצר/ת שמדבר למצלמה על אתר, וצילומי המסך של האתר מוצגים ככרטיסים.

## `start_film_director`
מחזיר את הסקיל של במאי הקולנוע: ההוראות שגורמות לעוזר לביים סרט ב-10 שלבים, מהתסריט ועד העריכה הסופית, ותוך כדי כך לבנות על הקנבס שלכם תהליך שאפשר לערוך. עוזרים קוראים לכלי הזה ראשון בכל בקשה לסרטון עם כמה שוטים, כגון טריילר, סרט קצר, קליפ מוזיקלי, רילס או פרסומת. ראו את הדף [במאי קולנוע](https://nodaro.ai/docs/mcp/film-director).

**הרשאה:** אין, הכלי תמיד גלוי. **קרדיטים:** חינם. **ב-Nodaro Cloud בלבד.**

לכלי הזה אין פרמטרים. הוא לא משנה כלום.

## `capture_site`
מצלם עמוד אינטרנט כצילומי מסך אמיתיים ברוחב של טלפון: תמונה אחת של העמוד כולו, ועד 8 תמונות סטילס של אזורים בעמוד, חתוכות בצורה של כרטיס טלפון. הכלי מחזיר גם מפה של האזורים בעמוד, עם הכותרת, המיקום וטקסט קצר של כל אזור, ואת המספרים המדויקים מהטקסט של העמוד. חלונות הסכמה קופצים מוסתרים, ואף פעם לא מאושרים.

**הרשאה:** `workflows:execute`. **קרדיטים:** מחיר קבוע לכל צילום. הכלי מופיע ברשימת הכלים רק בהתקנות שבהן צילום עמודים מופעל.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `url` | string | **נדרש.** העמוד לצילום. אפשר להשמיט את `https://`. עד 2,048 תווים. |
| `max_stills` | integer | המספר המרבי של תמונות סטילס של אזורים שיוחזרו, מ-3 עד 8. ברירת המחדל: `8`. |
| `client_request_id` | string | אסימון ניסיון חוזר: בין 8 ל-128 תווים של אותיות, ספרות ו-`_ - . :`. אם אתם מנסים שוב אחרי פסק זמן, שלחו את אותו ערך, כדי ש-Nodaro לא יתחיל את הצילום ולא יחייב אותו פעמיים. |

**מה חוזר:** מזהה משימה. קבלו את תמונות הסטילס מ-`outputData.stills` בתשובה של [`wait_for_job`](https://nodaro.ai/docs/mcp/tools/jobs#wait_for_job), כל אחת עם `assetId` ועם `url`. תמונות הסטילס נשמרות במדיה שלכם, מוסתרות מחלון בחירת המדיה עד שתשמרו אותן, ונספרות במכסת האחסון שלכם.

צילום של עמוד שחוסם מבקרים אוטומטיים או שחוזר ריק נכשל, והקרדיטים מוחזרים. עמוד שה-`robots.txt` שלו לא מתיר את הצילום נדחה לפני שמשהו רץ.

## כלי הבנייה של סרטוני UGC
שלושה כלי עזר חינמיים שהמתכון לסרטון UGC לאתר משתמש בהם. הם לא יוצרים כלום: כל אחד מהם בודק או מכין את החלק שלו, ומחזיר את הארגומנטים המדויקים של קריאות היצירה הבאות. שני כלים נוספים, `ugc_split_speech` ו-`ugc_finish_clips`, עושים את עבודת האודיו והווידאו של אותו מתכון, במחיר קבוע לכל קריאה. כל חמשת הכלים זמינים ב-Nodaro Cloud בלבד ולא צריכים הרשאה, חוץ מ-`build_ugc_creator` עם דמות שמורה, שצריך את `assets:read`.

### `build_ugc_creator`
מכין את היוצר/ת שמדבר למצלמה: אדם חדש שנדגם באקראי, אחת מהדמויות השמורות שלכם או תמונה שלכם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `source` | string | **נדרש.** `sampled`, `character` או `photo`. |
| `character_id` | string | עם `character`: הדמות השמורה. |
| `photo_url` | string | עם `photo`: התמונה שלכם. |
| `gender` | string | `woman` או `man`. |
| `product_category`, `overrides`, `previous`, `seed` | | פרטים אופציונליים, כדי לכוון את היוצר/ת שנדגם או ליצור אותו שוב. |

**מה חוזר:** תמונות הזהות של היוצר/ת, או הארגומנטים המדויקים של יצירות התמונה שצריך להריץ אחר כך. ליוצר/ת שנדגם באקראי, מדובר בתמונה אחת לכל מועמד, כדי שתוכלו לבחור אחד מהם.

### `build_ugc_clips`
(ב-Nodaro Cloud בלבד) בודק תסריט של סרטון UGC — את כל הבעיות בבת אחת, כל אחת עם תיקון — ומחזיר קריאה אחת ל-`generate_video` לכל קליפ, את הקריאה שמאחדת את הקליפים ואומדן קרדיטים לשאר הסרטון. אפשר לכתוב תסריטים באנגלית או בעברית. על תסריט בעברית הכלי עונה בשני שלבים: הקריאה הראשונה מחזירה את הדיבור שצריך להקליט ואיך לפצל אותו, עם האומדן; קראו לכלי שוב עם `segments` מ-`ugc_split_speech` כדי לקבל קריאה אחת ל-`generate_video` לכל מקטע. הכלי לא דורש הרשאה ולא עולה קרדיטים. המתכון `ugc-website`, שנטען עם `get_recipe`, משתמש בו.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `plan` | object | **נדרש.** התסריט. |
| `gender` | string | **נדרש.** `woman` או `man`. |
| `identity_images` | array | **נדרש.** תמונה אחת או שתיים של היוצר/ת. |
| `traits`, `seed` | | אופציונליים. |
| `spent_job_ids` | array | המשימות שכבר רצו בשביל הסרטון הזה, שהאומדן מציג ככאלה שכבר שולמו. עד 64. |
| `segments` | array | המקטעים מהפלט של `ugc_split_speech`, כשהתשובה לקריאה הראשונה ביקשה אותם. השמיטו את הפרמטר בקריאה הראשונה. עד 8. |
| `speech_lane` | string | רק לתסריט באנגלית. `reference-audio` (ברירת המחדל): קול מקריא את התסריט, ומודל הווידאו מגלם אותו. `prompt-quoted`: מודל הווידאו אומר את השורה בקול שלו. |
| `voice_id` | string | רק לתסריט באנגלית. הקול בשיטה `reference-audio`, שם של קול מוכן מראש או מזהה מ-`list_voices`, במקום הקול שהכלי בוחר ליוצר/ת. |

**מה חוזר:** קריאה אחת ל-`generate_video` לכל קליפ, מוכנה להרצה, הקריאה שמאחדת את הקליפים ואומדן קרדיטים לשאר הסרטון. שורת אומדן עם `estimate: true` היא אומדן של קריאת LLM שמחויבת לפי השימוש: קריאה מסוג תמונה לטקסט, שמפענחת את צילומי המסך. הקריאה הזו מחויבת לפי הטוקנים שהיא השתמשה בהם בפועל. האומדן כולל אז `totalIsEstimate: true`, ולכן הציגו את הסכום כ-`≈N`. מודל בלי מחיר נדחה עם `llm_model_unpriced`.

### `build_ugc_cards`
מתזמן את כרטיסי צילומי המסך ואת הכתוביות של סרטון UGC לפי התזמון של המילים בו.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `plan` | object | **נדרש.** התסריט. |
| `alignment` או `words` | array | תזמוני המילים, מ-[`forced_alignment`](https://nodaro.ai/docs/mcp/tools/shot-sequence-and-video-director#forced_alignment) או מ-[`transcribe`](https://nodaro.ai/docs/mcp/tools/audio#transcribe). |
| `video_duration_ms` | number | אורך הסרטון. |
| `caption_style` | string | איך נראות הכתוביות אחרי שורת הפתיחה: `body-captions` (מילה אחר מילה, ברירת המחדל), `karaoke`, `clean-subtitles` או `none`. שורת הפתיחה תמיד שומרת על הלוחית שלה. |

**מה חוזר:** השכבות ל-[`overlay_images`](https://nodaro.ai/docs/mcp/tools/video-editing#overlay_images) ומקטעי הכתוביות ל-[`add_captions`](https://nodaro.ai/docs/mcp/tools/video-editing#add_captions).

### `ugc_split_speech`
חותך את הדיבור המוקלט של סרטון UGC למקטעים, בהפסקות של הדיבור עצמו. כל מקטע נשמר כקובץ אודיו, עם שקט קצר בכל צד.

**קרדיטים:** מחיר קבוע לכל קריאה.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `plan` | object | **נדרש.** התסריט. |
| `audio_url` או `audio_asset_id` | string | הדיבור, ככתובת URL או כמזהה של משימה או של העלאה ב-Nodaro. |
| `alignment` | array | **נדרש.** תזמוני המילים של הדיבור, 1–2,000 פריטים מהצורה `{ word, start, end }`. |

**מה חוזר:** משימה שהפלט שלה מפרט את המקטעים, בשביל הפרמטר `segments` של `build_ugc_clips`.

### `ugc_finish_clips`
בודק כל קליפ מרונדר מול האודיו שהוא קיבל, מצמיד לקליפ את האודיו המקורי הזה, מקצץ את השתיקות המיותרות שבין המילים ומחזיר את הקליפים המוגמרים לפי הסדר. אם קליפ לא תואם לאודיו שלו, הכלי מציין את הקליפים שצריך לרנדר מחדש ולא משנה כלום.

**קרדיטים:** מחיר קבוע לכל קריאה.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `segments` | array | **נדרש.** המקטעים מ-`ugc_split_speech`, 1–8. |
| `clips` | array | **נדרש.** 1–8 פריטים. לכל פריט יש `clip` (המספר שלו, מ-1 עד 8) והסרטון המרונדר, כ-`video_url` או כ-`video_asset_id`. השדה `reroll_video_url` או `reroll_video_asset_id` הוא קליפ שרונדר מחדש. |

בסרטון בעברית, שבנוי ממקטעים, הכלי גם נותן לכל קליפ את הסאונד של הסביבה שלו: ריוורב שמותאם לסביבה, עוצמה של `-16 LUFS` וצליל רקע של חדר מתחת לדיבור. סביבות בחוץ, ברכב ובאולם מקבלות את הריוורב ואת העוצמה, אבל בלי צליל רקע של חדר. אם השלב הזה נכשל, הקליפים חוזרים בלעדיו, עם אזהרה.

**מה חוזר:** משימה שהפלט שלה מפרט את הקליפים המוגמרים לפי הסדר.

## שאלות נפוצות

### איך בודקים שהעוזר שלי מחובר ל-Nodaro?

בקשו מהעוזר לקרוא לכלי ping. הכלי מחזיר pong, את מזהה המשתמש שלכם ב-Nodaro ואת שם הלקוח שלכם, והוא לא צריך הרשאה.

### מה הכלי get_recipe מחזיר?

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

### האם כלי הבנייה של UGC יוצרים את הסרטון?

לא. שלושת כלי הבנייה של UGC הם כלי עזר חינמיים של המתכון לסרטון UGC לאתר. הם מכינים את היוצר/ת, בודקים את התסריט ומתזמנים את הכרטיסים ואת הכתוביות, ומחזירים את הקריאות המדויקות שצריך לבצע אחר כך, עם אומדן קרדיטים. שני כלים אחרים, ugc_split_speech ו-ugc_finish_clips, חותכים את הדיבור ומבצעים את הגימור של הקליפים, במחיר קבוע לכל קריאה.