Dvina MCP

שימוש בפקודה dvina

למדו מה הפקודה dvina עושה כש-Dvina מריץ קוד עבורכם, אילו פקודות זמינות ואילו מהן דורשות את אישורכם.

הצגה כמרקדאון

כש-Dvina מריץ עבורכם קוד או פקודות, עומדת לרשותו פקודה משלו: dvina. בעזרתה, סקריפט או רצף של כמה פעולות יכולים לחפש ב-Dvina שלכם, לקרוא ולהוסיף מסמכים, זיכרון ומשימות, ולבדוק למי יש גישה לפריט — בשמכם.

אין צורך להתקין דבר או להתחבר לחשבון. Dvina משתמש בפקודה כשהבקשה שלכם מצריכה זאת, ואפשר גם לבקש ממנו להשתמש בה, למשל: "השתמש ב-dvina כדי להציג את רשימת המשימות שלי ולכתוב סיכום כפתק."

איך זה עובד

  • dvina פועל ב-Dvina שלכם, בשמכם, בהתאם להרשאות התפקיד שלכם ובמסגרת המגבלות הרגילות שלכם.
  • הגישה שלו תקפה רק כל עוד Dvina עובד על הבקשה שלכם. כשהתשובה מסתיימת, לפקודה אין עוד גישה ל-Dvina שלכם.
  • הוא קורא קובץ או תיקייה רק כשפקודה מציינת אותם, למשל קובץ להעלאה.

פקודות

הפקודות מחולקות לקבוצות: dvina <group> <command>, ואחריהן הארגומנטים והדגלים של הפקודה.

קבוצה פקודות
search dvina search <query>: חיפוש בצ'אטים, במסמכים, בזיכרון ובעולם שלכם בבת אחת.
memory ls, show, add, edit: הצגה ברשימה, קריאה, הוספה או שינוי של קובצי הזיכרון שלכם.
world topics, topic, recall, feed: הנושאים שלכם, מה ש-Dvina יודע על משהו, והפיד שלכם.
docs ls, show, read, search, create, upload, update, mv, mkdir, rm: המסמכים והתיקיות בספרייה שלכם.
canvas ls, show, create, write-page: הצגה ברשימה, קריאה, יצירה או כתיבה מחדש של דפי קנבס.
tasks ls, show, start, continue, stop: המשימות שלכם שפועלות ברקע.
goals show, start: משימות שפועלות להשגת יעד.
schedule ls, add, cancel: הודעות ותזכורות מתוזמנות, חד-פעמיות או חוזרות.
agents ls, show, create, update: הסוכנים שלכם.
skills ls, show, add, edit: המיומנויות שלכם.
projects ls, show: הפרויקטים שלכם.
settings get, set: ההעדפות שלכם, כמו הפעלה או כיבוי של הזיכרון.
share state, with-me, add, rm: למי יש גישה לפריט, מה אחרים שיתפו איתכם, ומתן גישה או הסרתה.

dvina לא יכול למחוק דבר לצמיתות, לפתוח קישורים ציבוריים, לחבר או לנתק אפליקציות, או לשנות הגדרות ניהול או חיוב.

עזרה ופלט

  • dvina --help מציג את רשימת הקבוצות, dvina <group> --help מציג את רשימת הפקודות בקבוצה, ו-dvina <group> <command> --help מציג את רשימת הארגומנטים והדגלים של פקודה.
  • הפלט הוא טקסט קצר. הוסיפו --json לקבלת JSON, או --fields עם רשימה מופרדת בפסיקים, כמו --fields id,title, כדי להשאיר רק שדות מסוימים.
  • רשימה ארוכה מסתיימת ב-next: --cursor <c>. הריצו שוב את הפקודה עם אותו --cursor כדי לקבל את העמוד הבא.
  • כדי לקרוא ערך מקובץ, הוסיפו -file לדגל שלו, כמו --content-file notes.md. הפקודה dvina docs upload <file> מעלה קובץ, והפקודה dvina skills add <folder> מוסיפה תיקיית מיומנות עם קובץ ה-SKILL.md שלה.

קודי יציאה

קוד משמעות
0 הפעולה הושלמה.
1 אירעה שגיאה אחרת.
2 הפקודה שגויה. בדקו את ה---help שלה.
3 לא נמצא.
4 הפעולה נדחתה: הרשאות הגישה שלכם, כללי החברה שלכם או הגנת הנתונים לא מאפשרים אותה.
5 נדרש אישורכם.
6 הגעתם למגבלת השימוש שלכם.

אישור שינויים

  • פקודות שקוראות מידע פועלות בלי לבקש אישור.
  • פקודות שמוסיפות משהו חדש, כמו docs create,‏ memory add או tasks start, פועלות בלי לבקש אישור. הן לעולם לא משנות את מה שכבר קיים.
  • פקודות שמשנות או מסירות משהו מבקשות את אישורכם קודם: העברה, שינוי שם, העברה לאשפה, החלפת פתק או קובץ זיכרון, כתיבה מחדש של דף קנבס, שינוי סוכן או מיומנות, עצירת משימה, ביטול הודעה מתוזמנת ושיתוף. Dvina מציג בצ'אט כרטיס אישור עם סיכום משלו של השינוי, ומבקש אישור בכל פעם. אם אתם דוחים את הבקשה, דבר לא משתנה.

כל מה ש-dvina מוסיף או משנה עובר בדיקה לפי כללי הגנת הנתונים של החברה שלכם ונרשם ביומן הביקורת שלכם, בדיוק כמו שאר הפעולות של Dvina.