QuickAgent - מדריך

מדריך למשתמש של QuickAgent

QuickAgent הוא סביבת עבודה לסוכני AI בגישת local-first. הוא הופך יעד ל‑Run עמיד, מגביל את אותו Run באמצעות Workspace Profile, מבקש בדיקה לפני פעולות רגישות ושומר תוצאות מאומתות ב‑Artifacts.

תחילת העבודה

פתחו את Settings > AI, הוסיפו ספק והפעילו את בדיקת החיבור שלו.
פתחו את Settings > Workspace Profiles. בחרו אילו ספק, כלים, חיבורים, שורשי קבצים, מקורות Knowledge ותחומי Memory ניתן להשתמש בהם.
בחרו New Chat, בחרו את הפרופיל ואשרו את יעד הספק המוצג מעל השיחה.
תארו תוצאה רצויה. הוסיפו רק את הקבצים, התיקיות, המדיה, ה‑Knowledge או ה‑Memory הנדרשים ל‑Run זה.
בדקו את התוכנית, האישורים, אישור ה‑Critical ותצוגת Data Send Preview כאשר הם מופיעים.
עקבו אחר העבודה ב‑Timeline. פתחו את הפלט שהושלם מתוך Artifacts ובדקו את נתיב הביקורת בתוך היסטוריה.

עצה: התחילו עם Workspace Profile מצומצם. הרחיבו את הכלים או השורשים שלו רק כאשר QuickAgent מציג סיבה ספציפית לכך שאינו זמין.

סקירת הממשק

מקטע	למה הוא מיועד
Chats	שיחות, יעד הספק, Context Tray, תוכניות, אישורים ו‑Run Timeline הפעיל.
Runs	כל משימה מתוכננת, פועלת, מושהית, מתוזמנת, שנכשלה או הושלמה.
Approval Inbox	בדיקות פעולה ממתינות, Critical ו‑Data Send הזקוקות להחלטתכם.
Artifacts	קבצים, דוחות, יומנים, מדיה, טבלאות ומניפסטים של פעולות מאומתים שנוצרו על ידי Runs.
Automations	לוחות זמנים, מנטרים, webhooks, אירועי אפליקציה ומפעילי Shortcut/App Intent.
Skills	הוראות לשימוש חוזר עם קלטים מוקלדים, כלים מותרים, חיבורים נדרשים, סיכון ופלטים.
Connections	ספקים, פרופילי דפדפן, שורשי קבצים/VFS, SSH, MCP, HTTP/SaaS, גשרי בית וערוצי התראות.
Knowledge	תיקיות מאונדקסות, תוכן QuickNote, קטעי אינטרנט, קובצי PDF ומקורות Office.
היסטוריה	החלטות בטיחות, פעולות כלי, יעדים וחותמות זמן הנוספות בלבד.
הגדרות	מראה, שפה, AI, כלים, בטיחות, Workspace Profiles, קיצורי דרך, הרשאות, עזרה ו‑Pro.

ספקים ו‑Workspace Profiles

QuickAgent יכול להשתמש ב‑System AI כאשר מערכת ההפעלה חושפת יכולת תואמת, בספקים מקומיים כגון Ollama, LM Studio או DeskLLM, בנקודות קצה LAN או OpenAI-compatible מותאמות אישית, ובספקי ענן מוגדרים כגון Anthropic או Gemini. הזמינות נקבעת באמצעות בדיקת יכולת חיה; שם ספק לבדו אינו אומר שהוא מוכן.

Workspace Profile הוא מעטפת ההרשאות של ה‑Run. הוא מצלם את הספק/המודל שנבחרו, הכלים המותרים, החיבורים, שורשי הקבצים, מקורות Knowledge, תחומי Memory, עקיפות הבטיחות והתקציב. שינוי תצורה מאוחר יותר הופך את התמונה למיושנת ומחייב בדיקה.

כלל יעד: QuickAgent לעולם אינו עובר בשקט מספק במכשיר או מקומי לענן. היעד הפעיל נשאר גלוי ב‑Chat ובכל בדיקת Data Send.

Runs, אישורים ושחזור

פקדי Run

השהה מבקש עצירה שיתופית בנקודת ביקורת עמידה.
המשך ממשיך את אותו Run ואת העבודה שהושלמה.
עצור מבטל עבודת ספק וכלי. השפעה חיצונית שנעצרה או אינה ודאית אינה מדווחת כהצלחה.
נסה שוב זמין רק כאשר QuickAgent יכול לזהות גבול בטוח לניסיון חוזר.

רמות בטיחות

רמה	משמעות
בטוח	קרא, בדוק או המר בתוך הפרופיל הפעיל.
אשר	בדקו כתיבה רגילה או פעולה חיצונית.
ודאו ש-	בדקו שינוי בעל השפעה רבה יותר או שקשה יותר לבטל.
Critical	אישור חזק בכל פעם; כללים לעולם אינם מאשרים אותו אוטומטית.

האישור מציג את היעד המדויק, היעד החיצוני, הארגומנטים המוצעים, הסיכון ומצב Undo. אם תערכו ארגומנט, QuickAgent מאמת ובודק שוב את הסיכון של הפעולה הערוכה.

תוצאה לא ודאית: לאחר הפרעה, בדקו תחילה את מערכת היעד. בחרו ב‑“I checked — retry” רק כאשר ראוי לחזור על הפעולה. “Resume” לבדו לעולם אינו חוזר על השפעה חיצונית לא ודאית.

Runs מרובי סוכנים

יעדים מורכבים יכולים להשתמש במתכנן, בעובדים מומחים מוקלדים, במבקר ובמבקר אבטחה. ה‑Timeline מציג כל העברה, בדיקה, ניסיון חוזר, חלופה וגבול של תגובה סופית. העובדים מקבלים רק את החיתוך הארבע־כיווני של כלי Skill, כלי Workspace Profile, כלי תפקיד וכלים חיים כעת.

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

הקשר, Knowledge ו‑AI Memory

Context Tray

הוסיפו קבצים, תיקיות, תמונות, מסגרות וידאו, אודיו, הערות קוליות, תוכן QuickNote, Knowledge או Workspace Memory. QuickAgent מחלץ או מסכם תוכן נתמך ומציג אם קובץ מצורף יישלח ישירות לספק.

Knowledge

מקורות Knowledge מאונדקסים בנפרד מהצ'אט. Run יכול לחפש רק במקורות המותרים על ידי Workspace Profile שלו, והציטוטים שומרים על זהות המקור שלהם.

Memory

Memory הוא מכוון, ולא היסטוריית צ'אט אוטומטית. התחומים User, Workspace, Project ו‑Tool/Connection נפרדים. כל בקשת יצירה, עריכה או מחיקה מקבלת אישור חדש, ותצוגת האישור מציגה את התחום ואת הערך המוצע המדויק.

כלים וחיבורים

הקטלוג החי כולל פעולות קבצים/VFS; Office, PDF ונתונים מובנים; מדיה ו‑OCR; שימוש בדפדפן ובמחשב; פקודות פיתוח; SSH; ‏MCP; ‏HTTP ו‑SaaS; גשרי בית חכם; התראות; לוחות זמנים; מנטרים; ובקרת אוטומציה. שרתי MCP מחוברים עשויים להוסיף כלים דינמיים לאחר אימות סכימה והערכת סיכון מחדש של QuickAgent.

Settings > Tools מציג מדוע כלי מוכן או מושבת. סיבות נפוצות הן חיבור חסר, הרשאת מערכת הפעלה, פלטפורמה שאינה נתמכת, הגבלת Workspace Profile, נקודת קצה שלא נבדקה או יכולת ספק שאינה זמינה.

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

Automations

אוטומציות יכולות להתחיל מטריגרים של זמן, קובץ/תיקייה, אינטרנט, webhook, דוא״ל, לוח שנה, רשת, מארח, מכשיר, חיישן, מיקום, אירוע אפליקציה, Shortcut/App Intent, פקודה או הפעלה ידנית כאשר הפלטפורמה תומכת בהם. טריגר יוצר Run רגיל; הוא אינו עוקף בדיקות של Workspace Profile, אישור, Critical או Data Send.

ניטור בשולחן העבודה נמשך רק כל עוד תהליך האפליקציה פועל.
פלטפורמות ניידות משחזרות עבודה שאיחרה כאשר האפליקציה חוזרת לקדמה.
השתמשו ב‑Shortcut/App Intent או בממסר אירועים מהימן כאשר נדרשת מסירה של מערכת ההפעלה.
אירועים בתור, השהיה, ביטול ומחיקה נשארים מפורשים, כדי שאירועים לא יימחקו בשקט.

Skills ו‑Skill Packs

Skill שומר הנחיה ממוקדת תוצאה, משתנים מוקלדים, המלצת ספק, כלים מותרים, חיבורים ויכולות נדרשים, סיכון מרבי ו‑Artifacts צפויים. לפני השימוש, QuickAgent מציג את הקלטים ואת ההרשאות האפקטיביות; התצוגה המקדימה כשלעצמה אינה מעניקה הרשאה.

שבע חבילות מובנות מספקות Skills ממשיים עבור Office, קידוד, בית חכם, מחקר, אוטומציית דפדפן, ניהול אישי ותגובה לאירועים. ניתן להתקין, לעדכן, להסיר התקנה, להתאים אישית, לשכפל, לייבא ולייצא Skills. JSON מיובא מקבל תצוגה מקדימה של אמון, מפרסם, חתימה, הרשאה, סיכון, פלטפורמה והתנגשות. “Keep both” יוצר נגזרת מקומית לא חתומה במקום לרשת את האמון של מפרסם אחר.

Artifacts, היסטוריה ו‑Undo

Artifacts שומרים בתים של פלט, מטא־נתונים, גרסאות, מקוריות, Run מקור ומניפסטים של פעולות. בהתאם ליכולת הפלטפורמה, אפשר לפתוח, לשתף, לייצא או לחשוף אותם. פעולות זכאיות מציעות Undo שנבדק; עבודה הרסנית או לא ודאית לעולם אינה מופעלת מחדש אוטומטית.

ההיסטוריה היא הוספה בלבד. סננו אותה לפי Safe, Approve, Confirm או Critical, וייצאו את הביקורת כאשר אתם זקוקים לרשומה חיצונית.

הגדרות

כללי: מראה, שפה, Workspace Profiles, קיצורי דרך, עזרה והרשאות.
AI: ספקים, נקודות קצה, מודלים, אישורים ובדיקות חיות.
כלים: מוכנות הקטלוג, תמיכת הפלטפורמה וסיבות ההגדרה.
בטיחות: כללי אישור, אופן הפעולה של Data Send, אימות מכשיר ומדיניות Memory מוגדרת תחום.
מתקדם: שחזור ואבחון המיועדים לפתרון בעיות.

קיצורי מקלדת

ב‑macOS, האפליקציה ממפה את קיצורי הדרך המוצגים של Ctrl למקש Command של הפלטפורמה, במקרים המתאימים. דף Shortcuts באפליקציה הוא הקובע ותומך בהתאמה אישית.

קיצור	פעולה
`Ctrl` + `N`	New Chat
`Ctrl` + `L`	מקד את אזור הכתיבה
`Ctrl` + `Shift` + `Space`	השהה או המשך את ה‑Run הפעיל
`Ctrl` + `.`	עצור את ה‑Run הפעיל
`Ctrl` + `1` … `9`	פתח Chats דרך History
`Ctrl` + `,`	פתח Settings
`F1`	פתח Help & Privacy
`Esc`	סגור תיבת דו־שיח או בטל את האינטראקציה הנוכחית שאינה הרסנית

הערות פלטפורמה

פלטפורמה	גבולות חשובים
macOS	מבודד בארגז חול ב‑Debug וב‑Release. הגישה לקבצים משתמשת בשורשים שנבחרו/סימניות מוגדרות־אבטחה. Screen Recording ו‑Accessibility הן הרשאות מערכת נפרדות. שילובי תהליכים מקומיים ו‑Shortcut נותרים כפופים לבדיקת יכולת.
Windows	תכונות קבצים, Office/PDF/נתונים, דפדפן, פיתוח, מרחוק ובקרת שולחן עבודה תלויות בסביבת זמן הריצה המותקנת ובהרשאות. שילובים המיועדים ל‑Apple בלבד אינם זמינים ומוצגת סיבה לכך.
iPhone / iPad	קבצים משתמשים בבורר המערכת. גישה למצלמה, מיקרופון, דיבור, תמונות, רשת מקומית והתראות מתבקשת לפי ההקשר. ניטור ברקע אינו מובטח; השתמשו ב‑Shortcuts/App Intents או בהשלמה עם החזרה לקדמה.
Android	קבצים ותיקיות משתמשים ב‑Storage Access Framework. עבודת רקע כפופה להגבלות Android. בקרת קלט המבוססת על Accessibility לעולם אינה נחשבת למאושרת רק מפני ששירות מוצהר.
Web	משתמש באחסון למשך ההפעלה בלבד עבור תכונות הדורשות התמדה מקומית ומבטל באופן ברור יכולות מכשיר, שורש קובץ, תהליך מקומי ורקע שאינן נתמכות.

טיפים & טריקים

התחילו עם Workspace Profile מצומצם והוסיפו כלי, חיבור או שורש קובץ רק כאשר ה‑Run מציג דרישה ספציפית.

הגדירו לכל בקשה תוצאה ברורה, Artifact צפוי וגבול בדיקה, כדי שההתקדמות תישאר קלה לביקורת.

השתמשו ב‑Knowledge עבור מקורות מאונדקסים לשימוש חוזר וב‑Context עבור חומר הנדרש רק ל‑Run הנוכחי.

כאשר השפעה חיצונית אינה ודאית, בדקו את היעד לפני ניסיון חוזר; Resume לעולם אינו חוזר עליה אוטומטית.

פתרון בעיות

בעיה	מה לבדוק
הספק אינו יכול לפעול	פתחו את Settings > AI. בדקו תצורה, אימות, יכולת מודל, נגישות נקודת קצה, פרטי זמן קצוב ומגבלת קצב, ואז הפעילו את בדיקת החיבור.
כלי מושבת	פתחו את Settings > Tools וקראו את הסיבה החיה. בדקו את הפלטפורמה הנוכחית, ההרשאה, בדיקת החיבור, Workspace Profile והשורש שנבחר.
Run נראה תקוע	פתחו את Runs ואת ה‑Timeline. ייתכן שהוא מושהה, ממתין לקלט, לאישור, לאישור Critical, לבדיקת Data Send או לבדיקת תקציב. האפשרות Stop נשארת זמינה.
הרשאה השתנתה	פתחו את Help > Overview או את Settings, ואז פתחו את הגדרות המערכת. בדקו מחדש את החיבור או הכלי שהושפעו לאחר החזרה.
פעולה חיצונית אינה ודאית	בדקו את מערכת היעד. השאירו את ההרצה מושהית או עצרו אותה, אלא אם אימתתם כי ניסיון חוזר מתאים.
אוטומציה לא הופעלה ברקע	מערכות הפעלה לנייד אינן מבטיחות תשאול שרירותי. חזרו לחזית כדי להשלים פערים, או הגדירו Shortcut/App Intent או מקור אירועים מהימן.
לא ניתן לפתוח או לייצא Artifact	בדקו אם הנתונים שלו עדיין זמינים, אם הפלטפורמה תומכת בפעולה, ואם ההרשאה של היעד שנבחר עדיין תקפה.

פרטיות, הרשאות ורישיונות

QuickAgent שומר שיחות, הרצות, אישורים, מטא-נתונים של Knowledge, Skills והגדרות באופן מקומי. אישורים משתמשים באחסון המוגן על ידי הפלטפורמה. תוכן עוזב את המכשיר רק דרך ספק או שירות מחובר שהגדרתם, ושליחות חיצוניות מקבלות תצוגה מקדימה המותאמת ליעד.

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

פתחו את הגדרות > עזרה & פרטיות לטבלת היכולות של הפלטפורמה הנוכחית ול רישיונות קוד פתוח להודעות לגבי חבילות ורכיבים מקוריים כלולים.

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