# Використовуйте команду 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)