# dvina əmrindən istifadə edin

> Dvina sizin üçün kod icra edərkən dvina əmrinin nə etdiyini, hansı əmrləri dəstəklədiyini və hansılarının təsdiqinizi tələb etdiyini öyrənin.

Dvina sizin üçün kod və ya əmrlər icra edərkən öz əmrindən istifadə edir: `dvina`. Bu əmrlə skript və ya ardıcıl bir neçə addım sizin adınızdan Dvina-nızda axtarış edə, sənədləri, yaddaşı və tapşırıqları oxuya və əlavə edə, həmçinin elementə kimlərin giriş icazəsi olduğunu yoxlaya bilər.

Heç nə quraşdırmaq və ya hesaba daxil olmaq lazım deyil. Sorğunuz tələb etdikdə Dvina bu əmrdən istifadə edir. Siz də bunu istəyə bilərsiniz, məsələn: "Tapşırıqlarımı siyahıya almaq və xülasəni qeyd kimi yazmaq üçün dvina-dan istifadə et."

## Necə işləyir

- `dvina` sizin Dvina-nızda, sizin adınızdan, rolunuzun icazələri və adi limitləriniz daxilində işləyir.
- Onun giriş icazəsi yalnız Dvina sorğunuz üzərində işlədiyi müddətdə qüvvədə olur. Cavab tamamlandıqda əmr artıq Dvina-nıza daxil ola bilmir.
- Fayl və ya qovluğu yalnız əmrdə adı göstərildikdə oxuyur, məsələn, yüklənəcək faylı.

## Əmrlər

Əmrlər qruplara bölünür: `dvina <group> <command>`, ardınca isə əmrin arqumentləri və bayraqları gəlir.

| Qrup      | Əmrlər                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: söhbətlərinizdə, sənədlərinizdə, yaddaşınızda və dünyanızda eyni anda axtarış edin.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: yaddaş fayllarınızı siyahıya alın, oxuyun, əlavə edin və ya dəyişdirin.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: mövzularınız, Dvina-nın bir şey haqqında bildikləri və Feed-iniz.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: Library-dəki sənəd və qovluqlarınız. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: canvas səhifələrini siyahıya alın, oxuyun, yaradın və ya yenidən yazın.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: arxa planda işləyən tapşırıqlarınız.                                                        |
| `goals`    | `show`, `start`: məqsədə çatmaq üçün işləyən tapşırıqlar.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: birdəfəlik və ya təkrarlanan planlaşdırılmış mesajlar və xatırlatmalar.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: agentləriniz.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: bacarıqlarınız.                                                                                |
| `projects` | `ls`, `show`: layihələriniz.                                                                                             |
| `settings` | `get`, `set`: yaddaşı aktiv və ya deaktiv etmək kimi seçimləriniz.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: elementə kimlərin giriş icazəsi olduğu, başqalarının sizinlə paylaşdıqları və giriş icazəsinin verilməsi və ya ləğvi.  |

`dvina` heç nəyi həmişəlik silə, açıq linkləri aça, tətbiqləri qoşa və ya ayıra, yaxud inzibatçı və ya ödəniş parametrlərini dəyişdirə bilməz.

### Kömək və çıxış

- `dvina --help` qrupları, `dvina <group> --help` qrupun əmrlərini, `dvina <group> <command> --help` isə əmrin arqumentlərini və bayraqlarını siyahıya alır.
- Çıxış qısa mətndir. JSON üçün `--json` əlavə edin. Yalnız bəzi sahələri saxlamaq üçün `--fields` bayrağını vergüllə ayrılmış siyahı ilə əlavə edin, məsələn, `--fields id,title`.
- Uzun siyahı `next: --cursor <c>` ilə bitir. Növbəti səhifəni almaq üçün əmri həmin `--cursor` ilə yenidən icra edin.
- Dəyəri fayldan oxumaq üçün onun bayrağına `-file` əlavə edin, məsələn, `--content-file notes.md`. `dvina docs upload <file>` fayl yükləyir, `dvina skills add <folder>` isə SKILL.md faylı ilə birlikdə bacarıq qovluğu əlavə edir.

### Çıxış kodları

| Kod | Mənası                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Tamamlandı.                                                                         |
| `1`  | Başqa bir xəta baş verdi.                                                    |
| `2`  | Əmr yanlışdır. Onun `--help` məlumatını yoxlayın.                                     |
| `3`  | Tapılmadı.                                                                    |
| `4`  | Rədd edildi: giriş icazəniz, şirkətinizin qaydaları və ya məlumatların qorunması buna icazə vermir. |
| `5`  | Təsdiqiniz tələb olunur.                                                       |
| `6`  | İstifadə limitinizə çatmısınız.                                              |

## Dəyişiklikləri təsdiqləyin

- Oxuma əmrləri sizdən soruşmadan icra olunur.
- `docs create`, `memory add` və ya `tasks start` kimi yeni bir şey əlavə edən əmrlər sizdən soruşmadan icra olunur. Onlar mövcud olanları heç vaxt dəyişdirmir.
- Nəyisə dəyişdirən və ya silən əmrlər əvvəlcə sizdən soruşur: yerini dəyişmək, adını dəyişmək, zibil qutusuna atmaq, qeydi və ya yaddaş faylını əvəz etmək, canvas səhifəsini yenidən yazmaq, agenti və ya bacarığı dəyişdirmək, tapşırığı dayandırmaq, planlaşdırılmış mesajı ləğv etmək və paylaşmaq. Dvina söhbətdə dəyişikliyi öz sözləri ilə xülasə edən təsdiq kartı göstərir və hər dəfə təsdiqinizi istəyir. Rədd etdikdə heç nə dəyişmir.

`dvina` tərəfindən əlavə edilən və ya dəyişdirilənlər, Dvina-nın digər əməliyyatları kimi, şirkətinizin məlumatların qorunması qaydalarına əsasən yoxlanılır və [audit jurnalınızda](/docs/teams/audit-log) qeydə alınır.

## Əlaqəli mövzular

- [MCP ilə digər tətbiqlərdən Dvina-dan istifadə edin](/docs/dvina-mcp/overview)
- [Tapşırıqlar](/docs/use-dvina/features/tasks)
- [Konnektorlara ümumi baxış](/docs/connectors/overview)
