# דוגמאות

> מתכונים מוכנים ל-CLI של Nodaro: הרצת תהליך כל לילה עם cron, שלבי CI שתלויים בהרצה, יצירת תמונות בסקריפט, כתוביות לסרטון ושיפור פרומפט.

Source: https://nodaro.ai/he/docs/developers/cli/examples

**הדוגמאות ל-CLI של Nodaro** הן מתכונים קצרים לעבודות נפוצות: הרצות מתוזמנות, שלבי CI שתלויים בהרצה, יצירה בסקריפט, כתוביות מתוך תמלול ושיפור פרומפטים. כל דוגמה מניחה ש[התקנתם את ה-CLI והתחברתם](https://nodaro.ai/docs/developers/cli), ורובן משתמשות ב-`jq` כדי לקרוא את פלט ה-JSON.

## הרצת תהליך כל לילה עם cron
רשומת ה-cron הזו מתחילה הרצה של תהליך כל לילה ב-03:00, ומוסיפה לסוף קובץ יומן את השדות `executionId` ו-`status` של ההרצה שהתחילה, בפורמט JSON:

```text
0 3 * * * /usr/local/bin/nodaro workflows run wf_abc123 --json >> /var/log/nodaro-nightly.log 2>&1
```

## המתנה להרצה לפני שממשיכים
עם `--watch`, הפקודה מחכה לסיום ההרצה ויוצאת עם `0` רק כשההרצה מצליחה, ולכן הפקודה הבאה רצה רק אם התהליך הצליח:

```bash
nodaro workflows run wf_abc --watch && \
echo "shipped" | mail -s "nodaro run done" me@example.com
```

שאר קודי היציאה מופיעים בדף [פלט וקודי יציאה](https://nodaro.ai/docs/developers/cli/output).

## יצירת תמונה בפקודה אחת
```bash
nodaro nodes run generate-image \
  --param prompt="a snow leopard on a mountain ridge, cinematic" \
  --param provider=flux \
  --param resolution=2K \
  --watch --json | jq -r '.output_data.imageUrl'
```

הפקודה מדפיסה רק את הכתובת של התמונה, וכך אפשר להעביר אותה ישירות לשלב הבא בסקריפט.

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

```bash
# 1. Word-level transcription (elevenlabs-stt always returns word timings)
nodaro audio transcribe --audio https://example.com/talk.mp3 \
  --provider elevenlabs-stt --watch

# 2. Save the words. They are in milliseconds; the top-level segments are in seconds.
nodaro jobs get <jobId> --json | jq '.output_data.words' > words.json

# 3. Burn them in. With captions supplied, add-captions runs no transcription of its own.
nodaro media add-captions https://example.com/talk.mp4 \
  --captions-file words.json \
  --style word-highlight --no-auto-transcribe --watch
```

- אפשר לתקן את השדה `text` של מילה ב-`words.json` בין שלב 2 לשלב 3, והסרטון יציג את המילה המתוקנת.
- לקריאה מהירה, שתי מילים בכל פעם, הוסיפו לשלב 3 את `--max-words-per-line 2`.
- שלב 1 דורש מנוע שמחזיר תזמון לכל מילה: המנוע `elevenlabs-stt`, או `incredibly-fast-whisper` עם `--word-timestamps`. המנוע `whisper` מחזיר ביטויים שלמים בלי מילים בודדות, ולכן לסגנון מונפש לא יהיה מה להציג.

כל הדגלים של הכתוביות מתוארים בדף [פקודות מדיה וקול](https://nodaro.ai/docs/developers/cli/media-commands#captions).

## עטיפת הפרומפט של אפליקציה בטקסט נסתר
הדגל `--override` מוסיף טקסט לפני הפרומפט של המשתמש ואחריו, להרצה אחת, בלי לשנות את האפליקציה:

```bash
nodaro apps run hair-styler-dd3erw --input prompt="curly red hair" \
  --override n1.promptPrefix="Studio portrait of" --override n1.promptSuffix=", 85mm, soft light"
```

הדף [טקסט לפני ואחרי הפרומפט](https://nodaro.ai/docs/concepts/prompt-pre-post-text) מסביר איך הטקסט מתחבר לפרומפט.

## הפיכת רעיון גולמי לפרומפט משופר
הפקודה `prompt enhance` כותבת פרומפט מחדש בשלב אחד. העבירו את התוצאה שלה ישירות להרצה של רכיב:

```bash
PROMPT=$(nodaro prompt enhance \
  --node-type generate-image \
  --prompt "snow leopard" \
  --json | jq -r '.prompt')

nodaro nodes run generate-image --param prompt="$PROMPT" --watch
```

כדי להשתמש בסקריפט בשאלות המנחות של האשף, עבדו בשני שלבים: הפקודה `nodaro prompt analyze --json` מחזירה את השאלות, והפקודה `nodaro prompt generate --selection category=value` בונה את הפרומפט הסופי מהתשובות שלכם. הפקודה האינטראקטיבית `nodaro prompt wizard` דורשת טרמינל.

## ייצוא השימוש של חודש
במופע עם ארגונים, כתבו לקובץ CSV דוח שימוש לפי חבר בארגון:

```bash
nodaro org usage org_abc --from 2026-09-01 --to 2026-09-30 --group-by member --csv > september.csv
```

ראו את הדף [סביבות עבודה וארגונים](https://nodaro.ai/docs/developers/cli/workspaces#usage-reports).

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

### איך מריצים תהליך של Nodaro לפי תזמון?

הוסיפו רשומת cron שמריצה את הפקודה nodaro workflows run עם מזהה התהליך ועם ‎--json ומוסיפה את הפלט לסוף קובץ יומן. הדוגמה הראשונה בדף הזה מריצה תהליך כל לילה ב-03:00.

### איך מקבלים בסקריפט shell את הכתובת של תמונה שנוצרה?

הריצו את הפקודה nodaro nodes run generate-image עם ‎--watch ועם ‎--json והעבירו את הפלט אל jq -r '.output_data.imageUrl'‎.

### איך מוסיפים לסרטון כתוביות מילה אחר מילה מה-CLI?

תמללו את האודיו במנוע שמחזיר תזמון לכל מילה, כמו elevenlabs-stt, שמרו בקובץ את output_data.words של המשימה והעבירו את הקובץ לפקודה nodaro media add-captions עם ‎--captions-file ועם ‎--no-auto-transcribe.

### האם אפשר לשפר פרומפט לפני שמריצים רכיב?

כן. הפקודה nodaro prompt enhance, עם ‎--node-type ועם ‎--prompt, מחזירה פרומפט משופר, ואפשר להעביר אותו ישירות לפקודה nodaro nodes run.