Dvina MCP

A dvina parancs használata

Ismerd meg, mire szolgál a dvina parancs, amikor Dvina kódot futtat neked, milyen parancsai vannak, és melyekhez kell a jóváhagyásod.

Amikor Dvina kódot vagy parancsokat futtat neked, egy saját parancsot is használhat: dvina. Ezzel egy szkript vagy néhány egymást követő lépés a nevedben kereshet a Dvina-tartalmaid között, olvashat és hozzáadhat dokumentumokat, emlékeket és feladatokat, valamint ellenőrizheti, ki fér hozzá egy elemhez.

Nem kell semmit telepítened, és bejelentkezned sem kell. Dvina akkor használja a parancsot, ha a kérésedhez szükség van rá, de külön is kérheted, például így: „A dvina segítségével listázd a feladataimat, és írd meg az összefoglalójukat egy jegyzetben.”

Hogyan működik?

  • A dvina a saját Dvina-környezetedben, a nevedben működik, a szerepköröd által engedélyezett műveletekkel és a szokásos korlátaidon belül.
  • Csak addig fér hozzá, amíg Dvina a kéréseden dolgozik. Amint a válasz véget ér, a parancs már nem fér hozzá a Dvina-környezetedhez.
  • Csak akkor olvas be egy fájlt vagy mappát, ha egy parancs megnevezi azt, például egy feltöltendő fájlt.

Parancsok

A parancsok csoportokba rendeződnek: dvina <group> <command>, majd a parancs argumentumai és kapcsolói következnek.

Csoport Parancsok
search dvina search <query>: keresés egyszerre a beszélgetéseid, dokumentumaid, emlékeid és világod tartalmai között.
memory ls, show, add, edit: memóriafájljaid listázása, olvasása, hozzáadása vagy módosítása.
world topics, topic, recall, feed: a témáid, Dvina ismeretei egy adott dologról és a Feed tartalmaid.
docs ls, show, read, search, create, upload, update, mv, mkdir, rm: a Library dokumentumai és mappái.
canvas ls, show, create, write-page: vászonoldalak listázása, olvasása, létrehozása vagy újraírása.
tasks ls, show, start, continue, stop: a háttérben futó feladataid.
goals show, start: egy cél elérésén dolgozó feladatok.
schedule ls, add, cancel: egyszeri vagy ismétlődő ütemezett üzenetek és emlékeztetők.
agents ls, show, create, update: az ügynökeid.
skills ls, show, add, edit: a készségeid.
projects ls, show: a projektjeid.
settings get, set: a beállításaid, például a memória be- vagy kikapcsolása.
share state, with-me, add, rm: ki fér hozzá egy elemhez, mit osztottak meg veled mások, valamint hozzáférés megadása vagy visszavonása.

A dvina nem tud semmit véglegesen törölni, nyilvános linkeket megnyitni, alkalmazásokat csatlakoztatni vagy leválasztani, illetve adminisztrátori vagy számlázási beállításokat módosítani.

Súgó és kimenet

  • A dvina --help a csoportokat, a dvina <group> --help egy csoport parancsait, a dvina <group> <command> --help pedig egy parancs argumentumait és kapcsolóit listázza.
  • A kimenet rövid szöveg. JSON-kimenethez add hozzá a --json kapcsolót, vagy csak bizonyos mezők megtartásához használd a --fields kapcsolót egy vesszőkkel elválasztott listával, például így: --fields id,title.
  • A hosszú listák végén a next: --cursor <c> jelenik meg. A következő oldal lekéréséhez futtasd újra a parancsot ezzel a --cursor kapcsolóval.
  • Ha egy értéket fájlból szeretnél beolvasni, egészítsd ki a hozzá tartozó kapcsolót a -file utótaggal, például így: --content-file notes.md. A dvina docs upload <file> feltölt egy fájlt, a dvina skills add <folder> pedig hozzáad egy készségmappát a benne lévő SKILL.md fájllal együtt.

Kilépési kódok

Kód Jelentés
0 Kész.
1 Egyéb hiba történt.
2 Hibás a parancs. Nézd meg a --help súgóját.
3 Nem található.
4 Elutasítva: a hozzáférési jogosultságod, a vállalatod szabályai vagy az adatvédelem nem engedik.
5 A jóváhagyásodra van szükség.
6 Elérted a használati korlátodat.

Módosítások jóváhagyása

  • Az olvasási parancsok jóváhagyás kérése nélkül futnak.
  • Az új elemeket hozzáadó parancsok, például a docs create, a memory add vagy a tasks start, jóváhagyás kérése nélkül futnak. A meglévő tartalmakat soha nem módosítják.
  • A módosító vagy eltávolító parancsok előbb megkérdezik, hogy jóváhagyod-e a műveletet: ilyen az áthelyezés, az átnevezés, a kukába helyezés, egy jegyzet vagy memóriafájl lecserélése, egy vászonoldal újraírása, egy ügynök vagy készség módosítása, egy feladat leállítása, egy ütemezett üzenet törlése és a megosztás. Dvina egy jóváhagyási kártyát jelenít meg a beszélgetésben a módosítás saját összefoglalójával, és minden alkalommal jóváhagyást kér. Ha elutasítod, semmi sem változik.

A dvina által hozzáadott vagy módosított tartalmakra a vállalatod adatvédelmi szabályai vonatkoznak, és a műveletek bekerülnek az auditnaplódba, ugyanúgy, mint Dvina többi művelete.