> 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 Brand Kits tornam-se poderosos quando integrados nos seus fluxos de trabalho e Grelhas. Esta página explica como usar os atributos do Brand Kit como variáveis e como funciona o sistema de regras de escrita.

## Entrada do Brand Kit

Adicione uma entrada do 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.

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

* **Linhas de Produto** (obrigatório): Selecione um ou mais 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 de destino
* **Público-alvo** (opcional): Selecione o público-alvo

## Coluna do Brand Kit nas Grelhas

Ao executar fluxos de trabalho numa Grelha, pode adicionar uma **coluna do 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
* **Públicos**: Selecione o público-alvo
* **Regiões**: Escolha a região/mercado de destino

Isto garante que apenas o contexto relevante é passado para o LLM, evitando confusão causada por informações irrelevantes.

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

## Regras de Escrita e Substituições

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

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 a funcionalidade **"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 da região** (maior prioridade): Substituem todas as outras regras
2. **Regras do público**: Substituem as regras globais
3. **Regras do tipo de conteúdo**: Substituem as regras globais
4. **Regras globais** (menor prioridade): Aplicam-se quando nenhuma regra específica da dimensão entra em conflito

## 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 é 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 consistência.                            |

### Variáveis da Linha de Produto

Uma vez que podem ser selecionadas várias Linhas de Produto, são acedidas como um array. Utilize a 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 produtos adicionais selecionadas. Use `{{brand_kit.product_lines}}` para iterar por todas as linhas de produtos 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.               |
| **Esquema 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 de call-to-action.                  |
| **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-alvo**                 | `{{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}}`   | Perceba 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 num Passo de LLM

Eis como poderá 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 tem todo o contexto de que precisa para gerar conteúdo alinhado com a marca e direcionado.


---

# 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.