--- url: "/pt/pitchdeck/automation/parameters.md" description: "Execute as Quick Actions do Pitchdeck com campos nomeados simples e atalhos para a seleção atual." --- # Quick Actions do Pitchdeck > Execute as Quick Actions do Pitchdeck com campos nomeados simples e atalhos para a seleção atual. Execute tarefas comuns do Pitchdeck pelas Quick Actions do Figma sem abrir o painel do plugin. Escolha um dos atalhos nomeados abaixo. Use o painel normal do plugin para configurações detalhadas e para criar conteúdo. ## Executar uma Quick Action {#run-a-quick-action} Todo atalho exige uma licença válida verificada ou testes restantes. Se a verificação falhar ou seus testes tiverem acabado, abra o painel normal do plugin para ativar sua licença. Abrir o painel continua disponível. 1. Selecione as camadas com que você quer trabalhar, se o atalho usar uma seleção. 2. Abra as Quick Actions do Figma com **Command + /** no Mac ou **Ctrl + /** no Windows. 3. Pesquise o plugin e escolha o atalho nomeado abaixo. 4. Preencha os campos exibidos. Os campos opcionais podem ser ignorados; use Tab para editá-los. Execute o atalho e confira o resultado ou conclua a caixa de diálogo de salvamento. Os atalhos de criação pedem nomes ou dimensões diretamente. Os atalhos de camadas selecionadas usam a seleção atual automaticamente. Esses atalhos do dia a dia não pedem Target nem JSON. Escolha **Open Pitchdeck** para abrir o painel normal do plugin. | Atalho | Campos | | --- | --- | | **Export Selected Slides (Custom Settings…)** | Format (optional), Presentation content (PPTX only) (optional) | Os campos de opções fixas usam rótulos legíveis. Pesquise pelo rótulo exibido ou pelo valor correspondente; as entradas de agentes continuam usando os valores mostrados na referência de comandos. **Presentation content (PPTX only)** oferece **Editable** e **Flattened** para PowerPoint, Keynote e Google Slides. Escolha um formato de apresentação ao informar essa opção. Omita-a para manter a preferência salva. O texto editável exige que as fontes originais estejam instaladas no app de destino; escolha Flattened quando preservar a aparência do texto for mais importante do que poder editá-lo. As exportações de imagem, PDF e Canva continuam usando as próprias configurações de formato. ## Executar pelo menu de contexto {#run-from-the-context-menu} Selecione as camadas desejadas, clique com o botão direito e escolha **Plugins → Pitchdeck** (os plugins em desenvolvimento aparecem em **Development**). Escolha uma ação e o formato ou a predefinição dela. Uma predefinição é executada na hora quando não precisa de nenhum campo obrigatório; conclua a caixa de diálogo de salvamento quando ela aparecer. Cada predefinição define a opção indicada no nome. As opções compatíveis omitidas herdam as configurações salvas do plugin; uma ação ou opção explícita tem prioridade sobre um comportamento salvo conflitante. Somente os campos preenchidos explicitamente ou a opção escolhida no menu substituem essas configurações naquela execução. Se uma configuração nunca foi salva, vale a configuração normal ou a alternativa documentada. As substituições de exportação não são salvas nas suas preferências. Se um formato salvo não estiver disponível como atalho, escolha explicitamente um formato compatível ou use o painel normal. Para combinar opções, escolha **Custom Settings…** dentro da ação e preencha os parâmetros. As ações que precisam de textos, URLs, nomes ou dimensões continuam pedindo esses campos obrigatórios. **Open Pitchdeck** abre o painel normal. | Opção do menu | Próximo passo | | --- | --- | | **Export Selected Slides → Use Saved Settings** | É executada na hora | | **Export Selected Slides → PowerPoint (.pptx file)** | É executada na hora | | **Export Selected Slides → Keynote (.pptx file)** | É executada na hora | | **Export Selected Slides → Google Slides (.pptx file)** | É executada na hora | | **Export Selected Slides → PDF Deck (.pdf file)** | É executada na hora | | **Export Selected Slides → PDF for macOS Tahoe 'Preview' (.pdf)** | É executada na hora | | **Export Selected Slides → PNG Images (.zip file)** | É executada na hora | | **Export Selected Slides → JPG Images (.zip file)** | É executada na hora | | **Export Selected Slides → Canva (.psd files)** | É executada na hora | | **Export Selected Slides → PowerPoint Template (.potx file)** | É executada na hora | | **Export Selected Slides → Canva (Download PPTX)** | É executada na hora | | **Export Selected Slides → Pitch Presentation (.pptx file)** | É executada na hora | | **Export Selected Slides → MP4 Slideshow (.mp4 file)** | É executada na hora | | **Export Selected Slides → AI Agent Handoff (.zip file)** | É executada na hora | | **Export Selected Slides → Markdown & Images (.zip file)** | É executada na hora | | **Export Selected Slides → Local HTML Presentation (.zip file)** | É executada na hora | | **Export Selected Slides → Printable Handouts (.zip file)** | É executada na hora | | **Export Selected Slides → Export Selected Slides (Custom Settings…)** | Preencha Format (optional), Presentation content (PPTX only) (optional) | ## Edição detalhada {#detailed-editing} Use o painel normal do plugin para configurações detalhadas, conteúdos mais longos, criação em massa e navegação por componentes ou templates. O menu de atalhos contém apenas os comandos do dia a dia listados acima. Mantenha cada campo colado com menos de 150 caracteres: o app para desktop do Figma pode cortar o texto colado nesse limite. Entradas mais longas devem ser feitas no painel normal. Se um plugin mais antigo mostrar Action, Target e Options, atualize-o para usar estes atalhos nomeados. Um valor de Target é um ID de camada ou uma seleção, nunca o nome de um novo item. ## Ações do Pitchdeck {#pitchdeck-actions} | Ação | O que faz | Target | | --- | --- | --- | | [`export`](#export) | Exporta os slides selecionados sem publicar | Uma ou mais camadas elegíveis | ### export {#export} Exporta os slides selecionados sem publicar. Selecione uma ou mais camadas elegíveis. | Opção | Tipo | Obrigatória / padrão | Significado e valores aceitos | | --- | --- | --- | --- | | `format` | string | Alternativa: `"powerpoint"` | Formato de exportação local da apresentação. `powerpoint`, `keynote`, `google`, `pdf`, `qpdf`, `png`, `jpg`, `canva`, `potx`, `canva-pptx`, `pitch-pptx`, `mp4`, `ai-handoff`, `markdown`, `offline-html`, `handouts` | | `editable` | boolean | Alternativa: `true` | Preserva os elementos editáveis do PowerPoint | Os campos obrigatórios aninhados valem quando o objeto pai ou o item do array correspondente é informado. Os valores opcionais omitidos usam o comportamento atual da operação, a menos que um padrão esteja indicado. Escolha **Export Selected Slides (Custom Settings…)**. Preencha estes campos simples; nenhum JSON é necessário: - **Format**: **PowerPoint (.pptx file)** - **Presentation content (PPTX only)**: **Editable** Entrada para o host do agente ```json {"command":"shortcut-export","parameters":{"format":"powerpoint","editable":"true"}} ``` ## Usar os atalhos com um agente {#using-shortcuts-with-an-agent} Leia o registro legível por máquina indicado abaixo e escolha uma ação oferecida na lista de Quick Actions do plugin instalado. O registro usa as definições de opções da Hypermatic, e não o JSON Schema padrão: `min` e `max` limitam o tamanho da string, o tamanho do array ou o valor numérico, conforme o tipo do campo; as definições aninhadas usam `fields` e `item`. Campos desconhecidos são rejeitados. O agente precisa de um host capaz de acionar as Quick Actions do Figma e acompanhar o resultado normal do plugin. Os parâmetros não adicionam um disparador REST ou MCP. Os exemplos expansíveis são dados de entrada para um host compatível, não chamadas de API executáveis; as entradas dos atalhos usam strings simples em `parameters`, incluindo números e escolhas de formato. Nunca afirme que um atalho foi executado só com base na entrada preparada. Confira o resultado visível: as camadas do Figma alteradas, a exportação salva ou a página publicada. Leia a notificação normal de sucesso/erro e qualquer aviso de exportação parcial. Conclua as caixas de diálogo de salvamento nativas quando necessário; o início de um download não prova que o arquivo foi salvo. Os usuários não precisam abrir as ferramentas de desenvolvedor nem ler um console. ## Solução de problemas {#troubleshooting} | Sintoma | Próximo passo | | --- | --- | | A ação não está disponível | Atualize o plugin e confira a lista de Quick Actions dele; use o painel normal se a ação não estiver disponível. | | As opções são inválidas ou podem ter sido cortadas | Use valores simples em campos individuais, com menos de 150 caracteres, e apenas os campos aceitos por aquele atalho. | | O Target está ausente ou não é elegível | Abra a página correta, confira os requisitos de camadas da ação e selecione de novo as camadas desejadas. | | Aparece um erro de licença ou de teste | Conclua o fluxo normal de ativação do plugin antes de executar de novo. | | O download foi solicitado, mas nenhum arquivo salvo aparece | Confira a caixa de diálogo de salvamento nativa e o local de download. Inspecione o arquivo em si. | | Um comando falha, excede o tempo limite ou é cancelado | Confira o documento e o destino remoto antes de tentar de novo; alterações ou uploads anteriores podem já existir. | Os comandos têm um prazo de cinco minutos. Os erros não implicam a reversão completa. Repetir automaticamente uma criação, substituição ou upload pode duplicar ou sobrescrever trabalho. O [registro de comandos legível por máquina](/automation/parameters/pitchdeck.json) contém os mesmos IDs de ação e definições de opções. ## Limites atuais {#current-limits} No Figma Design, os alvos precisam cumprir as regras atuais de elegibilidade de slides: frames, componentes ou instâncias de nível superior visíveis, com mais de 250 px de largura e mais de 140 px de altura. Os slides marcados como pulados no Figma Slides são excluídos. A publicação, a edição de animações e os outros formatos de apresentação continuam sendo interativos. Defina o conteúdo Editable ou Flattened nas Custom Settings da exportação. Crie slides e escolha templates ou temas no painel normal do plugin. ## Documentação relacionada {#related-documentation} - [Instalar e executar o Pitchdeck](/pt/pitchdeck/overview/install) - [Parâmetros de plugins do Figma](https://developers.figma.com/docs/plugins/plugin-parameters/) - [Opções de UI oculta do Figma](https://developers.figma.com/docs/plugins/api/properties/figma-showui/)