وقتی Dvina برای شما کد یا دستور اجرا می‌کند، دستور اختصاصی خودش را دارد: dvina. با این دستور، یک اسکریپت یا چند مرحلهٔ پیاپی می‌تواند با هویت شما در Dvina جست‌وجو کند، سندها، حافظه و وظایف را بخواند و اضافه کند، و بررسی کند چه کسانی به یک مورد دسترسی دارند.
نیازی به نصب چیزی یا ورود به حساب نیست. هر وقت درخواست شما به این دستور نیاز داشته باشد، Dvina از آن استفاده می‌کند. خودتان هم می‌توانید چنین درخواستی کنید، مثلاً: «با dvina وظایف من را فهرست کن و خلاصه‌ای از آن‌ها را به‌صورت یادداشت بنویس.»
نحوهٔ کار
dvinaدر Dvina شما و با هویت شما کار می‌کند، در چارچوب مجوزهای نقش شما و محدودیت‌های معمولتان.- دسترسی آن فقط تا زمانی برقرار است که Dvina روی درخواست شما کار می‌کند. با پایان پاسخ، دستور دیگر به Dvina شما دسترسی ندارد.
- فقط زمانی یک فایل یا پوشه را می‌خواند که نام آن در یک دستور آمده باشد، مثلاً فایلی که قرار است بارگذاری شود.
دستورها
دستورها گروه‌بندی شده‌اند: dvina <group> <command> و سپس آرگومان‌ها و پرچم‌های آن دستور.
| گروه | دستورها |
|---|---|
search |
dvina search <query>: جست‌وجوی هم‌زمان در گفت‌وگوها، سندها، حافظه و دنیای شما. |
memory |
ls, show, add, edit: فهرست کردن، خواندن، افزودن یا تغییر فایل‌های حافظهٔ شما. |
world |
topics, topic, recall, feed: موضوع‌های شما، آنچه Dvina دربارهٔ چیزی می‌داند و خوراک شما. |
docs |
ls, show, read, search, create, upload, update, mv, mkdir, rm: سندها و پوشه‌های کتابخانهٔ شما. |
canvas |
ls, show, create, write-page: فهرست کردن، خواندن، ساختن یا بازنویسی صفحه‌های بوم. |
tasks |
ls, show, start, continue, stop: وظایف پس‌زمینهٔ شما. |
goals |
show, start: وظایفی که برای رسیدن به یک هدف انجام می‌شوند. |
schedule |
ls, add, cancel: پیام‌ها و یادآوری‌های زمان‌بندی‌شده، یک‌باره یا تکرارشونده. |
agents |
ls, show, create, update: عامل‌های شما. |
skills |
ls, show, add, edit: مهارت‌های شما. |
projects |
ls, show: پروژه‌های شما. |
settings |
get, set: تنظیمات ترجیحی شما، مانند روشن یا خاموش کردن حافظه. |
share |
state, with-me, add, rm: چه کسانی به یک مورد دسترسی دارند، دیگران چه چیزهایی با شما به اشتراک گذاشته‌اند و دادن یا حذف دسترسی. |
dvina نمی‌تواند چیزی را برای همیشه حذف کند، پیوندهای عمومی را باز کند، برنامه‌ها را متصل کند یا اتصالشان را قطع کند، یا تنظیمات مدیریتی یا صورت‌حساب را تغییر دهد.
راهنما و خروجی
dvina --helpگروه‌ها را فهرست می‌کند،dvina <group> --helpدستورهای یک گروه را فهرست می‌کند وdvina <group> <command> --helpآرگومان‌ها و پرچم‌های یک دستور را فهرست می‌کند.- خروجی، متنی کوتاه است. برای دریافت JSON،
--jsonرا اضافه کنید. برای نگه داشتن فقط بعضی فیلدها،--fieldsرا همراه با فهرستی که با ویرگول جدا شده است اضافه کنید، مانند--fields id,title. - فهرست‌های طولانی با
next: --cursor <c>تمام می‌شوند. برای دریافت صفحهٔ بعد، دستور را دوباره با همان--cursorاجرا کنید. - برای خواندن یک مقدار از فایل،
-fileرا به پرچم آن اضافه کنید، مانند--content-file notes.md. دستورdvina docs upload <file>یک فایل را بارگذاری می‌کند وdvina skills add <folder>یک پوشهٔ مهارت را همراه با فایل SKILL.md آن اضافه می‌کند.
کدهای خروج
| کد | معنی |
|---|---|
0 |
انجام شد. |
1 |
خطای دیگری رخ داده است. |
2 |
دستور نادرست است. --help آن را بررسی کنید. |
3 |
پیدا نشد. |
4 |
رد شد: سطح دسترسی شما، قوانین شرکت یا حفاظت از داده‌ها اجازهٔ انجام آن را نمی‌دهد. |
5 |
به تأیید شما نیاز دارد. |
6 |
به سقف مصرف خود رسیده‌اید. |
تأیید تغییرات
- دستورهایی که اطلاعات را می‌خوانند، بدون پرسیدن از شما اجرا می‌شوند.
- دستورهایی که چیز جدیدی اضافه می‌کنند، مانند
docs create،memory addیاtasks start، بدون پرسیدن از شما اجرا می‌شوند. این دستورها هرگز محتوای موجود را تغییر نمی‌دهند. - دستورهایی که چیزی را تغییر می‌دهند یا حذف می‌کنند، ابتدا از شما تأیید می‌گیرند: جابه‌جایی، تغییر نام، انتقال به سطل زباله، جایگزینی یک یادداشت یا فایل حافظه، بازنویسی یک صفحهٔ بوم، تغییر یک عامل یا مهارت، توقف یک وظیفه، لغو یک پیام زمان‌بندی‌شده و اشتراک‌گذاری. Dvina یک کارت تأیید در گفت‌وگو نشان می‌دهد که شامل خلاصه‌ای از تغییر به بیان خود Dvina است و هر بار از شما تأیید می‌خواهد. اگر آن را رد کنید، هیچ چیز تغییر نمی‌کند.
هر چیزی که dvina اضافه می‌کند یا تغییر می‌دهد، مانند دیگر اقدام‌های Dvina، از بررسی‌های حفاظت از داده‌های شرکت شما می‌گذرد و در گزارش حسابرسی شما ثبت می‌شود.