# שימוש בפקודה 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` מוסיף או משנה עובר בדיקה לפי כללי הגנת הנתונים של החברה שלכם ונרשם ב[יומן הביקורת](/docs/teams/audit-log) שלכם, בדיוק כמו שאר הפעולות של Dvina.

## מידע נוסף

- [שימוש ב-Dvina מאפליקציות אחרות באמצעות MCP](/docs/dvina-mcp/overview)
- [משימות](/docs/use-dvina/features/tasks)
- [סקירה כללית של מחברים](/docs/connectors/overview)