> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/contexto/brand-kit/using-brand-kits.md).

# Usando Brand Kits

Como usar Brand Kits nos seus workflows e Grids

Os Kits de Marca tornam-se poderosos quando integrados nos seus fluxos de trabalho e Grids. Esta página aborda como usar os atributos do Kit de Marca como variáveis e como funciona o sistema de regras de escrita.

## Entrada de Brand Kit

Adicione uma entrada de Brand Kit ao seu fluxo de trabalho para tornar os atributos do Brand Kit disponíveis ao longo dos seus passos. Isto permite que os fluxos de trabalho se adaptem dinamicamente a diferentes contextos de marca.

Ao adicionar uma entrada de Brand Kit, os utilizadores têm de especificar:

* **Linhas de Produto** (obrigatório): Selecione um ou vários produtos aos quais este conteúdo se aplica
* **Tipo de Conteúdo** (obrigatório): Escolha o formato do conteúdo

Os utilizadores podem especificar opcionalmente:

* **Região** (opcional): Escolha a região/mercado-alvo
* **Público** (opcional): Selecione o público-alvo

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-e36aa673b052a028ea7c05b6461a72c15f8ed38a%2Fusing-brand-kits-01-brand-kit-input.png?alt=media" alt="Brand Kit input with Product Lines, Content Type, Region, and Audience selectors"><figcaption><p>Escolha as dimensões do Brand Kit que uma execução deve usar.</p></figcaption></figure>

## Coluna de Brand Kit nas Grids

Ao executar fluxos de trabalho numa Grid, pode adicionar uma **coluna de Brand Kit** que lhe permite especificar:

* **Linhas de Produto**: Selecione um ou vários produtos aos quais este conteúdo se aplica
* **Tipos de Conteúdo**: Escolha o formato do conteúdo
* **Audiências**: Selecione o público-alvo
* **Regiões**: Escolha a região/mercado-alvo

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-2feb8ebfc7e9f6a63384a3e5a8f15f3ffd041d21%2Fusing-brand-kits-02-grid-column.png?alt=media" alt="Grid Brand Kit column cell with Product Lines, Content Types, Audiences, and Regions pickers"><figcaption><p>Defina dimensões do Brand Kit por linha numa coluna de Brand Kit.</p></figcaption></figure>

Isto garante que apenas o contexto relevante é passado para o LLM, evitando confusão com informação irrelevante.

{% hint style="info" %}
**Dica**: Organizar as Grids por tipo de conteúdo e usar a coluna de Brand Kit para especificar linhas de produto, públicos e regiões cria um fluxo de trabalho poderoso para produção de conteúdo.
{% endhint %}

## Regras de Escrita e Substituições

Os Brand Kits usam um sistema hierárquico de regras:

1. **Regras Globais de Escrita** aplicam-se a todo o conteúdo por predefinição
2. **Regras específicas da dimensão** (para Tipos de Conteúdo, Públicos ou Regiões) podem substituir as regras globais quando entram em conflito
3. Use o recurso **"Mostrar regras globais"** alterne ao editar regras específicas da dimensão para ver como as suas regras se enquadram nas diretrizes globais

Cada regra apresenta um indicador "Aplica-se a" que mostra se é uma regra Global ou específica de uma dimensão (por exemplo, "Estados Unidos" para uma regra específica de uma região).

### Prioridade das Regras

Quando as regras entram em conflito, a ordem de prioridade é:

1. **Regras de região** (prioridade mais alta): Substituem todas as outras regras
2. **Regras de público**: Substituem as regras globais
3. **Regras do tipo de conteúdo**: Substituem as regras globais
4. **Regras globais** (prioridade mais baixa): Aplicam-se quando não há conflito com regras específicas de uma dimensão

## Referência de Variáveis

### Variáveis Fundamentais

| Atributo                      | Variável                        | Utilização                                                                  |
| ----------------------------- | ------------------------------- | --------------------------------------------------------------------------- |
| **Nome da marca**             | `{{brand_kit.brand_name}}`      | Use o nome da marca de forma consistente em todo o conteúdo.                |
| **Domínio da marca**          | `{{brand_kit.brand_domain}}`    | Use ao referir-se ao site da marca.                                         |
| **Sobre a marca**             | `{{brand_kit.brand_about}}`     | Informações de contexto sobre a marca.                                      |
| **Voz e tom da marca**        | `{{brand_kit.writing_tone}}`    | Garanta que a personalidade da marca seja transmitida de forma consistente. |
| **Persona do autor**          | `{{brand_kit.writing_persona}}` | Use em prompts de sistema para um estilo de escrita consistente.            |
| **Regras Globais de Escrita** | `{{brand_kit.writing_rules}}`   | Aplique em todo o conteúdo para garantir consistência.                      |

### Variáveis da Linha de Produto

Como várias Linhas de Produto podem ser selecionadas, são acedidas como um array. Use notação de índice para aceder a linhas de produto individuais:

| Atributo                       | Variável                                         | Utilização                                          |
| ------------------------------ | ------------------------------------------------ | --------------------------------------------------- |
| **Todas as Linhas de Produto** | `{{brand_kit.product_lines}}`                    | Aceda a todas as linhas de produto selecionadas.    |
| **Nome da Linha de Produto**   | `{{brand_kit.product_lines[0].name}}`            | Nome da primeira linha de produto selecionada.      |
| **Detalhes do Produto**        | `{{brand_kit.product_lines[0].details}}`         | O que o produto faz, casos de uso, funcionalidades. |
| **Diferenciadores**            | `{{brand_kit.product_lines[0].differentiators}}` | Posicionamento do produto e valor único.            |
| **Cliente Ideal**              | `{{brand_kit.product_lines[0].ideal_customer}}`  | Perfil de cliente ideal para este produto.          |
| **Concorrentes**               | `{{brand_kit.product_lines[0].competitors}}`     | Lista de concorrentes para este produto.            |

{% hint style="info" %}
Substitua `[0]` com `[1]`, `[2]`, etc., para aceder a linhas de produto adicionais selecionadas. Use `{{brand_kit.product_lines}}` para iterar sobre todas as linhas de produto selecionadas num ciclo.
{% endhint %}

### Variáveis do Tipo de Conteúdo

| Atributo                     | Variável                                   | Utilização                                          |
| ---------------------------- | ------------------------------------------ | --------------------------------------------------- |
| **Tipo de Conteúdo**         | `{{brand_kit.content_type}}`               | Aceda aos detalhes do tipo de conteúdo selecionado. |
| **Nome do Tipo de Conteúdo** | `{{brand_kit.content_type.name}}`          | Nome do tipo de conteúdo selecionado.               |
| **Estrutura do modelo**      | `{{brand_kit.content_type.outline}}`       | Estruture o conteúdo adequadamente.                 |
| **Exemplos**                 | `{{brand_kit.content_type.samples}}`       | Referência para prompting k-shot.                   |
| **Texto da CTA**             | `{{brand_kit.content_type.cta}}`           | Texto principal da chamada para ação.               |
| **Destino da CTA**           | `{{brand_kit.content_type.cta_url}}`       | URL de destino da CTA.                              |
| **Regras de Escrita**        | `{{brand_kit.content_type.writing_rules}}` | Regras específicas do tipo de conteúdo.             |

### Variáveis do Público

| Atributo                         | Variável                               | Utilização                                 |
| -------------------------------- | -------------------------------------- | ------------------------------------------ |
| **Público**                      | `{{brand_kit.audience}}`               | Aceda aos detalhes do público selecionado. |
| **Nome do público**              | `{{brand_kit.audience.name}}`          | Nome do público selecionado.               |
| **Descrição do público**         | `{{brand_kit.audience.description}}`   | Compreenda para quem está a escrever.      |
| **Regras de escrita do público** | `{{brand_kit.audience.writing_rules}}` | Regras específicas do público.             |

### Variáveis da Região

| Atributo                        | Variável                             | Utilização                                            |
| ------------------------------- | ------------------------------------ | ----------------------------------------------------- |
| **Região**                      | `{{brand_kit.region}}`               | Aceda aos detalhes da região selecionada.             |
| **Nome da Região**              | `{{brand_kit.region.name}}`          | Nome da região selecionada.                           |
| **Descrição da Região**         | `{{brand_kit.region.description}}`   | Contexto específico da região.                        |
| **Regras de Escrita da Região** | `{{brand_kit.region.writing_rules}}` | Regras específicas da região (substituem as globais). |

## Exemplo: Usar o Brand Kit numa etapa de LLM

Veja como pode estruturar um prompt usando variáveis do Brand Kit:

```liquid
Você é {{brand_kit.writing_persona}}.

## Contexto da Marca
{{brand_kit.brand_about}}

## Informação do Produto
{% for product in brand_kit.product_lines %}
### {{product.name}}
{{product.details}}
{% endfor %}

## Público-Alvo
{{brand_kit.audience.description}}

## Diretrizes de Escrita
Voz e tom: {{brand_kit.writing_tone}}

Regras a seguir:
{{brand_kit.writing_rules}}
{{brand_kit.content_type.writing_rules}}
{{brand_kit.audience.writing_rules}}
{{brand_kit.region.writing_rules}}

## Estrutura do Conteúdo
{{brand_kit.content_type.outline}}

## Chamada para Ação
Use esta CTA: {{brand_kit.content_type.cta}}
Ligação para: {{brand_kit.content_type.cta_url}}
```

Esta abordagem garante que o seu LLM tenha todo o contexto de que precisa para gerar conteúdo direcionado e alinhado com a marca.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/pt/contexto/brand-kit/using-brand-kits.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
