# 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í.

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](/docs/teams/audit-log), stejně jako ostatní akce Dvina.

## Související

- [Používejte Dvina z jiných aplikací pomocí MCP](/docs/dvina-mcp/overview)
- [Úkoly](/docs/use-dvina/features/tasks)
- [Přehled konektorů](/docs/connectors/overview)