Reference nástrojů MCP

Při úspěchu každý nástroj kromě get-screen-image vrací svůj výsledek dvakrát: jako structuredContent (ověřený podle publikovaného výstupního schématu nástroje) a jako stejný objekt serializovaný do textového bloku { type: "text", text: "<json-string>" } pro klienty, které strukturovaný obsah nečtou. get-screen-image vrací pouze blok obrázku MCP: { type: "image", data: "<base64>", mimeType: "image/png" }. Při selhání je nastaven isError: true a textový blok obsahuje krátkou chybovou zprávu. Chyby, na které můžete reagovat (nesoulad názvu při mazání, neplatný odkaz na Figmu, neplatné designové pokyny, problém s přílohou nebo vypršení časového limitu generace), vysvětlují, co opravit. Ostatní selhání vracejí obecnou zprávu, například Failed to list files.

Ceny: tři nástroje AI pro design, tedy ai-design-screens, ai-generate-screen-variant a ai-edit-screen-variant, čerpají ze stejného limitu zpráv jako aplikace Flowstep. Všechny ostatní nástroje jsou zdarma. Viz Limity použití.

Každý nástroj také publikuje anotace MCP, aby váš klient věděl, co dělá. delete-file, delete-screen, delete-design-guidelines, replace-screen-jsx, ai-design-screens a ai-edit-screen-variant jsou označeny jako destruktivní, protože odstraňují nebo přepisují existující obsah.

Nástroje pro soubory

`list-files`

Vypíše metadata vašich souborů Flowstep. Zavolejte tento nástroj nejdřív, abyste zjistili, zda už existuje relevantní soubor. Nevrací obsah obrazovek. K tomu použijte get-screen-image nebo get-screen-jsx. Vstup

Parametr	Typ	Výchozí	Popis
`orderByCreation`	`boolean`	`true`	Řazení od nejnovějších podle `created_at` (`true`), nebo podle `updated_at` (`false`). Použijte `false`, chcete-li najít nedávno upravené soubory
`limit`	`integer` (1–100)	`20`	Maximální počet vrácených souborů. Plná stránka může znamenat, že existují další soubory
`offset`	`integer` (≥0)	`0`	Počet souborů, které se přeskočí. Další stránka je `offset + limit`

Výstup — { files }.

{
  "files": [
    {
      "id": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
      "name": "Dashboard redesign",
      "created_at": "2026-04-30T15:02:13.120152+00:00",
      "updated_at": "2026-04-30T15:02:13.120152+00:00",
      "organisation_id": "0b7f3c9e-2d4a-4f1b-9a5e-6c8d7e1f2a3b",
      "shared_with_me": false,
      "owner": true,
      "url": "https://app.flowstep.ai/file?activeFileId=5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0"
    }
  ]
}

owner — true, pokud jste soubor vytvořili.
shared_with_me — true, pokud byl soubor sdílen přímo s vámi, nejen prostřednictvím vaší organizace.
url — otevře soubor v editoru Flowstepu.

`get-file`

Získá metadata jednoho souboru. Obsah souboru je záměrně vynechán. K prohlížení obrazovek použijte get-screen-image nebo get-screen-jsx a k načtení připojených pokynů get-design-guidelines. Pokud máte čekající pozvánku k souboru, volání get-file ji přijme. Vstup

Parametr	Typ	Popis
`id`	`uuid`	ID souboru

Výstup — { file, user_access_level }.

{
  "file": {
    "id": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
    "name": "Dashboard redesign",
    "created_at": "2026-04-30T15:02:13.120152+00:00",
    "updated_at": "2026-04-30T15:02:13.120152+00:00",
    "project_id": "81cb84d6-c69f-492c-a895-7421b60d1a6d",
    "access_level": "private",
    "visibility": "private",
    "owner": true,
    "url": "https://app.flowstep.ai/file?activeFileId=5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0"
  },
  "user_access_level": "write"
}

access_level — private, read nebo write.
visibility — private, member nebo public.
user_access_level — vaše přístupová úroveň k souboru: read nebo write.

`create-file`

Vytvoří prázdný soubor Flowstepu bez obrazovek. Chcete-li vytvořit soubor a vygenerovat obrazovky v jednom kroku, zavolejte místo toho ai-design-screens bez fileId. Nástroj create-file použijte u pracovních postupů založených na kódu, po kterých následuje add-screen-jsx. Vstup

Parametr	Typ	Popis
`name`	`string` (min 1)	Zobrazovaný název nového souboru

Výstup — { file, user_access_level }, ve stejném tvaru jako get-file. owner je vždy true a user_access_level je vždy write. Vrácené file.id použijte jako fileId v dalších voláních nástrojů.

`update-file`

Přejmenuje soubor. Vstup

Parametr	Typ	Popis
`id`	`uuid`	ID souboru
`name`	`string` (min 1)	Nový zobrazovaný název

Výstup — { file, user_access_level }, ve stejném tvaru jako get-file.

`delete-file`

Trvale smaže soubor. Hodnota name, kterou předáte, se před smazáním porovná s aktuálním zobrazovaným názvem souboru. Pokud se neshoduje, smazání se zruší. Tím se zabrání náhodnému smazání nesprávného souboru. Agenti mají pokyn, aby vás nejdřív požádali o potvrzení. Vstup

Parametr	Typ	Popis
`id`	`uuid`	ID souboru
`name`	`string`	Aktuální zobrazovaný název souboru. Musí se shodovat, jinak se smazání zruší

Výstup — { "deleted": true }

Tuto akci nelze vrátit zpět. Všechny obrazovky v souboru se smažou.

Nástroje pro obrazovky

`list-screens`

Vypíše obrazovky v souboru v pořadí na plátně. Zavolejte tento nástroj po list-files, abyste viděli, co už soubor obsahuje. Vrácené hodnoty screenId použijte s ostatními nástroji pro obrazovky a s nástroji AI pro design. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru

Výstup — { screens }.

{
  "screens": [
    {
      "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe",
      "name": "Mobile login screen",
      "prompt": "Generate a simple mobile login screen with email and password fields and a sign in button",
      "fidelity": "ui"
    }
  ]
}

prompt — poslední prompt generace pro danou obrazovku, nebo prázdný řetězec, pokud nikdy nebyla vygenerována (například obrazovka přidaná přes add-screen-jsx).
fidelity — lofi, hifi nebo ui.

`get-screen-image`

Vykreslí obrazovku do PNG a vrátí ji jako vložený obrázek. Vyžaduje klienta, který podporuje bloky obrázků. Zavolejte jej jednou pro každé screenId, které vrátil nástroj AI pro design, add-screen-jsx, replace-screen-jsx nebo import-figma. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru
`screenId`	`uuid`	`screenId` z `list-screens` nebo z pole `screenIds`, které vrátil nástroj AI pro design

Výstup — blok obrázku MCP (image/png). data je standardní base64 bajtů PNG, nikoli data URI. Pro tento nástroj neexistuje structuredContent.

`get-screen-jsx`

Získá obrazovku jako JSX spolu s jejími metadaty, takže z ní můžete stavět ve svém kódu, nebo ji upravit a zapsat zpět přes replace-screen-jsx. Pro vizuální náhled místo toho použijte get-screen-image. Vstup

Parametr	Typ	Výchozí	Popis
`fileId`	`uuid`	—	ID souboru
`screenId`	`uuid`	—	`screenId` z `list-screens` nebo z pole `screenIds`, které vrátil nástroj AI pro design
`includeIds`	`boolean`	`false`	Zahrne atribut `data-id` na prvcích v `jsx`. Použijte jej, když potřebujete ID prvků předat jako `elementIds` do `ai-design-screens`, buď k úpravě na místě, nebo jako vizuální referenci

Výstup — { fileId, screenId, name, prompt, fidelity, screenType, colorTheme, jsx, fragments }.

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenId": "c13d3707-0efe-49f5-b6cb-0ca5ac5223d0",
  "name": "World clock",
  "prompt": "A world clock screen with a city search and alert button",
  "fidelity": "ui",
  "screenType": "iphone-x-vertical",
  "colorTheme": "blue",
  "jsx": "<div className=\"bg-white text-zinc-950 w-full h-fit\">\n  <div className=\"flex p-6 flex-col gap-6\">\n    …\n  </div>\n</div>",
  "fragments": []
}

jsx — pouze značkování. Atributy data-id jsou zahrnuty, jen pokud je includeIds nastaveno na true.
prompt — poslední prompt generace, nebo prázdný řetězec, pokud nebyla obrazovka nikdy vygenerována.
fragments — sdílené prvky uložené na obrazovce, například navigační lišta, záhlaví nebo logo, jako objekty { purpose, markup }. Pokud žádné nejsou, je pole prázdné. Předejte je zpět do replace-screen-jsx, abyste je zachovali nebo aktualizovali.

Hodnoty fidelity, screenType a colorTheme najdete v části Hodnoty polí obrazovky.

`add-screen-jsx`

Přidá do souboru novou obrazovku z JSX, který jste napsali. Jde o cestu založenou na kódu a je zdarma. Pokud chcete, aby Flowstep navrhl obrazovku pomocí AI, použijte ai-design-screens. add-screen-jsx vždy vytvoří novou obrazovku. Chcete-li přepsat existující, použijte replace-screen-jsx. Pokud je nová obrazovka založená na existující, začněte u get-screen-jsx (bez includeIds) pro hodnoty name, fidelity, screenType, colorTheme a jsx a poté změňte to, co se má lišit. Chcete-li zobrazit nahraný obrázek, viz Obrázky v JSX. Vstup

Parametr	Typ	Výchozí	Popis
`fileId`	`uuid`	—	ID souboru
`name`	`string` (1–100 znaků)	—	Volitelný zobrazovaný název. Pokud jej vynecháte, obrazovka dostane automatický název `Screen N`
`fidelity`	`string`	`"ui"`	Věrnost obrazovky
`screenType`	`string`	—	Povinné: zařízení nebo výřez, pro který je obrazovka navržena
`colorTheme`	`string`	`"default"`	Barevný motiv
`jsx`	`string`	—	Pouze značkování JSX. Atributy `data-id` se ignorují, protože nová obrazovka dostane nová ID prvků

Výstup — { fileId, screenId }. Zavolejte get-screen-image s screenId, abyste viděli výsledek.

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbf"
}

`replace-screen-jsx`

Přepíše existující obrazovku pomocí JSX, který jste napsali. Obrazovka si ponechá své screenId i pozici na plátně. Vnořené prvky dostanou nová ID. Jde o cestu založenou na kódu a je zdarma. Pro změny pomocí AI použijte ai-design-screens nebo ai-edit-screen-variant, a chcete-li místo toho vytvořit novou obrazovku, použijte add-screen-jsx. Začněte u get-screen-jsx (bez includeIds) a poté změňte to, co se má lišit. Chcete-li zobrazit nahraný obrázek, viz Obrázky v JSX. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru
`screenId`	`uuid`	Obrazovka, která se má přepsat
`jsx`	`string`	Pouze značkování JSX. Atributy `data-id` se ignorují
`name`	`string` (1–100 znaků)	Volitelné. Pokud jej vynecháte, zachová se aktuální název
`fidelity`	`string`	Volitelné. Pokud jej vynecháte, zachová se aktuální věrnost
`screenType`	`string`	Volitelné. Pokud jej vynecháte, zachová se aktuální typ obrazovky
`colorTheme`	`string`	Volitelné. Pokud jej vynecháte, zachová se aktuální barevný motiv
`fragments`	`{ purpose, markup }[]`	Volitelné sdílené prvky z `get-screen-jsx`. Pokud jej vynecháte, zachovají se aktuální fragmenty. Předáním `[]` je vymažete

Výstup — { fileId, screenId }. Zavolejte get-screen-image s screenId, abyste viděli výsledek.

Tím se obsah obrazovky nahradí na místě.

`rename-screen`

Přejmenuje popisek obrazovky na plátně, tedy název, který se zobrazuje v list-screens a v editoru. Mění pouze popisek, nikoli rozvržení, velikost nebo obsah obrazovky. K těmto změnám použijte ai-design-screens. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru
`screenId`	`uuid`	`screenId` vrácené z `list-screens`
`name`	`string` (1–100 znaků)	Nový název obrazovky. Úvodní a koncové mezery se odstraní

Výstup — { screenId, name }.

{ "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe", "name": "Checkout — empty cart" }

`delete-screen`

Trvale smaže obrazovku ze souboru. Hodnota name, kterou předáte, se porovná s aktuálním zobrazovaným názvem obrazovky. Pokud se neshoduje, smazání se zruší. Agenti mají pokyn, aby vás nejdřív požádali o potvrzení. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru
`screenId`	`uuid`	Obrazovka, která se má smazat
`name`	`string`	Aktuální zobrazovaný název obrazovky. Musí se shodovat, jinak se smazání zruší

Výstup — { "deleted": true }

Obrázky v JSX

add-screen-jsx a replace-screen-jsx přijímají obrázky v src elementu img, nebo jako pozadí v className pomocí bg-[url(...)]. Napište text alt a každý obrázek přizpůsobte jeho účelu. Chcete-li na obrazovku umístit vlastní obrázek:

Nahrajte jej pomocí upload-attachment v režimu A (mimeType + fileName) a spusťte vrácený uploadCommand.
Pokud má odpověď type hodnotu "image", vložte její assetUrl přesně tak, jak byla vrácena, do img src nebo bg-[url(assetUrl)].

Všechny ostatní URL obrázků ponechte přesně tak, jak je vrátil get-screen-jsx. Do src nevkládejte path, signedUrl ani uploadCommand.

<img src="ASSET_URL" alt="Team photo" className="w-full h-48 object-cover rounded-lg" />

Hodnoty polí obrazovky

get-screen-jsx tyto hodnoty vrací a add-screen-jsx a replace-screen-jsx je přijímají:

Pole	Hodnoty
`fidelity`	`lofi`, `hifi`, `ui`
`screenType`	`web`, `desktop`, `desktop-large`, `desktop-medium`, `desktop-small`, `tablet`, `ipad-tablet-horizontal`, `ipad-tablet-vertical`, `android-tablet-horizontal`, `android-tablet-vertical`, `mobile_ios`, `mobile_android`, `iphone-vertical`, `iphone-horizontal`, `iphone-x-vertical`, `iphone-x-horizontal`, `android-vertical`, `android-horizontal`, `android-small-vertical`, `android-small-horizontal`
`colorTheme`	`default`, `defaultDark`, `blue`, `blueDark`, `ice`, `iceDark`, `grayscale`, `grayscaleDark`, `green`, `greenDark`, `orange`, `orangeDark`, `red`, `redDark`, `rose`, `roseDark`, `violet`, `violetDark`, `yellow`, `yellowDark`

Nástroje pro designové pokyny

Designové pokyny jsou text DESIGN.md uložený u souboru. Když jsou nastaveny, vkládají se do každé generace AI pro daný soubor. Viz Designové pokyny.

`get-design-guidelines`

Získá designové pokyny připojené k souboru. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru

Výstup — { guidelines }.

{
  "guidelines": "## Colors\n\nPrimary: #6366F1\nBackground: #FFFFFF\n\n## Typography\n\nFont: Inter"
}

guidelines je null, pokud nebyly nastaveny žádné designové pokyny.

`update-design-guidelines`

Nastaví nebo nahradí designové pokyny souboru. Pokyny předejte jako prostý řetězec ve formátu DESIGN.md od Google, nikoli jako objekt nebo JSON. Pokud čtete ze souboru, předejte jeho text. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru
`designGuidelines`	`string` (min 1)	Surový text pokynů. Musí být prostý řetězec, ne JSON zakódovaný do řetězce

Pravidla ověřování

Frontmatter musí být správně otevřen a uzavřen
Řádky frontmatteru musí být platným YAML ve stylu bloku
Tělo Markdownu nesmí obsahovat duplicitní nadpisy sekcí ##

Pokud ověření selže, volání vrátí chybu, která začíná Invalid design guidelines:. Výstup — { updated, warnings? }.

{ "updated": true, "warnings": ["…"] }

warnings obsahuje měkká upozornění na ověření, například neznámé klíče nebo barvy, které nejsou v hex formátu. Tyto pokyny byly přijaty, ale AI je může ignorovat. Pokud žádná nejsou, pole se vynechá. Předejte je uživateli.

`delete-design-guidelines`

Vymaže designové pokyny souboru. Smazání pokynů, které neexistují, nemá žádný efekt. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru

Výstup — { "deleted": true }

Nástroje pro chat

`get-chat-history`

Získá designovou konverzaci přiřazenou k souboru. Jde o chat souboru ve Flowstepu, nikoli o konverzaci vašeho klienta MCP. Použijte jej k navázání na dřívější práci na souboru. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	ID souboru

Výstup — { messages }. Pole messages je prázdné, pokud k souboru nemáte žádnou designovou konverzaci. Každá zpráva má type ("request" nebo "response"), author ("human" nebo "ai") a content_type. Odpovědi používají "text", "summary" nebo "followup".

{
  "messages": [
    {
      "id": "453f593d-2380-425b-ba29-127db08d6a8e",
      "type": "request",
      "status": "success",
      "content": "Generate a simple mobile login screen with email and password fields",
      "author": "human",
      "content_type": "text",
      "sequence": 1,
      "targets": [],
      "attachments": []
    },
    {
      "id": "d860186b-82d5-4bd1-8e8e-8ba5377a14bf",
      "type": "response",
      "status": "success",
      "content": "Generated a mobile login screen with email and password input fields, a sign in button, and a sign up link.",
      "author": "ai",
      "content_type": "summary",
      "sequence": 7,
      "request_message_id": "453f593d-2380-425b-ba29-127db08d6a8e",
      "targets": [{ "target_id": "3f9e6eb6-5525-4383-9375-67e0bd762dbe" }]
    }
  ]
}

Nástroje pro přílohy

`upload-attachment`

Nahrajte referenční soubor, který se použije jako příloha v ai-design-screens, nebo obrázek, který umístíte do vlastního JSX pomocí add-screen-jsx nebo replace-screen-jsx. Nástroje ai-generate-screen-variant a ai-edit-screen-variant přílohy nepřijímají. Bajty souboru nikdy neprojdou modelem a server nikdy nenačítá URL vaším jménem. Chcete-li odkázat na webovou stránku, uveďte místo toho její URL v message nástroje ai-design-screens. Existují dva režimy. Použijte přesně jeden a nekombinujte je. Režim A: soubory a obrázky (mimeType + fileName) Povinný tříkrokový postup pro libovolný obrázek, PDF nebo větší textový soubor:

Zavolejte upload-attachment pouze s mimeType a fileName, například image/png a dog.png. Odpověď je připravené nahrání, nikoli uložený soubor:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "path": "attachments/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "assetUrl": "https://…",
  "type": "image",
  "mimeType": "image/png",
  "signedUrl": "https://…",
  "uploadCommand": "curl -sS -f -X PUT '…' -H 'Content-Type: image/png' -H 'x-metadata: …' --data-binary @LOCAL_FILE_PATH",
  "nextStep": "…"
}

Nahraďte LOCAL_FILE_PATH v uploadCommand absolutní cestou k vašemu souboru a spusťte přesně tento příkaz ve svém shellu. Musí skončit s kódem 0. Token v signedUrl autorizuje pouze toto jedno nahrání. Pokud tento krok přeskočíte, úložiště zůstane prázdné a nástroj AI pro design selže při kontrole před spuštěním.
Do pole attachments nástroje ai-design-screens předejte pouze { id, path, type }, nikoli signedUrl, uploadCommand ani nextStep. Chcete-li místo toho umístit obrázek do vlastního JSX, vložte assetUrl do img src nebo bg-[url(...)] v JSX, který předáte do add-screen-jsx nebo replace-screen-jsx. Viz Obrázky v JSX.

Chcete-li připojit vzdálený soubor, nejdřív si jej stáhněte na místní cestu (například pomocí curl) a poté postupujte stejně. Nikdy nepředávejte URL do upload-attachment.

Parametr	Typ	Popis
`mimeType`	enum	MIME typ souboru. Jeden z `image/jpeg`, `image/png`, `image/webp`, `application/pdf`, `text/markdown`, `text/plain`, `text/javascript`. Pro soubory `.jsx`, `.tsx`, `.js` a `.ts` použijte `text/javascript`
`fileName`	`string` (min 1)	Původní název souboru s příponou, například `cat.png` nebo `design.md`

Režim B: krátký text (text + mimeType) Nahrajte text, který je již v kontextu. Nepotřebujete žádný příkaz shellu. Odpověď je připravena k okamžitému použití:

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "path": "attachments/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "assetUrl": "https://…",
  "type": "document",
  "mimeType": "text/plain"
}

Parametr	Typ	Popis
`text`	`string` (max 64 000 znaků)	Surový textový obsah. Pouze textové soubory, nepoužívejte pro obrázky nebo PDF. Delší než 64 000 znaků? Použijte režim A
`mimeType`	enum	Jeden z `text/markdown`, `text/plain`, `text/javascript`

Výsledné { id, path, type } předejte do pole attachments nástroje ai-design-screens. Maximální velikost souboru je 3 MB v obou režimech a PDF jsou omezena na 100 stránek. Výstup — { id, path, assetUrl, type, mimeType, signedUrl?, uploadCommand?, nextStep? }.

type — "image" pro obrázkové soubory a "document" pro PDF a textové soubory.
assetUrl — URL nahraného souboru, vrácená v obou režimech. V JSX pro add-screen-jsx nebo replace-screen-jsx ji použijte jen tehdy, když je type "image", a až po spuštění uploadCommand z režimu A.
signedUrl, uploadCommand, nextStep — nastaveny pouze v režimu A. Nepředávejte je do nástrojů pro design.

Nástroje pro Figmu

`import-figma`

Importuje rámec Figmy do souboru Flowstepu jako upravitelné prvky na jeho plátně. Každý import přidá novou obrazovku. Import stejného rámce dvakrát tedy vytvoří dvě obrazovky, takže pokud jste chtěli starou nahradit, smažte ji pomocí delete-screen. Organizace, ke které soubor patří, musí mít v nastavení Flowstepu připojenou Figmu. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	Soubor Flowstepu, do kterého se má rámec importovat. Nejde o klíč souboru Figmy v `figmaUrl`
`figmaUrl`	`string`	Odkaz na konkrétní rámec Figmy s `node-id`. V Figmě klikněte pravým tlačítkem na rámec a zvolte Copy/Paste as → Copy link to selection. Odkaz na stránku importuje všechny rámce nejvyšší úrovně na dané stránce (přes MCP omezeno na 20 rámců)

Výstup — { fileId, screenId, frameCount? }. screenId je importovaná obrazovka. Předejte ji do get-screen-image, abyste viděli výsledek. Pokud odkaz na stránku importuje více rámců, screenId je null a místo něj se vrátí frameCount. Zavolejte list-screens a poté get-screen-image pro každou novou obrazovku.

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenId": "3f9e6eb6-5525-4383-9375-67e0bd762dbe"
}

Nástroje pro tarif a fakturaci

`get-plan-details`

Získá tarif vaší organizace Flowstep, stav předplatného, využití a zbývající kvótu. Nepřijímá žádný vstup, organizaci určuje přihlášený uživatel. Použijte jej ke kontrole svého limitu před voláním nástrojů AI pro design. Výstup — { plan, subscription, limits, usage, remaining }.

Pole	Popis
`plan`	`{ name, code, type }`. `type` je `"free"` nebo `"paid"`
`subscription`	`{ isPaid, isTrial, startDate, endDate, trialDaysRemaining }`
`limits`	Limity podle funkce, klíčované podle funkce (například `messages`). Každá má volitelné objekty `daily` a `monthly` s hodnotami `max` a `warn` a příznak `unlimited`
`usage`	Využití funkce zatím, jako `{ daily, monthly }`
`remaining`	Zbývající kvóta funkce, jako `{ daily, monthly }`. U neomezených funkcí se vynechá

Limity se liší podle tarifu. Viz Ceník a Limity použití.

Nástroje AI pro design

Tyto tři nástroje navrhují podle popisu nebo předvolby. Nikdy nepřijímají ani nepoužívají JSX. Každé volání čerpá ze stejného limitu zpráv jako aplikace Flowstep a blokuje se, dokud se generování nedokončí nebo nevyprší časový limit (180 sekund).

Nástroj	Použijte jej k
`ai-design-screens`	Vygenerování nových obrazovek, změně existujících na místě, nebo obojímu, z volného popisu
`ai-generate-screen-variant`	Přidání dalšího kroku, stavu chyby nebo prázdného stavu, případně platformní varianty jedné existující obrazovky
`ai-edit-screen-variant`	Použití předvolby úpravy nebo redesignu na jednu celou existující obrazovku

Všechny tři vracejí { status, fileId, screenIds, designGuidelinesUpdated }. Zavolejte get-screen-image jednou pro každé screenId, abyste viděli výsledek.

designGuidelinesUpdated — krátké shrnutí změny, pokud byly designové pokyny souboru DESIGN.md během tohoto kroku automaticky aktualizovány. Jinak null.

`ai-design-screens`

Vygeneruje jednu nebo více nových obrazovek, změní existující obrazovky na místě, nebo obojí najednou, z textového popisu. Jde o nové toky, motivy, texty, rozvržení a koordinované změny napříč několika obrazovkami. Jde o stejného designového agenta jako chat v editoru Flowstepu: z vaší message a elementIds sám rozhodne, co vytvořit a co změnit. Vynechejte fileId, chcete-li začít nový soubor. Předejte fileId, chcete-li pracovat v existujícím souboru. Pokud se požadavek může týkat souboru, který už máte, měl by váš agent nejdřív zkontrolovat list-files a list-screens. Pro další krok, stav chyby nebo prázdný stav, případně platformní variantu jedné obrazovky použijte ai-generate-screen-variant. Pro předvolbu úpravy nebo redesignu jedné obrazovky použijte ai-edit-screen-variant. Pokud už máte JSX, použijte místo toho add-screen-jsx nebo replace-screen-jsx. Vstup

Parametr	Typ	Výchozí	Popis
`fileId`	`uuid`	—	Cílový soubor. Vynechejte, chcete-li vytvořit nový soubor. Povinné, pokud je nastaveno `elementIds`
`message`	`string`	—	Popis obrazovek, které se mají vygenerovat, a/nebo změn, které se mají provést. Pokud předáváte `elementIds`, uveďte, zda je máte upravit, nebo použít jako referenci. Webové URL, na které se chcete odkazovat, uveďte sem
`elementIds`	`uuid[]`	`[]`	Volitelné `screenId` z `list-screens` a/nebo `data-id` prvků z `get-screen-jsx` (s `includeIds`), podobně jako výběr v editoru. Mohou se upravit na místě, nebo sloužit jako vizuální reference pro nové obrazovky. `screenId` cílí na celou obrazovku
`attachments`	`{ id, path, type }[]` (max 5)	`[]`	Soubory z `upload-attachment`: obrázky, PDF nebo soubory kódu a textu. Nevkládejte obsah souborů do zprávy

Příklad: upravte jednu obrazovku a přidejte další jedním voláním:

{
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "message": "Switch this sign-in screen to dark mode, then add a matching forgot-password screen.",
  "elementIds": ["3f9e6eb6-5525-4383-9375-67e0bd762dbe"]
}

Výstup — { status, fileId, screenIds, designGuidelinesUpdated, reply? }.

{
  "status": "generated",
  "fileId": "5c2170f0-5b09-4a5a-ba7a-4d5c2cfb07e0",
  "screenIds": [
    "3f9e6eb6-5525-4383-9375-67e0bd762dbe",
    "c13d3707-0efe-49f5-b6cb-0ca5ac5223d0"
  ],
  "designGuidelinesUpdated": null
}

status — "generated", pokud byly obrazovky vytvořeny nebo změněny. "chat", pokud Flowstep odpověděl, aniž by cokoli vytvořil. V takovém případě reply obsahuje jeho odpověď a screenIds je prázdné. Pokud je zadání nejednoznačné, váš agent by se vás měl zeptat na upřesnění a nástroj znovu zavolat.
screenIds — všechny obrazovky vytvořené nebo změněné během volání, včetně obrazovek upravených na místě. Pokud volání vyprší poté, co jsou některé obrazovky hotové, vrátí tyto obrazovky místo chyby.

Obrazovky, které necháte upravit, se přepíší na místě.

`ai-generate-screen-variant`

Přidá novou obrazovku odvozenou přesně z jedné existující obrazovky: další krok v toku, stav chyby nebo prázdný stav, případně verzi pro jinou platformu. Původní obrazovka zůstane beze změny. Chcete-li přidat obrazovku, která není variantou existující (například obrazovku nastavení), použijte ai-design-screens s fileId. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	Cílový soubor
`screenId`	`uuid`	Existující obrazovka, ze které se odvozuje
`operationVariant`	enum	Povinné: jak nová obrazovka souvisí s existující

`operationVariant`	Přidá
`next_screen`	Další obrazovku v toku uživatele
`error_state`	Stav chyby obrazovky
`empty_state`	Prázdný stav obrazovky
`web_version`	Verzi pro web
`mobile_version`	Verzi pro mobil
`tablet_version`	Verzi pro tablet
`mobile_ios_version`	Verzi pro iOS
`mobile_android_version`	Verzi pro Android

Výstup — { status, fileId, screenIds, designGuidelinesUpdated }. status je vždy "generated".

`ai-edit-screen-variant`

Změní přesně jednu existující obrazovku na místě pomocí předvolby. Můžete ji vylepšit nebo doladit, zkusit jiné rozvržení či vizuální styl, nebo ji navrhnout znovu od začátku. Pro nové obrazovky, volné instrukce nebo přesnou úpravu jednotlivých prvků použijte ai-design-screens. Vstup

Parametr	Typ	Popis
`fileId`	`uuid`	Cílový soubor
`screenId`	`uuid`	Existující obrazovka, která se má změnit
`operationVariant`	enum	Povinné: předvolba úpravy nebo redesignu, která se použije

`operationVariant`	Typ	Efekt
`dark_theme`	Úprava	Přepne obrazovku do tmavého motivu
`light_theme`	Úprava	Přepne obrazovku do světlého motivu
`make_pretty`	Úprava	Vylepší vizuální design obrazovky
`different_layout`	Redesign	Zkusí jiné rozvržení
`different_style`	Redesign	Zkusí jiný vizuální styl
`from_scratch`	Redesign	Přepracuje obrazovku od začátku

Výstup — { status, fileId, screenIds, designGuidelinesUpdated }. status je vždy "generated".

Tím se obsah obrazovky přepíše na místě.

Přejmenované nástroje

Názvy nástrojů se změnily v září a říjnu 2026. Pokud máte prompty, skripty nebo instrukce pro agenty, které používají staré názvy, aktualizujte je:

Starý název	Nový název
`get-screen`	`get-screen-jsx`
`add-screen`	`add-screen-jsx`
`replace-screen`	`replace-screen-jsx`
`ai-generate-screens`	`ai-design-screens`
`ai-edit-screens`	`ai-design-screens`
`create-new-design`	`ai-design-screens`
`edit-design` (volné instrukce)	`ai-design-screens`
`edit-design` (s předvolbou `operationVariant`)	`ai-edit-screen-variant`
`regenerate-design`	`ai-edit-screen-variant`
`expand-design`	`ai-generate-screen-variant`

Změnily se také vstupy. Nástroje AI pro design přijímají elementIds (nebo jediné screenId u nástrojů variant) místo targets. add-screen-jsx přijímá jsx a explicitní pole metadat místo jsxContent s komentářem metadat. create-file přijímá name místo title. Nástroje pro designové pokyny přijímají fileId místo resourceId a linkedTo.

​Nástroje pro soubory

​list-files

​get-file

​create-file

​update-file

​delete-file

​Nástroje pro obrazovky

​list-screens

​get-screen-image

​get-screen-jsx

​add-screen-jsx

​replace-screen-jsx

​rename-screen

​delete-screen

​Obrázky v JSX

​Hodnoty polí obrazovky

​Nástroje pro designové pokyny

​get-design-guidelines

​update-design-guidelines

​delete-design-guidelines

​Nástroje pro chat

​get-chat-history

​Nástroje pro přílohy

​upload-attachment

​Nástroje pro Figmu

​import-figma

​Nástroje pro tarif a fakturaci

​get-plan-details

​Nástroje AI pro design

​ai-design-screens

​ai-generate-screen-variant

​ai-edit-screen-variant

​Přejmenované nástroje

Nástroje pro soubory

`list-files`

`get-file`

`create-file`

`update-file`

`delete-file`

Nástroje pro obrazovky

`list-screens`

`get-screen-image`

`get-screen-jsx`

`add-screen-jsx`

`replace-screen-jsx`

`rename-screen`

`delete-screen`

Obrázky v JSX

Hodnoty polí obrazovky

Nástroje pro designové pokyny

`get-design-guidelines`

`update-design-guidelines`

`delete-design-guidelines`

Nástroje pro chat

`get-chat-history`

Nástroje pro přílohy

`upload-attachment`

Nástroje pro Figmu

`import-figma`

Nástroje pro tarif a fakturaci

`get-plan-details`

Nástroje AI pro design

`ai-design-screens`

`ai-generate-screen-variant`

`ai-edit-screen-variant`

Přejmenované nástroje