# סקילים לסוכנים

> קובצי הוראות מוכנים שמלמדים סוכני קוד לבנות על Nodaro עם ה-SDK ו-OAuth, ולצידם התוסף ל-Claude Code, תדריך ה-SDK ותיעוד בפורמט Markdown.

Source: https://nodaro.ai/he/docs/developers/agent-skills

**סקילים לסוכנים** הם קובצי הוראות מוכנים שמלמדים סוכני קוד, כמו Claude Code ו-Cursor, לבנות על Nodaro. כל סקיל מיועד למשימה אחת, שילוב ה-SDK או בניית אפליקציית OAuth, ומסביר לסוכן איך להתקין את ה-SDK ולהגדיר את האימות שלו, באילו דפוסים להשתמש ומאילו טעויות להימנע. טענו סקיל פעם אחת, ואז בקשו מהסוכן לבנות את מה שאתם צריכים.

## מה זמין
| משאב | מה הוא נותן לסוכן | מתאים במיוחד |
| --- | --- | --- |
| התוסף `nodaro` ל-Claude Code | סקיל ה-SDK של Nodaro, והחיבור לשרת ה-MCP ש-Nodaro מארח | משתמשי Claude Code |
| הסקיל `using-nodaro-sdk` | איך לשלב את ה-SDK ל-TypeScript, `@nodaro/sdk` | כל סוכן שקורא קובצי סקילים או קובצי הוראות |
| הסקיל `building-nodaro-oauth-app` | איך לממש OAuth 2.0 מול מופע של Nodaro | מוצרים שפועלים בשם משתמשי Nodaro אחרים |
| תדריך ה-SDK לסוכנים | סיכום של עמוד אחד על ה-SDK, להדבקה בשיחה | התחלה מהירה בכל סוכן |
| התיעוד בפורמט Markdown | כל דף בתיעוד, בפורמט שסוכנים קוראים בקלות | סוכנים שיכולים לטעון דפי אינטרנט |

## התקנת התוסף ל-Claude Code
ב-Claude Code, הריצו:

```text
/plugin marketplace add nodaroai/app.nodaro.ai
/plugin install nodaro
```

התקנה אחת מוסיפה שני דברים:

- **סקיל ה-SDK של Nodaro:** הגדרת הלקוח, יצירה אסינכרונית, גילוי של מודלים ושל מחירים בקרדיטים, הצגת התקדמות, טיפול בשגיאות ו-OAuth. Claude טוען אותו כשמזכירים את Nodaro, את `@nodaro/sdk`, את `@nodaro/cli` או אינטגרציה עם app.nodaro.ai.
- **החיבור לשרת ה-MCP ש-Nodaro מארח**, בכתובת `https://mcp.nodaro.ai/mcp`, כדי ש-Claude יוכל גם להשתמש ב-Nodaro ישירות. ראו את הדף [סוכני AI (MCP)](https://nodaro.ai/docs/mcp).

## הוספת קובץ סקיל לפרויקט שלכם
שני קובצי הסקילים נמצאים ב[תיקייה docs/skills](https://github.com/nodaroai/app.nodaro.ai/tree/main/docs/skills) במאגר הקוד הציבורי. כל קובץ מתחיל ב-frontmatter של YAML: השדה `name` והשדה `description`, שאומר לסוכן מתי לטעון את הסקיל. אחרי ה-frontmatter באות ההוראות, ב-Markdown.

### הורדת הסקיל
הורידו את `using-nodaro-sdk.md`, את `building-nodaro-oauth-app.md` או את שניהם.

### שמירת הסקיל במקום שבו הסוכן קורא סקילים
ב-Claude Code, שמרו כל קובץ בשם `SKILL.md` בתיקייה שנקראת על שם הסקיל: בנתיב `.claude/skills/using-nodaro-sdk/SKILL.md` בפרויקט שלכם, או תחת `~/.claude/skills/` לכל הפרויקטים. עשו commit לתיקייה שבפרויקט, כדי שכל הצוות שלכם יקבל את הסקיל. בסוכן קוד אחר, הוסיפו את תוכן הקובץ להוראות של הסוכן לפרויקט.

### בקשה מהסוכן
למשל: ״הוסף לאפליקציית ה-Next.js הזאת דף שיוצר תמונת מוצר עם Nodaro ומציג סרגל התקדמות״. הסוכן טוען את הסקיל המתאים ופועל לפיו.

### מה סקיל ה-SDK מכסה
הסקיל `using-nodaro-sdk` נטען כשסוכן משלב את `@nodaro/sdk` באפליקציה: אוטומציה בצד השרת, אפליקציית דפדפן על מופע של Nodaro או אפליקציית OAuth של צד שלישי. הוא מכסה:

- **הגדרה ושלושת מצבי האימות:** המצב `StaticTokenAuth` בשרת, עם אסימון API אישי או אסימון גישה של OAuth; המצב `supabaseAuth` באפליקציית דפדפן על המופע שלכם; והמצב `CallbackAuth` ללוגיקת אסימונים משלכם.
- **המשאבים של הלקוח,** כגון `workflows`, `nodes`, `jobs`, `executions`, `characters`, `apps`, `oauth` ו-`credits`.
- **השגיאות עם הטיפוסים:** `UnauthorizedError`, `ForbiddenError` עם השדה `missingScope` שלו, `InsufficientCreditsError` עם `required` ו-`available`, `RateLimitedError` ומחלקת הבסיס `NodaroError`.
- **מתכונים:** הרצת תהליך ותשאול הסטטוס שלו, גילוי הרכיבים הזמינים והרצת רכיב יחיד עם `runAndWait`.
- **מאמץ חשיבה** ברכיבים שמשתמשים במודל שפה, ו-`fetch` ופסק זמן מותאמים אישית.
- **מתי לא להשתמש ב-SDK:** נקודות קצה שמזרימות טוקנים, כגון התשובה המוזרמת של רכיב **יצירת טקסט - כל LLM**, שאין להן מתודה ב-SDK.

### מה סקיל ה-OAuth מכסה
הסקיל `building-nodaro-oauth-app` נטען כשסוכן מממש OAuth מול מופע של Nodaro. הוא מסביר מתי OAuth עדיף על אסימון API אישי, ומכסה את רישום האפליקציה, את ההרשאות, את כתובת ההפניה, את החלפת הקוד בצד השרת, את שמירת האסימונים, את ביטול האסימונים, את השגיאות הנפוצות ואת רשימת בדיקות האבטחה. המדריך המלא נמצא בדף [אפליקציות OAuth](https://nodaro.ai/docs/developers/oauth).

## הדבקת תדריך ה-SDK לסוכנים
**תדריך ה-SDK לסוכנים** הוא סיכום של עמוד אחד על ה-SDK, שנכתב לסוכני קוד. הוא נמצא בקובץ ה-README של [החבילה `@nodaro/sdk`](https://www.npmjs.com/package/@nodaro/sdk), ובקובץ טקסט רגיל שאפשר להעתיק מהטרמינל:

```bash
curl -s https://raw.githubusercontent.com/nodaroai/app.nodaro.ai/main/docs/sdk-agent-primer.txt | pbcopy          # macOS
curl -s https://raw.githubusercontent.com/nodaroai/app.nodaro.ai/main/docs/sdk-agent-primer.txt | xclip -sel clip  # Linux
```

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

- **הגדרה:** `npm install @nodaro/sdk`, ואסימון מהדף **הגדרות › מפתחות API** במשתנה הסביבה `NODARO_ACCESS_TOKEN`, אף פעם לא בתוך הקוד.
- **הדפוס המרכזי:** כל יצירה היא אסינכרונית, והמתודה `client.nodes.runAndWait` שולחת את הבקשה, בודקת את הסטטוס מדי כמה שניות ומחזירה את הפלט.
- **בחירת מודל:** להשמיט את `provider` כדי להשתמש במודל ברירת המחדל של הפלטפורמה, או לבנות תפריט בחירת מודל מתוך `client.nodes.get(type)` ו-`client.credits.modelCosts()`.
- **כללי ממשק:** להציג כל תוצאת ביניים ברגע שהיא קיימת, להציג התקדמות בזמן אמת עם `onProgress`, ולאפשר למשתמש לבטל עם `AbortSignal`.
- **הממשק לקול ולאודיו,** כולל החלפת קול לכמה דוברים והמסלול האינטראקטיבי של ניתוח, החלפת קול וייצוא.
- **קרדיטים:** יצירות עולות קרדיטים, ולכן צריך לתפוס את `InsufficientCreditsError`.

הדפוס המרכזי שהתדריך מלמד:

```ts

const client = createClient({
baseUrl: "https://app.nodaro.ai",
auth: new StaticTokenAuth(process.env.NODARO_ACCESS_TOKEN!),
})

const img = await client.nodes.runAndWait("generate-image", {
prompt: "...", provider: "gpt-image-2",   // the platform default
})
const vid = await client.nodes.runAndWait("generate-video", {
prompt: "...", imageUrl: img.imageUrl,   // the image becomes the start frame
provider: "seedance-2-fast", duration: 4,
})
// Outputs are on the resolved object: .imageUrl, .videoUrl, .audioUrl
```

## התיעוד לסוכנים בפורמט Markdown
- **כל דף זמין בפורמט Markdown.** הוסיפו `.md` לכתובת שלו, למשל `https://nodaro.ai/docs/developers/oauth.md`.
- הקובץ **`https://nodaro.ai/llms.txt`** מפרט כל דף בתיעוד עם תקציר של שורה אחת.
- הקובץ **`https://nodaro.ai/llms-full.txt`** מרכז את כל התיעוד במקום אחד.

כדי לבנות ממשק מותאם אישית לאפליקציה שפורסמה בעזרת מחולל קוד AI, תנו לו את ה-Markdown של הדף [הטמעת מיני־אפליקציה](https://nodaro.ai/docs/developers/embed/miniapps).

## סקילים או MCP
| | סקילים לסוכנים | שרת ה-MCP |
| --- | --- | --- |
| **הסוכן** | כותב קוד שקורא ל-Nodaro | משתמש ב-Nodaro ישירות, מתוך השיחה |
| **מה מקבלים** | אפליקציה, סקריפט או אינטגרציה משלכם | תמונות, סרטונים ואודיו בחשבון ה-Nodaro שלכם |
| **אימות** | אסימון API אישי או אסימון OAuth שהקוד שלכם משתמש בו | ההתחברות האישית שלכם, דרך OAuth |

התוסף ל-Claude Code נותן לכם את שניהם. כדי להוסיף את שרת ה-MCP לסוכנים אחרים, ראו את הדף [חיבור לקוח](https://nodaro.ai/docs/mcp/connect).

## כתיבת סקיל משלכם
סקיל טוב לעבודה עם Nodaro עומד בארבעה כללים:

- **טריגר ממוקד.** כתבו את ה-`description` כך שהסקיל ייטען למשימה שלו, ולא לעבודה שלא קשורה אליה.
- **תוכן מעשי.** תנו לסוכן שלבים וקוד קונקרטיים, לא רק רקע.
- **מקורות לבדיקה.** הוסיפו קישורים לדפי התיעוד שהסקיל מסתמך עליהם, כדי שהסוכן יוכל לאמת פרטים.
- **מסונכרן עם התיעוד.** עדכנו את הסקיל כשהדפים שהוא מסתמך עליהם משתנים.

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

### מה זה סקיל של Nodaro לסוכנים?

סקיל של Nodaro הוא קובץ Markdown עם הוראות, שסוכן קוד כמו Claude Code טוען כשמבקשים ממנו לבנות משהו על Nodaro. הסקיל נותן לסוכן את ההגדרה הראשונית, את הדפוסים ואת הטעויות שצריך להימנע מהן, כדי שהקוד שהוא כותב יעבוד כבר בפעם הראשונה.

### מה הדרך המהירה ביותר להגדיר את Claude Code לעבודה עם Nodaro?

התקינו את התוסף של Nodaro. הריצו ‎/plugin marketplace add nodaroai/app.nodaro.ai, ואחר כך ‎/plugin install nodaro. התקנה אחת מוסיפה את סקיל ה-SDK של Nodaro ואת החיבור לשרת ה-MCP ש-Nodaro מארח.

### האם הסקילים עובדים עם סוכני קוד אחרים מלבד Claude Code?

כן. קובצי הסקילים הם Markdown רגיל, ולכן כל סוכן שקורא הוראות לפרויקט יכול להשתמש בהם. להתחלה מהירה בכל סוכן, הדביקו לשיחה את תדריך ה-SDK לסוכנים.

### מה ההבדל בין סקיל לסוכנים לבין שרת ה-MCP של Nodaro?

סקיל מלמד סוכן לכתוב קוד שמשתמש ב-Nodaro. שרת ה-MCP מאפשר לסוכן להשתמש ב-Nodaro ישירות, כדי ליצור תמונות, סרטונים ואודיו מתוך הצ׳אט.

### האם סוכן קוד יכול לקרוא את התיעוד של Nodaro ישירות?

כן. כל דף בתיעוד זמין בפורמט Markdown כשמוסיפים ‎.md לכתובת שלו, והקובץ nodaro.ai/llms.txt מפרט כל דף עם התקציר שלו.