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

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

מה זמין

התקנת התוסף ל-Claude Code

ב-Claude Code, הריצו:

/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).

הוספת קובץ סקיל לפרויקט שלכם

שני קובצי הסקילים נמצאים בתיקייה docs/skills במאגר הקוד הציבורי. כל קובץ מתחיל ב-frontmatter של YAML: השדה name והשדה description, שאומר לסוכן מתי לטעון את הסקיל. אחרי ה-frontmatter באות ההוראות, ב-Markdown.

מה סקיל ה-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.

הדבקת תדריך ה-SDK לסוכנים

תדריך ה-SDK לסוכנים הוא סיכום של עמוד אחד על ה-SDK, שנכתב לסוכני קוד. הוא נמצא בקובץ ה-README של החבילה @nodaro/sdk, ובקובץ טקסט רגיל שאפשר להעתיק מהטרמינל:

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.

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

import { createClient, StaticTokenAuth } from "@nodaro/sdk"

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 של הדף הטמעת מיני־אפליקציה.

סקילים או MCP

התוסף ל-Claude Code נותן לכם את שניהם. כדי להוסיף את שרת ה-MCP לסוכנים אחרים, ראו את הדף חיבור לקוח.

כתיבת סקיל משלכם

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

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