# Gunakan perintah dvina

> Pelajari fungsi perintah dvina saat Dvina menjalankan kode untuk Anda, perintah yang tersedia, dan perintah yang memerlukan persetujuan Anda.

Saat Dvina menjalankan kode atau perintah untuk Anda, Dvina memiliki perintahnya sendiri: `dvina`. Dengan perintah ini, skrip atau beberapa langkah berurutan dapat menelusuri Dvina Anda, membaca dan menambahkan dokumen, memori, dan tugas, serta memeriksa siapa yang memiliki akses ke suatu item, atas nama Anda.

Anda tidak perlu menginstal apa pun atau masuk ke akun. Dvina menggunakan perintah ini saat permintaan Anda membutuhkannya. Anda juga bisa memintanya, misalnya "Gunakan dvina untuk menampilkan daftar tugas saya dan menulis ringkasannya sebagai catatan."

## Cara kerjanya

- `dvina` bekerja pada Dvina Anda sendiri, atas nama Anda, sesuai izin peran Anda dan dalam batas penggunaan yang biasa berlaku.
- Aksesnya hanya berlaku selama Dvina mengerjakan permintaan Anda. Setelah balasan selesai, perintah ini tidak lagi dapat mengakses Dvina Anda.
- Perintah ini hanya membaca file atau folder jika namanya disebutkan dalam perintah, misalnya file yang akan diunggah.

## Perintah

Perintah dibagi menjadi beberapa grup: `dvina <group> <command>`, diikuti argumen dan flag perintah tersebut.

| Grup       | Perintah                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: telusuri percakapan, dokumen, memori, dan dunia Anda sekaligus.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: tampilkan daftar, baca, tambahkan, atau ubah file memori Anda.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: topik Anda, hal yang diketahui Dvina tentang sesuatu, dan Feed Anda.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: dokumen dan folder di Pustaka Anda. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: tampilkan daftar, baca, buat, atau tulis ulang halaman kanvas.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: tugas latar belakang Anda.                                                        |
| `goals`    | `show`, `start`: tugas yang dikerjakan untuk mencapai suatu tujuan.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: pesan dan pengingat terjadwal, satu kali atau berulang.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: agen Anda.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: keterampilan Anda.                                                                                |
| `projects` | `ls`, `show`: proyek Anda.                                                                                             |
| `settings` | `get`, `set`: preferensi Anda, seperti mengaktifkan atau menonaktifkan memori.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: siapa yang memiliki akses ke suatu item, apa yang dibagikan orang lain kepada Anda, serta pemberian atau pencabutan akses.  |

`dvina` tidak dapat menghapus apa pun secara permanen, membuka tautan publik, menghubungkan atau memutuskan koneksi aplikasi, maupun mengubah pengaturan admin atau penagihan.

### Bantuan dan keluaran

- `dvina --help` menampilkan daftar grup, `dvina <group> --help` menampilkan daftar perintah dalam suatu grup, dan `dvina <group> <command> --help` menampilkan daftar argumen dan flag suatu perintah.
- Keluaran berupa teks singkat. Tambahkan `--json` untuk mendapatkan JSON, atau `--fields` dengan daftar yang dipisahkan koma, seperti `--fields id,title`, untuk menyertakan hanya bidang tertentu.
- Daftar yang panjang diakhiri dengan `next: --cursor <c>`. Jalankan kembali perintah dengan `--cursor` tersebut untuk mendapatkan halaman berikutnya.
- Untuk membaca nilai dari file, tambahkan `-file` pada flagnya, seperti `--content-file notes.md`. `dvina docs upload <file>` mengunggah file, dan `dvina skills add <folder>` menambahkan folder keterampilan beserta SKILL.md di dalamnya.

### Kode keluar

| Kode | Arti                                                                          |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Selesai.                                                                         |
| `1`  | Terjadi kesalahan lain.                                                    |
| `2`  | Perintah salah. Periksa `--help` untuk perintah tersebut.                                     |
| `3`  | Tidak ditemukan.                                                                    |
| `4`  | Ditolak: hak akses Anda, aturan perusahaan Anda, atau perlindungan data tidak mengizinkannya. |
| `5`  | Memerlukan persetujuan Anda.                                                       |
| `6`  | Anda telah mencapai batas penggunaan.                                              |

## Setujui perubahan

- Perintah untuk membaca dijalankan tanpa meminta persetujuan.
- Perintah yang menambahkan sesuatu yang baru, seperti `docs create`, `memory add`, atau `tasks start`, dijalankan tanpa meminta persetujuan. Perintah ini tidak pernah mengubah apa yang sudah ada.
- Perintah yang mengubah atau menghapus sesuatu meminta persetujuan Anda terlebih dahulu: memindahkan, mengganti nama, memindahkan ke sampah, mengganti catatan atau file memori, menulis ulang halaman kanvas, mengubah agen atau keterampilan, menghentikan tugas, membatalkan pesan terjadwal, dan berbagi. Dvina menampilkan kartu persetujuan dalam percakapan dengan ringkasan perubahan yang dibuatnya sendiri, dan selalu meminta persetujuan setiap kali. Jika Anda menolaknya, tidak ada yang berubah.

Apa pun yang ditambahkan atau diubah oleh `dvina` melalui pemeriksaan aturan perlindungan data perusahaan Anda dan dicatat dalam [log audit](/docs/teams/audit-log) Anda, sama seperti tindakan Dvina lainnya.

## Terkait

- [Gunakan Dvina dari aplikasi lain dengan MCP](/docs/dvina-mcp/overview)
- [Tugas](/docs/use-dvina/features/tasks)
- [Ikhtisar konektor](/docs/connectors/overview)