Dvina MCP

Використовуйте команду dvina

Дізнайтеся, що робить команда dvina, коли Dvina виконує код для вас, які команди доступні та які з них потребують вашого схвалення.

Перегляд у Markdown

Коли 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.