# Trechos de prompt

> Insira trechos de prompt testados, como Identity Lock ou Golden Hour, com o menu /, troque-os com um clique e salve os seus para todos os workflows.

Source: https://nodaro.ai/pt-BR/docs/guides/prompt-snippets

Um **trecho de prompt** é uma parte reutilizável de texto de prompt, como “Identity Lock”, “Golden Hour” ou “Slow Dolly-In”, que você insere enquanto escreve. Digite `/` em um campo de prompt, ou clique no botão de trechos ao lado dele, e escolha um trecho. As palavras dele entram no seu prompt naquele ponto. O Nodaro vem com trechos nativos para prompts de imagem e de vídeo, e você pode salvar os seus.

## Trechos e predefinições
| | Trecho | Predefinição |
| --- | --- | --- |
| **O que muda** | Só o texto de um campo | O nó inteiro: modelo, resolução, proporção e mais |
| **Onde entra** | Dentro do prompt ou do prompt negativo que você está escrevendo | Em todas as configurações do nó de uma vez |
| **Use para** | Enriquecer o texto de um prompt | Configurar um nó |

Use uma [predefinição](https://nodaro.ai/docs/concepts/presets) para configurar um nó, e um trecho para melhorar o texto.

## O que você vê é o que é executado
Um trecho é texto simples. Depois que você o insere, as palavras dele fazem parte do prompt, e esse texto exato é enviado ao modelo. Nada é consultado depois. Por isso:

- A visualização do prompt final, os apps publicados, a API e a exportação de workflows veem o mesmo texto simples.
- Um workflow compartilhado ou exportado leva as palavras como estão. Quem o importa não precisa dos seus trechos.

## Inserir um trecho com /
### Digitar / em um campo de prompt
Digite `/` no início de uma linha ou depois de um espaço. O menu de trechos abre onde você está digitando. Ele nunca abre no meio de uma palavra, então um endereço como `https://` não o abre.

### Filtrar a lista
Continue digitando para filtrar. O menu pesquisa o nome, a descrição e a categoria de cada trecho, e os nomes que começam com o seu texto aparecem primeiro. Os seus trechos aparecem no topo, seguidos dos trechos nativos agrupados por categoria. Cada linha mostra o nome e uma prévia do texto. O menu mostra até 50 resultados.

### Inserir o trecho
Use ↑ e ↓ para se mover, e Enter ou Tab para inserir o trecho destacado. Esc fecha o menu, e o menu também fecha quando nada corresponde à busca.

O Nodaro adiciona um separador antes do trecho para que o prompt continue legível:

| Onde está o cursor | O que é adicionado antes do trecho |
| --- | --- |
| No início de uma linha ou depois de um espaço | Nada |
| Depois de `.` `,` `;` `:` `!` ou `?` | Um espaço |
| Logo depois de uma palavra | Uma vírgula e um espaço |

O menu `/` funciona junto com os outros atalhos de prompt: `@` para [menções](https://nodaro.ai/docs/guides/reference-roles) e `{` para [variáveis](https://nodaro.ai/docs/concepts/prompt-variables).

## O botão de trechos
Cada campo de prompt tem um pequeno botão `</>` na linha do rótulo, ao lado do botão do assistente de prompt com IA. Ele abre o mesmo menu pesquisável. Um trecho escolhido pelo botão é adicionado ao final do campo; use `/` para inserir em outro ponto.

A parte de baixo do menu tem duas ações:

- **Novo trecho** abre o gerenciador de trechos com um trecho novo pronto. Se você selecionou um texto no campo antes, esse texto vira o texto do novo trecho.
- **Gerenciar** abre o gerenciador de trechos, onde você edita ou exclui os seus trechos.

## Etiquetas de trecho
Em um campo de prompt, um trecho inserido aparece como uma pequena **etiqueta** âmbar com o nome dele, em vez do texto completo. Passe o cursor sobre a etiqueta para ler o texto completo. A etiqueta só muda a exibição: o prompt continua guardando as palavras simples, e copiar o prompt copia essas palavras.

Clique em uma etiqueta para abrir o menu dela:

| Ação | O que faz |
| --- | --- |
| **Swap** | Substitui o trecho por outro trecho da mesma categoria, como Golden Hour por Neon Noir. |
| **Setas para a esquerda e para a direita** | Passam pelos outros trechos da mesma categoria, um por vez, para comparar os resultados entre execuções. |
| **Edit as text** | Transforma a etiqueta de volta em texto editável. |
| **Remover** | Exclui o trecho e o separador que foi adicionado antes dele. |

Backspace ao lado de uma etiqueta exclui a etiqueta inteira de uma vez.

Uma etiqueta aparece sempre que o texto do prompt corresponde exatamente a um trecho. Se depois você mudar o trecho na sua biblioteca, os prompts mais antigos que usam as palavras antigas voltam a mostrá-las como texto simples. O prompt em si não muda.

## Trechos nativos
Os trechos nativos do Nodaro cobrem prompts e prompts negativos de imagem e de vídeo. Eles são agrupados em categorias como:

| Categoria | Exemplos |
| --- | --- |
| Identity & Consistency | Identity Lock, Wardrobe Lock |
| Quality | Cinematic Quality, Editorial Photo |
| Lighting | Golden Hour, Neon Noir |
| Camera & Lens | 85mm Portrait, Kodak Portra Look |
| Composition | Rule of Thirds, Full Body in Frame |
| Realism | Real Skin Texture, Film Grain |
| Text Rendering | Legible Sign Text, Clean Typography |
| Camera Motion (vídeo) | Slow Dolly-In, Orbit Shot |
| Motion Quality (vídeo) | Natural Physics, I2V Fidelity Lock |
| Audio & Dialogue (vídeo) | No Subtitles, Silence Lock |
| Negative — Image | Anatomy Cleanup, Watermark Scrub |
| Negative — Video | Artifact Scrub, Identity Drift Scrub |

Os trechos nativos não podem ser editados. Os campos de áudio e de texto mostram só os seus trechos.

## Criar os seus trechos
### Abrir o gerenciador de trechos
Clique no botão `</>` ao lado de um campo de prompt e depois em **Novo trecho**. Para partir de um texto que você já escreveu, selecione-o no campo antes.

### Preencher o trecho
Dê ao trecho um nome e o texto, e escolha onde ele se aplica.

| Campo | Regras |
| --- | --- |
| **Nome** | Obrigatório. Até 80 caracteres, diferente dos nomes dos seus outros trechos. |
| **Descrição** | Opcional. Até 300 caracteres. O menu `/` pesquisa nela, então uma boa descrição ajuda você a encontrar o trecho. |
| **Texto** | Obrigatório. Até 2.000 caracteres. É o texto exato que é inserido. |
| **Alvo** | Prompt ou prompt negativo. |
| **Mídia** | Nós de imagem, vídeo, áudio ou texto. Deixe vazio para mostrar o trecho em todos os nós. |
| **Categoria** | Opcional. Agrupa o trecho no menu. Sem categoria, ele aparece em **Meus trechos**. |

### Salvar o trecho
Os seus trechos sempre aparecem no topo do menu, antes dos nativos.

**O que um trecho não pode conter.** O texto de um trecho não pode conter `{`, `}`, `@` nem quebras de linha. O editor de prompt usa chaves para variáveis e `@` para menções, então esses caracteres poderiam transformar o seu texto em uma variável ou em uma menção.

## Quais trechos um campo mostra
Cada trecho tem um alvo, prompt ou negativo, e um ou mais tipos de nó: imagem, vídeo, áudio ou texto. Um campo mostra só os trechos que correspondem aos dois. Um trecho de vídeo “Slow Dolly-In” nunca aparece em um prompt de imagem, e um trecho negativo nunca aparece em um campo de prompt normal.

**Campos de prompt negativo** têm o mesmo menu `/`, com trechos negativos, que são listas curtas separadas por vírgula, como `morphing, warping, flickering`. Eles inserem texto simples, sem etiquetas.

**Campos de tags de áudio**, os campos de texto dos nós de fala e de música do Suno, reservam o `/` para as tags de áudio e não mostram trechos.

## Ver o prompt final
Todo campo de prompt e de prompt negativo tem um botão **Mostrar prompt final**, um ícone de olho na linha do rótulo. Ele troca o editor pelo prompt completo que o modelo vai receber, com um botão **Copiar**. Clique no lápis para voltar a **Editar prompt**. A visualização é lembrada para cada campo e salva com o workflow.

Nos nós **Gerar imagem** (Generate Image) e **Modificar imagem** (Modify Image), a visualização final colore cada parte conforme a origem:

| Cor | De onde veio o texto |
| --- | --- |
| Sem cor | O seu próprio texto |
| Azul-celeste | Uma variável, como `{Mood}`, preenchida por outro nó |
| Índigo | Um seletor conectado |
| Âmbar | Um trecho |
| Verde-azulado | O [texto antes e depois](https://nodaro.ai/docs/concepts/prompt-pre-post-text) do nó |
| Violeta | As expressões de referência dos personagens e das imagens conectados |
| Cinza | O estilo adicionado ao final |
| Rosa | O prompt negativo, quando o modelo não tem um campo negativo separado |

Outros nós colorem as mesmas partes quando possível. As cores servem só para exibição: **Copiar** sempre copia texto simples, e o modelo recebe texto simples.

Os campos de prompt negativo também informam como o seu prompt negativo é enviado. Alguns modelos aceitam um prompt negativo de verdade. Nos outros, o Nodaro o adiciona ao final do prompt como uma linha “Avoid:”.

## Trechos por código
Os trechos são gerenciados no editor. A API REST consegue lê-los: `GET /v1/prompt-snippets` lista os seus trechos, e `GET /v1/prompt-snippets/factory` lista os nativos. Criar, editar e excluir trechos só é possível no editor. Executar um workflow que usa trechos não exige nada especial, porque as palavras já estão no prompt.

## Frequently asked questions

### O que é um trecho de prompt?

Um trecho é uma parte reutilizável de texto de prompt, como Golden Hour ou Slow Dolly-In. Você o insere enquanto escreve, e as palavras dele passam a fazer parte do seu prompt exatamente como aparecem.

### Qual é a diferença entre um trecho e uma predefinição?

Uma predefinição configura um nó inteiro, como o modelo, a resolução e a proporção. Um trecho muda só o texto que você está escrevendo, dentro do prompt ou do prompt negativo.

### Quem importa o meu workflow precisa dos meus trechos?

Não. Um trecho é guardado como texto simples no prompt, então as palavras vão junto com o workflow. Quem importa o workflow vê o mesmo prompt.

### Posso editar os trechos nativos?

Não. Os trechos nativos não podem ser editados. Crie o seu próprio trecho com Novo trecho, partindo do texto nativo, se quiser.

### Quais caracteres um trecho não pode conter?

Um trecho não pode conter chaves, o sinal @ nem quebras de linha, porque o editor de prompt usa esses caracteres para variáveis e menções.