---
url: "/pl/pitchdeck/automation/parameters.md"
description: "Uruchamiaj Quick Actions w Pitchdeck z prostymi nazwanymi polami i skrótami działającymi na bieżącym zaznaczeniu."
---

# Quick Actions w Pitchdeck

> Uruchamiaj Quick Actions w Pitchdeck z prostymi nazwanymi polami i skrótami działającymi na bieżącym zaznaczeniu.

Uruchamiaj typowe zadania Pitchdeck z Quick Actions w Figmie bez otwierania panelu wtyczki. Wybierz jeden z nazwanych skrótów poniżej. Do szczegółowych ustawień i tworzenia treści używaj zwykłego panelu wtyczki.

## Uruchamianie Quick Action {#run-a-quick-action}

Każdy skrót wymaga zweryfikowanej, ważnej licencji lub pozostałych użyć próbnych. Jeśli weryfikacja się nie powiedzie albo Twoje użycia próbne się skończyły, otwórz zwykły panel wtyczki, aby aktywować licencję. Otwieranie panelu jest zawsze dostępne.

1. Zaznacz warstwy, na których chcesz pracować, jeśli skrót korzysta z zaznaczenia.
2. Otwórz Quick Actions w Figmie skrótem **Command + /** w macOS lub **Ctrl + /** w Windows.
3. Wyszukaj wtyczkę i wybierz jeden z nazwanych skrótów poniżej.
4. Wypełnij wyświetlone pola. Pola opcjonalne możesz pominąć; do ich edycji użyj klawisza Tab. Uruchom skrót i sprawdź wynik albo dokończ okno zapisu.

Skróty tworzące nowe elementy pytają bezpośrednio o nazwy lub wymiary. Skróty działające na zaznaczonych warstwach automatycznie używają bieżącego zaznaczenia. Te codzienne skróty nie pytają o Target ani JSON. Wybierz **Open Pitchdeck**, aby otworzyć zwykły panel wtyczki.

| Skrót | Pola |
| --- | --- |
| **Export Selected Slides (Custom Settings…)** | Format (opcjonalnie), Presentation content (PPTX only) (opcjonalnie) |

Pola z ustaloną listą wyborów mają czytelne etykiety. Możesz wyszukiwać po wyświetlanej etykiecie lub po wartości, która się za nią kryje; dane wejściowe agenta nadal używają wartości podanych w opisie poleceń.

**Presentation content (PPTX only)** oferuje opcje **Editable** i **Flattened** dla PowerPoint, Keynote i Google Slides. Podając tę opcję, wybierz format prezentacji. Pomiń ją, aby zachować zapisaną preferencję. Edytowalny tekst wymaga zainstalowania oryginalnych fontów w aplikacji docelowej; wybierz Flattened, gdy zachowanie wyglądu tekstu jest ważniejsze niż możliwość jego edycji. Eksporty obrazów, PDF i Canva nadal korzystają z własnych ustawień formatu.

## Uruchamianie z menu kontekstowego {#run-from-the-context-menu}

Zaznacz odpowiednie warstwy, kliknij prawym przyciskiem myszy i wybierz **Plugins → Pitchdeck** (wtyczki deweloperskie znajdziesz w **Development**). Wybierz akcję oraz jej format lub ustawienie wstępne. Ustawienie wstępne uruchamia się od razu, jeśli nie wymaga żadnych pól obowiązkowych; gdy pojawi się okno zapisu, dokończ je.

Każde ustawienie wstępne ustawia opcję, od której wzięło nazwę. Pominięte zgodne opcje dziedziczą zapisane ustawienia wtyczki; jawnie wybrana akcja lub opcja ma pierwszeństwo przed sprzecznym zapisanym zachowaniem. Tylko jawnie wpisane pola lub wybrana pozycja menu zastępują je w danym uruchomieniu. Jeśli ustawienie nigdy nie zostało zapisane, obowiązuje zwykłe ustawienie lub opisana wartość zastępcza. Zmiany wprowadzone na potrzeby eksportu nie są zapisywane w Twoich preferencjach. Jeśli zapisany format nie jest dostępny jako skrót, wybierz jawnie obsługiwany format albo użyj zwykłego panelu. Aby połączyć kilka opcji, wybierz w danej akcji **Custom Settings…** i wpisz parametry. Akcje, które potrzebują tekstu, adresów URL, nazw lub wymiarów, nadal pytają o te obowiązkowe pola. **Open Pitchdeck** otwiera zwykły panel.

| Pozycja menu | Następny krok |
| --- | --- |
| **Export Selected Slides → Use Saved Settings** | Uruchamia się od razu |
| **Export Selected Slides → PowerPoint (.pptx file)** | Uruchamia się od razu |
| **Export Selected Slides → Keynote (.pptx file)** | Uruchamia się od razu |
| **Export Selected Slides → Google Slides (.pptx file)** | Uruchamia się od razu |
| **Export Selected Slides → PDF Deck (.pdf file)** | Uruchamia się od razu |
| **Export Selected Slides → PDF for macOS Tahoe 'Preview' (.pdf)** | Uruchamia się od razu |
| **Export Selected Slides → PNG Images (.zip file)** | Uruchamia się od razu |
| **Export Selected Slides → JPG Images (.zip file)** | Uruchamia się od razu |
| **Export Selected Slides → Canva (.psd files)** | Uruchamia się od razu |
| **Export Selected Slides → PowerPoint Template (.potx file)** | Uruchamia się od razu |
| **Export Selected Slides → Canva (Download PPTX)** | Uruchamia się od razu |
| **Export Selected Slides → Pitch Presentation (.pptx file)** | Uruchamia się od razu |
| **Export Selected Slides → MP4 Slideshow (.mp4 file)** | Uruchamia się od razu |
| **Export Selected Slides → AI Agent Handoff (.zip file)** | Uruchamia się od razu |
| **Export Selected Slides → Markdown & Images (.zip file)** | Uruchamia się od razu |
| **Export Selected Slides → Local HTML Presentation (.zip file)** | Uruchamia się od razu |
| **Export Selected Slides → Printable Handouts (.zip file)** | Uruchamia się od razu |
| **Export Selected Slides → Export Selected Slides (Custom Settings…)** | Wpisz Format (opcjonalnie), Presentation content (PPTX only) (opcjonalnie) |

## Szczegółowa edycja {#detailed-editing}

Do szczegółowych ustawień, dłuższych treści, masowego tworzenia oraz przeglądania komponentów i szablonów używaj zwykłego panelu wtyczki. Menu skrótów zawiera tylko codzienne polecenia wymienione powyżej.

Każde wklejane pole powinno mieć mniej niż 150 znaków: Figma w wersji desktopowej może obcinać wklejony tekst na tej granicy. Dłuższe treści wpisuj w zwykłym panelu.

Jeśli starsza wersja wtyczki pokazuje zamiast tego pola Action, Target i Options, zaktualizuj ją, aby korzystać z tych nazwanych skrótów. Wartość Target to identyfikator warstwy lub zaznaczenie, nigdy nazwa nowego elementu.

## Akcje Pitchdeck {#pitchdeck-actions}

| Akcja | Co robi | Target |
| --- | --- | --- |
| [`export`](#export) | Eksportuje zaznaczone slajdy bez publikowania | Co najmniej jedna kwalifikująca się warstwa |

### export {#export}

Eksportuje zaznaczone slajdy bez publikowania. Zaznacz co najmniej jedną kwalifikującą się warstwę.

| Opcja | Typ | Obowiązkowa / domyślna | Znaczenie i dozwolone wartości |
| --- | --- | --- | --- |
| `format` | string | Wartość zastępcza: `"powerpoint"` | Format lokalnego eksportu prezentacji. `powerpoint`, `keynote`, `google`, `pdf`, `qpdf`, `png`, `jpg`, `canva`, `potx`, `canva-pptx`, `pitch-pptx`, `mp4`, `ai-handoff`, `markdown`, `offline-html`, `handouts` |
| `editable` | boolean | Wartość zastępcza: `true` | Zachowaj edytowalne elementy PowerPoint |

Zagnieżdżone pola obowiązkowe obowiązują, gdy podasz ich obiekt nadrzędny lub element tablicy. Pominięte wartości opcjonalne działają tak jak w istniejącej operacji, chyba że podano wartość domyślną.

Wybierz **Export Selected Slides (Custom Settings…)**. Wypełnij te zwykłe pola; JSON nie jest potrzebny:

- **Format**: **PowerPoint (.pptx file)**
- **Presentation content (PPTX only)**: **Editable**

Dane wejściowe dla hosta agenta

```json
{"command":"shortcut-export","parameters":{"format":"powerpoint","editable":"true"}}
```

## Korzystanie ze skrótów przez agenta {#using-shortcuts-with-an-agent}

Przeczytaj rejestr w formacie do odczytu maszynowego, do którego link znajdziesz poniżej, i wybierz akcję dostępną na liście Quick Actions zainstalowanej wtyczki. Rejestr używa definicji opcji Hypermatic, a nie standardowego JSON Schema: `min` i `max` ograniczają długość tekstu, długość tablicy lub wartość liczbową, zależnie od typu pola; definicje zagnieżdżone używają `fields` i `item`. Nieznane pola są odrzucane.

Agent potrzebuje hosta, który potrafi wywoływać Quick Actions w Figmie i obserwować zwykły wynik działania wtyczki. Parametry nie dodają uruchamiania przez REST ani MCP. Rozwijane przykłady to dane wejściowe dla zgodnego hosta, a nie wykonywalne wywołania API; pola skrótów używają w `parameters` zwykłych ciągów znaków, także dla liczb i wyboru formatu. Nigdy nie twierdź, że skrót się wykonał, tylko na podstawie przygotowanych danych wejściowych.

Sprawdź widoczny efekt: zmienione warstwy w Figmie, zapisany eksport lub opublikowaną stronę. Przeczytaj zwykły komunikat o powodzeniu lub błędzie oraz ewentualne ostrzeżenie o częściowym eksporcie. W razie potrzeby dokończ systemowe okna zapisu; samo rozpoczęcie pobierania nie dowodzi, że plik został zapisany. Użytkownicy nie muszą otwierać narzędzi deweloperskich ani czytać konsoli.

## Rozwiązywanie problemów {#troubleshooting}

| Objaw | Następny krok |
| --- | --- |
| Akcja jest niedostępna | Zaktualizuj wtyczkę i sprawdź jej listę Quick Actions; jeśli akcji nadal nie ma, użyj zwykłego panelu. |
| Opcje są nieprawidłowe lub mogły zostać obcięte | Podawaj osobne, zwykłe wartości pól krótsze niż 150 znaków i tylko pola akceptowane przez dany skrót. |
| Brakuje elementu docelowego lub się nie kwalifikuje | Otwórz właściwą stronę, sprawdź wymagania akcji dotyczące warstw i ponownie zaznacz odpowiednie warstwy. |
| Pojawia się błąd licencji lub użyć próbnych | Przed ponownym uruchomieniem przejdź zwykłą aktywację we wtyczce. |
| Zlecono pobranie, ale nie widać zapisanego pliku | Sprawdź systemowe okno zapisu i folder pobierania. Obejrzyj sam plik. |
| Polecenie kończy się błędem, przekracza limit czasu lub zostaje anulowane | Przed ponowną próbą sprawdź dokument i miejsce docelowe; wcześniejsze zmiany lub przesłane pliki mogą już istnieć. |

Polecenia mają limit pięciu minut. Błąd nie oznacza pełnego wycofania zmian. Automatyczne ponawianie tworzenia, zastępowania lub przesyłania może zduplikować lub nadpisać pracę.

[Rejestr poleceń do odczytu maszynowego](/automation/parameters/pitchdeck.json) zawiera te same identyfikatory akcji i definicje opcji.

## Obecne ograniczenia {#current-limits}

W Figma Design elementy docelowe muszą spełniać obecne zasady kwalifikowania slajdów: widoczne ramki najwyższego poziomu, komponenty lub instancje o szerokości ponad 250 px i wysokości ponad 140 px. Slajdy oznaczone jako pominięte w Figma Slides są wykluczane. Publikowanie, edycja animacji i inne formaty prezentacji pozostają interaktywne. Treść Editable lub Flattened ustawisz w Custom Settings eksportu. Slajdy twórz, a szablony i motywy wybieraj w zwykłym panelu wtyczki.

## Powiązana dokumentacja {#related-documentation}

- [Instalacja i uruchamianie Pitchdeck](/pl/pitchdeck/overview/install)
- [Parametry wtyczek Figmy](https://developers.figma.com/docs/plugins/plugin-parameters/)
- [Opcje ukrytego interfejsu w Figmie](https://developers.figma.com/docs/plugins/api/properties/figma-showui/)