# גלריה ונכסים

> עיינו בגלריה ובהעלאות שלכם ב-Nodaro, הציגו תוצאה בצ׳אט, קראו את פרטי המשימה, בדקו את מצב ההרצה של אפליקציה וסמנו מועדפים דרך עוזר AI.

Source: https://nodaro.ai/he/docs/mcp/tools/gallery-and-assets

**כלי הגלריה והנכסים** מאפשרים לעוזר AI למצוא, להציג ולהשתמש שוב במה שכבר יצרתם ב-Nodaro. הכלים `browse_gallery` ו-`browse_uploads` מציגים את התוצאות ואת ההעלאות שלכם ברשת, `get_asset` ו-`display_asset` שולפים או מציגים תוצאה אחת, `get_app_run` בודק את המצב של הרצת תהליך או אפליקציה, ו-`list_favorites` ו-`favorite_asset` מנהלים את המועדפים שלכם. אף אחד מהם לא עולה קרדיטים.

## `browse_gallery`
מציג את הגלריה שלכם כרשת אינטראקטיבית של תמונות ממוזערות. אפשר ללחוץ על אריח כדי לצפות בו, להעתיק אותו או להשתמש בו בעריכה הבאה. השתמשו בכלי כשרוצים לראות את מה שיצרתם, וב-[`list_jobs`](https://nodaro.ai/docs/mcp/tools/jobs#list_jobs) כשהעוזר צריך רק נתונים.

**הרשאה:** `assets:read`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `scope` | string | `mine` (ברירת המחדל) לספרייה שלכם, או `public` לתוצאות ציבוריות אחרונות של משתמשים אחרים. |
| `kinds` | array | סוגי המדיה שייכללו: כל שילוב של `image`, `video` ו-`audio`. ברירת המחדל: `["image", "video"]`. |
| `kind` | string | סוג מדיה אחד: `image`, `video` או `audio`. |
| `query` | string | מילים לחיפוש בפרומפטים, עד 200 תווים, למשל `rabbit` (ארנב). כל מילה חייבת להופיע בפרומפט, בלי הבדל בין אותיות גדולות לקטנות. |
| `limit` | integer | מ-1 עד 200. ברירת המחדל: `50`. |
| `cursor` | string | הערך `next_cursor` מהעמוד הקודם. |

**מה חוזר:** הרשת, בלקוחות שמציגים MCP Apps, והפריטים עם `next_cursor` כנתונים.

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

בגלריה שלכם מופיעים גם הרינדורים של רכיב [החלת רשימת עריכה](https://nodaro.ai/docs/nodes/video/apply-edl): רינדור וידאו תחת `video`, ורינדור אודיו תחת `audio`. רינדור שנוצר באיכות של תצוגה מקדימה כולל `preview: true`, ובשורת הטקסט שלו כתוב `(preview)`. ההיקף הציבורי אף פעם לא מחזיר רינדור של רכיב החלת רשימת עריכה.

## `browse_uploads`
מציג את הקבצים שהעליתם, בניגוד לתוצאות ש-Nodaro יצר. השתמשו בו כדי לבחור העלאה קודמת כקלט ליצירה חדשה. הכפתור **Use** (שימוש) ברשת מחזיר לצ׳אט את המזהה של הקובץ.

**הרשאה:** `assets:read`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `kind` | string | `image`, `video` או `audio`. השמיטו אותו כדי לקבל את כל ההעלאות. |
| `search` | string | מילים לחיפוש בשמות הקבצים, עד 200 תווים. כל מילה חייבת להופיע בשם הקובץ, בלי הבדל בין אותיות גדולות לקטנות. |
| `limit` | integer | מ-1 עד 100. ברירת המחדל: `40`. |
| `cursor` | string | הערך `nextCursor` מהעמוד הקודם. |

**מה חוזר:** ההעלאות עם הכתובות והמזהים שלהן, ו-`nextCursor`. רינדור של רכיב החלת רשימת עריכה שנוצר באיכות של תצוגה מקדימה כולל `preview: true`, ובשורת הטקסט שלו כתוב `(preview)`.

## `get_asset`
מחזיר את הפרטים של תוצאה אחת: כתובת הפלט, הפרומפט והמודל. הכלי מחזיר משימות שלכם בכל סטטוס, ומשימות ציבוריות שהושלמו של משתמשים אחרים. למשימה שנכשלה הוא מוסיף את `retryable` ואת `guidance`, ואם יש כזה, גם את `suggestedProvider`; הסעיף [כשמשימה נכשלת](https://nodaro.ai/docs/mcp/tools/jobs#when-a-job-fails) בדף משימות מסביר אותם.

**הרשאה:** `assets:read`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `job_id` | string | **נדרש.** מזהה המשימה של התוצאה. |

**מה חוזר:** [מעטפת המשימה](https://nodaro.ai/docs/mcp/tools/jobs#the-job-envelope), בלי `input`.

## `display_asset`
מציג תוצאה אחת בצ׳אט: במקום נתונים רואים את התמונה, הסרטון או האודיו. בתמונות מופיעים גם הכפתורים **Animate** (הנפשה), **Edit** (עריכה) ו-**Recreate** (יצירה מחדש), וגם תצוגת מסך מלא. כשהעוזר צריך רק את הפרטים, השתמשו ב-`get_asset`.

**הרשאה:** `assets:read`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `job_id` | string | **נדרש.** משימה שלכם בכל סטטוס, או משימה ציבורית שהושלמה של משתמש אחר. |

**מה חוזר:** כרטיס המדיה, עם פרטי התוצאה כנתונים.

## `get_app_run`
מחזיר את ההתקדמות של הרצת תהליך או של הרצת אפליקציה שפורסמה: הסטטוס שלה, המצב של כל רכיב וכל כתובת פלט שנוצרה עד עכשיו, עם הפרומפט, המודל ומזהה המשימה שלה. השתמשו בו אחרי [`run_workflow`](https://nodaro.ai/docs/mcp/tools/projects-and-workflows#run_workflow), [`render_final`](https://nodaro.ai/docs/mcp/tools/projects-and-workflows#render_final) ו-[`run_app`](https://nodaro.ai/docs/mcp/tools/apps-and-components#run_app), שמחזירים מזהה הרצה (`execution_id`) במקום מזהה משימה. הכלי `get_job` לא מוצא מזהה הרצה. קראו לכלי כל 5–10 שניות, כל עוד ההרצה במצב `pending` או `running`.

**הרשאה:** `assets:read`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `execution_id` | string | **נדרש.** מזהה ההרצה. |

**מה חוזר:** הסטטוס של ההרצה, מצבי הרכיבים והפלטים עד עכשיו:

- השדות `executionId`, `status`, `errorMessage` ו-`summary`, עם הספירות `total`, `completed`, `failed`, `skipped` ו-`skippedForEmptyInput`.
- השדה `nodeStates`, רשומה אחת לכל רכיב, לפי הסדר בתהליך: `id`, `label`, `nodeType`, `status`, `error`, `jobId`, `text` ו-`media`. השדה `text` הוא פלט הטקסט של הרכיב, חתוך אחרי 1,500 תווים, עם `textTruncated: true` כשהוא נחתך. השדה `media` מפרט כל כתובת של תמונה, סרטון ואודיו שהרכיב הפיק, כל אחת בצורה `{ kind, url }`. הערך `skipReason: "empty_input"` פירושו ששום דבר לא הגיע לקלט של הרכיב בהרצה הזאת.
- השדה `outputs`, כל כתובות המדיה של ההרצה, עם ה-`prompt`, ה-`model` וה-`createdAt` של המשימה שיצרה כל אחת מהן.
- השדה `resumeHint`, בהרצה שנכשלה ש-`run_workflow` יכול להמשיך (תהליך שמור בפרויקט mcp, לא הרצת אפליקציה): הקריאה ל-`run_workflow` שממשיכה את ההרצה מהמקום שבו היא נעצרה. ראו את הסעיף [המשך הרצה שנכשלה](https://nodaro.ai/docs/mcp/tools/projects-and-workflows#continue-a-failed-run) בדף פרויקטים ותהליכים. בהרצת אפליקציה שנכשלה מופיע במקום זאת הניסיון החוזר של האפליקציה: הקריאה ל-[`retry_app_run`](https://nodaro.ai/docs/mcp/tools/apps-and-components#retry_app_run) שנותנת עליו אומדן מחיר. רק הניסיון הנוכחי של ההרצה כולל את השדה הזה, ולכן אחרי ניסיון חוזר או התחלה מחדש, הניסיון הקודם כבר לא כולל אותו. כשהאפליקציה השתנתה מאז ההרצה, הקריאה מציינת את ה-`version` של ההרצה עצמה.

כשההרצה מסתיימת, היא כוללת גם את `outcome`. הערך הוא `"nothing_new"` כשההרצה דילגה על רכיב אחד לפחות כי שום דבר לא הגיע לקלט שלו, ושום רכיב לא נכשל, למשל פיד שלא מצא פוסטים חדשים. אחרת הערך הוא `"succeeded"`. להרצה שנכשלה או בוטלה יש `status`, בלי `outcome`.

## `list_favorites`
מחזיר את מזהי המשימות של התוצאות המועדפות שלכם, מהחדש לישן.

**הרשאה:** `assets:read`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `limit` | integer | מ-1 עד 100. |
| `cursor` | string | ה-cursor מהעמוד הקודם. |

**מה חוזר:** מזהי המשימות של המועדפים שלכם. רינדור מועדף שלכם של רכיב החלת רשימת עריכה מופיע גם הוא, עם `preview: true` כשמדובר בתצוגה מקדימה. רינדור של אדם אחר לא מופיע.

## `favorite_asset`
מוסיף תוצאה למועדפים שלכם או מסיר אותה מהם. התוצאה יכולה להיות משימה שלכם או משימה ציבורית של משתמש אחר. [`list_jobs`](https://nodaro.ai/docs/mcp/tools/jobs#list_jobs) עם `favorited: true` מחזיר את המשימות שסימנתם כמועדפות.

**הרשאה:** `assets:write`. **קרדיטים:** חינם.

| פרמטר | סוג | הערות |
| --- | --- | --- |
| `job_id` | string | **נדרש.** התוצאה לסימון. |
| `favorited` | boolean | **נדרש.** הערך `true` מוסיף למועדפים, והערך `false` מסיר. |

**מה חוזר:** אישור.

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

### איך רואים את הגלריה של Nodaro בתוך Claude?

בקשו לראות את הגלריה שלכם. הכלי browse_gallery מציג את התמונות והסרטונים האחרונים שלכם ברשת שאפשר ללחוץ עליה, והוא יכול גם לחפש בפרומפטים שלכם, למשל את כל התמונות עם ארנב.

### מה ההבדל בין browse_gallery לבין browse_uploads?

הכלי browse_gallery מציג את התוצאות ש-Nodaro יצר בשבילכם. הכלי browse_uploads מציג את הקבצים שהעליתם בעצמכם, כדי שתוכלו לבחור אחד מהם כקלט ליצירה חדשה.

### האם העוזר יכול להשתמש בתוצאה מהגלריה הציבורית?

כן. הכלים get_asset ו-display_asset מחזירים את המשימות שלכם, וגם משימות ציבוריות שהושלמו של כל משתמש אחר, כך שהעוזר יכול להעביר את הכתובת של תוצאה ציבורית לכלי אחר.

### איך בודקים את המצב של הרצת תהליך שעוזר AI התחיל?

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