בנייה בעזרת סוכני AI

Institflow מספקת Agent Skill לממשק הציבורי שלה — תיקייה קטנה ועצמאית שמלמדת סוכן קוד (Claude Code, Cursor, Codex, או כל כלי אחר שיודע לקרוא קובץ ולשלוח בקשות HTTP) כל מה שהוא צריך כדי להתממשק נכון: אימות, מעטפת השגיאה, אידמפוטנטיות, עימוד, מגבלות קצב, אימות חתימה של webhook, וקוד דוגמה שרץ — בלי שהסוכן ייאלץ לגלות שום דבר מזה מחדש בניסוי וטעייה מול הדייר שלכם.

ה-Agent Skill של Institflow

המיומנות היא תיקייה, institflow-api/, שמכילה קובץ כניסה אחד (SKILL.md) וחומרי עזר נלווים שהסוכן טוען רק לפי הצורך (אינדקס מלא של נקודות הקצה שנוצר ממסמך הממשק החי, פירוט webhooks ושגיאות, ושתי דוגמאות ברות-הרצה — אחת ב-TypeScript ואחת ב-Python, שתיהן עם fetch/ספריית התקן בלבד, בלי SDK). היא לעולם לא מעודדת דפוס לא מאובטח — בלי מפתחות במחרוזת שאילתה, השוואת חתימות webhook בזמן קבוע, ומפתחות אידמפוטנטיות בכל קריאה שמזיזה כסף.

הורדת institflow-api-skill.tar.gz או institflow-api-skill.zip — אותה תיקייה, בשני פורמטים. קובץ ה-tar.gz נפרס ישירות לתיקיית מיומנויות בפקודה אחת:

bash
curl -fsSL https://docs.institflow.com/downloads/institflow-api-skill.tar.gz | tar -xz -C ~/.claude/skills

התוצאה היא תיקיית ~/.claude/skills/institflow-api/ מוכנה לשימוש — בלי שלב חילוץ נפרד. שתי החבילות נבנות מחדש מהאתר הזה בכל פעם שקבוצת נקודות הקצה של הממשק משתנה, אז הריצו את הפקודה שוב (או הורידו מחדש את ה-zip) מדי פעם במקום לשמור עותק משלכם לנצח.

כבר עובדים בתוך המאגר הזה?

דלגו על ההורדה: המאגר הזה כולל עותק מוכן לשימוש ב-.claude/skills/institflow-api (זהה בית-בבית ל-skills/institflow-api/, המקור הקנוני שנארז בחבילות שלמעלה, על ידי אותו מחולל) — Claude Code טוען אותו אוטומטית, בלי הורדה ובלי חילוץ.

התקנה ב-Claude Code

Claude Code מגלה מיומנויות משתי תיקיות: אישית (זמינה בכל פרויקט) או ייעודית לפרויקט (מוכנסת למאגר ומשותפת עם הצוות):

bash
# Personal — available in every project on this machine
unzip institflow-api-skill.zip -d ~/.claude/skills/institflow-api

# Project — checked into this repo, shared with your team
unzip institflow-api-skill.zip -d .claude/skills/institflow-api

Claude Code קורא את ה-frontmatter של כל SKILL.md (name + description) כדי להחליט מתי היא רלוונטית — אינכם צריכים להזכיר אותה בשמה. בקשו ממנו “ליצור תלמיד דרך ה-API של Institflow” או “לאמת את חתימת ה-webhook הזו של Institflow” והוא יטען את המיומנות אוטומטית.

כללי Cursor

Cursor עדיין לא קורא את פורמט ה-Agent Skills ישירות — הפנו אותו לאותו תוכן ככלל פרויקט במקום: חלצו את המיומנות לתוך המאגר שלכם (בכל מקום, למשל docs/institflow-api/) והוסיפו קובץ .cursor/rules/institflow-api.mdc קצר שמפנה אליה:

.cursor/rules/institflow-api.mdc
---
description: Institflow public API integration — auth, pagination, idempotency, webhooks
globs:
alwaysApply: false
---

When writing code that calls the Institflow API, follow docs/institflow-api/SKILL.md exactly —
especially its Idempotency, Pagination, and Gotchas sections. Endpoint details are in
docs/institflow-api/reference/endpoints.md.

סוכנים אחרים

כל סוכן שאינו יודע לטעון תיקיית מיומנות באופן טבעי עדיין נהנה מאותו תוכן: הדביקו את SKILL.md ישירות לפרומפט המערכת או לחלון ההקשר שלו, או הפנו כלי שיודע להביא כתובת אל llms.txt שלמטה, שמרכז במקום אחד את כל המדריכים, את מסמך הממשק הקריא למכונה, ואת הורדת המיומנות — בדיוק למטרה הזו.

plaintext
https://docs.institflow.com/llms.txt
https://docs.institflow.com/llms-full.txt

או התחברות ישירה לשרת MCP

אם הסוכן שלכם פועל בשם אדם מסוים ומחובר (ולא רץ ללא השגחה כשירות) ומדבר Model Context Protocol, חיבור אל /mcp הוא לרוב התאמה טובה יותר מממשק ה-REST שהמיומנות הזו מכסה — הסכמת OAuth תוחמת את הסשן להרשאות של אותו אדם בדיוק, ופעולות הרסניות חוזרות כתצוגה מקדימה לאישור במקום להתבצע מיד. ראו את המדריך ל-MCP ו-OAuth 2.1 לכתובת החיבור, לתהליך הגילוי ולקטלוג הכלים המלא, ואת הסעיף “REST מול MCP” במיומנות עצמה כדי להחליט במה לבחור.

שני משטחים, מודל הרשאות אחד

REST (עם מפתח API) ו-MCP (עם טוקן OAuth) קוראים לאותם שירותי דומיין בדיוק, תחת אותו מרשם הרשאות בדיוק — אין שום דבר שאפשר לעשות דרך אחד מהם שאינו נשלט באותם כללים דרך השני.