Dvina MCP

Používejte příkaz dvina

Zjistěte, co příkaz dvina dělá, když za vás Dvina spouští kód, jaké příkazy nabízí a které vyžadují vaše schválení.

Zobrazit v Markdownu

Když za vás Dvina spouští kód nebo příkazy, má k dispozici vlastní příkaz: dvina. Pomocí něj může skript nebo několik navazujících kroků pod vaší identitou prohledávat vaši Dvina, číst a přidávat dokumenty, paměť a úkoly a zjišťovat, kdo má k položce přístup.

Nemusíte nic instalovat ani se přihlašovat. Dvina příkaz použije, když to váš požadavek vyžaduje. Můžete si o něj také říct, například: „Pomocí dvina vypiš moje úkoly a napiš jejich shrnutí jako poznámku.“

Jak to funguje

  • dvina pracuje ve vaší Dvina pod vaší identitou, s oprávněními vaší role a v rámci vašich obvyklých limitů.
  • Přístup má jen po dobu, kdy Dvina pracuje na vašem požadavku. Jakmile odpověď skončí, příkaz už k vaší Dvina nemá přístup.
  • Soubor nebo složku čte jen tehdy, když je příkaz výslovně uvede, například jako soubor k nahrání.

Příkazy

Příkazy jsou rozdělené do skupin: dvina <group> <command>, za nimi následují argumenty a přepínače příkazu.

Skupina Příkazy
search dvina search <query>: prohledává najednou vaše chaty, dokumenty, paměť a svět.
memory ls, show, add, edit: vypisuje, čte, přidává nebo mění vaše soubory paměti.
world topics, topic, recall, feed: vaše témata, co Dvina o něčem ví, a váš Feed.
docs ls, show, read, search, create, upload, update, mv, mkdir, rm: dokumenty a složky ve vaší knihovně.
canvas ls, show, create, write-page: vypisuje, čte, vytváří nebo přepisuje stránky plátna.
tasks ls, show, start, continue, stop: vaše úkoly na pozadí.
goals show, start: úkoly, které směřují k určitému cíli.
schedule ls, add, cancel: naplánované zprávy a připomínky, jednorázové nebo opakované.
agents ls, show, create, update: vaši agenti.
skills ls, show, add, edit: vaše dovednosti.
projects ls, show: vaše projekty.
settings get, set: vaše předvolby, například zapnutí nebo vypnutí paměti.
share state, with-me, add, rm: kdo má k položce přístup, co s vámi ostatní sdílejí, a udělení nebo odebrání přístupu.

dvina nemůže nic trvale smazat, otevírat veřejné odkazy, připojovat ani odpojovat aplikace ani měnit nastavení správy nebo fakturace.

Nápověda a výstup

  • dvina --help vypíše skupiny, dvina <group> --help vypíše příkazy skupiny a dvina <group> <command> --help vypíše argumenty a přepínače příkazu.
  • Výstupem je krátký text. Pro JSON přidejte --json. Pokud chcete ponechat jen některá pole, přidejte --fields se seznamem odděleným čárkami, například --fields id,title.
  • Dlouhý seznam končí řádkem next: --cursor <c>. Spusťte příkaz znovu s tímto --cursor, abyste získali další stránku.
  • Pokud chcete načíst hodnotu ze souboru, přidejte k jejímu přepínači -file, například --content-file notes.md. Příkaz dvina docs upload <file> nahraje soubor a dvina skills add <folder> přidá složku dovednosti s jejím souborem SKILL.md.

Návratové kódy

Kód Význam
0 Hotovo.
1 Došlo k jiné chybě.
2 Příkaz není správný. Podívejte se do jeho nápovědy --help.
3 Nenalezeno.
4 Zamítnuto: vaše oprávnění, pravidla vaší firmy nebo ochrana dat to nedovolují.
5 Je potřeba vaše schválení.
6 Dosáhli jste limitu využití.

Schvalování změn

  • Příkazy, které čtou, se spouštějí bez dotazu.
  • Příkazy, které přidávají něco nového, například docs create, memory add nebo tasks start, se spouštějí bez dotazu. Nikdy nemění to, co už existuje.
  • Příkazy, které něco mění nebo odstraňují, se vás nejdřív zeptají: přesunutí, přejmenování, přesunutí do koše, nahrazení poznámky nebo souboru paměti, přepsání stránky plátna, změna agenta nebo dovednosti, zastavení úkolu, zrušení naplánované zprávy a sdílení. Dvina v chatu zobrazí kartu ke schválení s vlastním shrnutím změny a pokaždé se vás zeptá. Pokud změnu odmítnete, nic se nezmění.

Vše, co dvina přidá nebo změní, prochází kontrolou podle pravidel ochrany dat vaší firmy a zaznamenává se do vašeho protokolu auditu, stejně jako ostatní akce Dvina.