Когда 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.