Dvina MCP

Korzystaj z polecenia dvina

Dowiedz się, do czego służy polecenie dvina, gdy Dvina uruchamia kod w Twoim imieniu, jakie polecenia są dostępne i które wymagają Twojej zgody.

Pokaż jako Markdown

Gdy Dvina uruchamia kod lub polecenia w Twoim imieniu, ma do dyspozycji własne polecenie: dvina. Dzięki niemu skrypt lub kilka kolejnych kroków może przeszukiwać Twoją Dvina, odczytywać i dodawać dokumenty, pamięć i zadania oraz sprawdzać, kto ma dostęp do danego elementu — w Twoim imieniu.

Nie musisz niczego instalować ani się logować. Dvina używa tego polecenia, gdy wymaga tego Twoja prośba. Możesz też poprosić o nie wprost, na przykład: „Użyj dvina, aby wyświetlić moje zadania i zapisać podsumowanie jako notatkę”.

Jak to działa

  • dvina działa w Twojej Dvina, w Twoim imieniu, z uprawnieniami wynikającymi z Twojej roli i w ramach Twoich standardowych limitów.
  • Dostęp trwa tylko wtedy, gdy Dvina pracuje nad Twoją prośbą. Po zakończeniu odpowiedzi polecenie nie ma już dostępu do Twojej Dvina.
  • Plik lub folder jest odczytywany tylko wtedy, gdy polecenie wskazuje go wprost, na przykład jako plik do przesłania.

Polecenia

Polecenia są podzielone na grupy: dvina <group> <command>, a następnie argumenty i flagi danego polecenia.

Grupa Polecenia
search dvina search <query>: przeszukuj jednocześnie swoje czaty, dokumenty, pamięć i świat.
memory ls, show, add, edit: wyświetlaj listę plików pamięci, odczytuj je, dodawaj lub zmieniaj.
world topics, topic, recall, feed: Twoje tematy, wiedza Dvina na dany temat i Twój Feed.
docs ls, show, read, search, create, upload, update, mv, mkdir, rm: Twoje dokumenty i foldery w Library.
canvas ls, show, create, write-page: wyświetlaj listę stron płótna, odczytuj je, twórz lub przepisuj.
tasks ls, show, start, continue, stop: Twoje zadania w tle.
goals show, start: zadania służące realizacji celu.
schedule ls, add, cancel: zaplanowane wiadomości i przypomnienia, jednorazowe lub cykliczne.
agents ls, show, create, update: Twoi agenci.
skills ls, show, add, edit: Twoje umiejętności.
projects ls, show: Twoje projekty.
settings get, set: Twoje preferencje, na przykład włączanie lub wyłączanie pamięci.
share state, with-me, add, rm: sprawdzanie, kto ma dostęp do elementu i co inni Ci udostępnili, oraz przyznawanie lub odbieranie dostępu.

dvina nie może trwale usuwać elementów, otwierać publicznych linków, łączyć ani odłączać aplikacji ani zmieniać ustawień administracyjnych lub rozliczeniowych.

Pomoc i wyniki

  • dvina --help wyświetla grupy, dvina <group> --help wyświetla polecenia danej grupy, a dvina <group> <command> --help wyświetla argumenty i flagi danego polecenia.
  • Wynik ma postać krótkiego tekstu. Dodaj --json, aby otrzymać JSON, lub --fields z listą rozdzieloną przecinkami, na przykład --fields id,title, aby zachować tylko wybrane pola.
  • Długa lista kończy się wpisem next: --cursor <c>. Uruchom polecenie ponownie z tym --cursor, aby pobrać następną stronę.
  • Aby odczytać wartość z pliku, dodaj -file do jej flagi, na przykład --content-file notes.md. dvina docs upload <file> przesyła plik, a dvina skills add <folder> dodaje folder umiejętności wraz z jego plikiem SKILL.md.

Kody zakończenia

Kod Znaczenie
0 Gotowe.
1 Wystąpił inny błąd.
2 Polecenie jest nieprawidłowe. Sprawdź jego --help.
3 Nie znaleziono.
4 Odmowa: Twoje uprawnienia, zasady firmy lub ochrona danych nie pozwalają na tę operację.
5 Wymaga Twojej zgody.
6 Twój limit użytkowania został osiągnięty.

Zatwierdzaj zmiany

  • Polecenia odczytujące dane działają bez pytania o zgodę.
  • Polecenia dodające coś nowego, takie jak docs create, memory add lub tasks start, działają bez pytania o zgodę. Nigdy nie zmieniają tego, co już istnieje.
  • Polecenia zmieniające lub usuwające coś najpierw pytają Cię o zgodę. Dotyczy to przenoszenia, zmiany nazwy, przenoszenia do kosza, zastępowania notatki lub pliku pamięci, przepisywania strony płótna, zmiany agenta lub umiejętności, zatrzymywania zadania, anulowania zaplanowanej wiadomości i udostępniania. Dvina wyświetla na czacie kartę zatwierdzenia z własnym podsumowaniem zmiany i za każdym razem prosi o zgodę. Jeśli odrzucisz prośbę, nic się nie zmieni.

To, co dvina dodaje lub zmienia, podlega zasadom ochrony danych Twojej firmy i jest zapisywane w Twoim dzienniku audytu, tak samo jak inne działania Dvina.