# Rychlý start

> Spusťte vydané TUI proti vlastním nástrojům, nejdřív ve stínovém režimu. Každý přepis v těchto ukázkách je ukázkový výstup.

Reading time: 10 min. Source: https://www.voidagent.tech/cs/docs/quickstart

Verze 1.0.1. TUI a MCP server jsou vydané. Desktopová aplikace je v betě pro macOS, Windows a iOS, na pozvánku. Tento návod sleduje TUI, tedy plochu, kterou si spustíte sami.

Než cokoli: Node.js 24 nebo novější a klon produktového repozitáře. VOID není publikovaný v registru balíčků: balíčky uvnitř jsou soukromé ve verzi 0.1.0 a spouští se z klonu. Příručka, která dokumentuje produkt, se vede s produktem a není zveřejněná, takže tato stránka vás na ni nemůže odkázat a ani se s ní nemůže porovnat. Když se rozcházejí, pravdu má produkt a tato stránka je souhrn psaný někým, kdo ho čte zvenčí.

## 1. Vyberte si plochu

```shell
# lokální terminálová pracovní plocha, kterou tento návod sleduje
pnpm install --frozen-lockfile
pnpm tui

# agentová aplikace
pnpm gui

# nativní desktopová aplikace, která si nese vlastní Node a backend
pnpm desktop:setup && pnpm desktop
```

- **TUI** — Živá lokální terminálová pracovní plocha. Chat, dokumenty, přezkoumané Undo, podepsané ledgery a politika běží na skutečných lokálních datech. Na macOS udělá totéž VOID.command dvojklikem.
- **Agentová aplikace** — Agentová aplikace. V Nastavení připojte poskytovatele a vyberte model; spravované dokumenty a zachycené Undo fungují bez samostatného tool serveru.
- **Desktop** — Nativní desktopová aplikace. Balíček si nese vlastní Node a backend. macOS 13.5 nebo novější.
- Hotovo a vydáno. MCP server s nástrojem VOID připraveným k registraci u agentů, kteří volají nástroje. Zaregistrujte MCP server a nástroj VOID u agenta, který už volá vaše nástroje.

> Desktopová aplikace je pro macOS, Windows a iOS. Linuxová verze není a žádný slib v tomto směru neexistuje.

> Produkt je ve verzi 1.0.1. Balíčky uvnitř jeho repozitáře jsou soukromé, ve verzi 0.1.0, a nepublikované. Import na začátku této ukázky pojmenovává balíček uvnitř produktového repozitáře, ve verzi 0.1.0, který je soukromý a nepublikovaný. Vyřeší se z klonu toho repozitáře a nedá se nainstalovat z registru, takže ukázka ukazuje tvar, ne řádek, který by se dal překopírovat. Produkt a jeho dokumentace se vedejí spolu a nejsou zveřejněné, takže tato stránka je souhrn psaný zvenčí, ne kopie jednoho z nich.

## 2. Stínový režim

> Stínový režim nikdy neblokuje volání. Zaznamenává záměr, vypočítá třídu a sestaví plán kompenzace, takže máte skutečný obraz své expozice dřív, než začnete cokoli vynucovat.

```agent.ts
import { void_ } from "@void/sdk";
import { myTools } from "./tools";

const tools = void_.wrap(myTools, {
  mode: "shadow",                // record only, hold nothing
  policy: "./void.policy.ts",
  ledger: { sink: "file://./ledger", sign: true },
});

export const agent = createAgent({ tools });
```

## 3. Sledujte běh

```shell
$ void watch --agent billing-ops
  [09:14:02] intent    issue_refund(ch_3P9k, 4200 EUR)
  [09:14:02] preflight blast radius: 1 payment, 1 ledger row, 1 email
  [09:14:02] class     R3  irreversible
  [09:14:02] policy    SHADOW, would have held
  [09:14:03] commit    ok, sealed 0x9f3c..a10e
```

## 4. Přečtěte si report za první týden

Po několika dnech stínového režimu vám report řekne, kolik nevratných akcí vaši agenti opravdu podnikají. Z toho čísla se staví vaše první skutečná politika.

```shell
$ void report --since 7d
  zachyceno           18 422 volání
  vratné (R0/R1)      13 517  73.4 %
  zmírnitelné (R2)    3 908  21.2 %
  nevratné (R3)       997  5.4 %
  zadrženo            211 volání napříč 4 nástroji
```

## 5. Zapněte vynucování

Až budete připraveni, změňte režim na enforce. Držení a veta politiky se stanou skutečnými a rozpočty nevratnosti se začnou počítat.

```agent.ts
const tools = void_.wrap(myTools, {
  mode: "enforce",
  policy: "./void.policy.ts",
  budget: { irreversible: 2 },
  ledger: { sink: "s3://acme-void-ledger", sign: true },
});
```

## Další

- [Přečtěte si o MCP serveru](/cs/docs/mcp-proxy): pokud váš agent volá nástroje přes MCP.
- [Přečtěte si referenci jazyka politiky](/cs/docs/policy): když budete psát první pravidla.
- [Přečtěte si formát ledgeru](/cs/docs/ledger): když potřebujete export pro audit.
- [Přečtěte si specifikaci](/cs/spec): pro úplný model událostí.

---

This document is the markdown form of https://www.voidagent.tech/cs/docs/quickstart, published for agents that read
text rather than a rendered page. It is generated from the same data the page
renders, so the two cannot disagree.