> 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/visual-guidelines.md).

# Diretrizes Visuais

Defina regras visuais e modelos de casos de uso no seu Brand Kit

As Diretrizes Visuais estruturam as cores, tipografia, logótipos e regras visuais da sua marca para que os ativos gerados por IA permaneçam alinhados com a marca.

Usando o Brand Kit MCP, pode configurar a sua identidade visual (preenchendo-a via Claude, por exemplo) e recuperá-la com a mesma facilidade, para que cada resultado se baseie não só no que dizer, mas em como o apresentar.

O separador Diretrizes Visuais está organizado em **Logótipos**, **Cores**, **Tipografia**, e modelos de utilização visual **casos de uso**. Os modelos mantêm juntas as instruções e os exemplos para um tipo específico de ativo, em vez de armazenar todas as imagens de referência numa única coleção plana.

***

## Casos de uso

As Diretrizes Visuais podem ser lidas e escritas via MCP, por isso qualquer ferramenta de IA ligada pode produzir resultados visuais alinhados com a marca. Aqui estão alguns exemplos.

**Gerar relatórios e documentos de uma página alinhados com a marca.** Uma ferramenta de IA ligada via MCP recupera as suas cores exatas, tipos de letra, escala tipográfica e regras do logótipo e, em seguida, aplica-as ao gerar um relatório, um documento de uma página ou um resumo de dados. Os relatórios de desempenho de AEO, por exemplo, podem vir totalmente com a identidade da marca logo de início.

**Produzir visualizações de dados com a paleta da sua marca.** Quando a paleta de cores dos seus gráficos, as regras de uso de cor e o modelo de Visualização de Dados estão armazenados nas Diretrizes Visuais, um agente de IA pode consultá-los para renderizar gráficos, diagramas e painéis que correspondem à sua marca. Preenchimentos sólidos, cores de destaque específicas, tipos de letra corretos para os rótulos dos eixos.

**Criar apresentações que pareçam da sua marca.** Claude ou outra ferramenta ligada ao MCP pode recuperar a sua escala tipográfica completa, variantes do logótipo e paletas de cores para gerar diapositivos de apresentação que seguem a sua identidade visual.

**Aplicar a direção criativa certa a cada ativo.** Uma Imagem Hero pode pedir arte editorial expressiva, enquanto um Cartão de Citação pode especificar uma composição contida e o posicionamento exato do logótipo. Cada caso de uso traz as suas próprias instruções e exemplos, por isso as orientações para um tipo de ativo não são aplicadas indiscriminadamente a outro.

***

## Como Configurar as Diretrizes Visuais

Em vez de introduzir manualmente cada cor, tipo de letra e regra, **pode usar o Claude via MCP para ler as diretrizes existentes da sua marca**, seja um PDF, uma apresentação ou qualquer outro documento, e escrever os campos estruturados diretamente no seu Brand Kit. Esta é a forma mais rápida de preencher as Diretrizes Visuais.

Também pode adicionar campos manualmente através do separador Diretrizes Visuais:

1. Navegue até ao **Diretrizes Visuais** separador no seu Brand Kit
2. Em **Logótipos**, adicione variantes com ficheiros de logótipo, cores de fundo e instruções de utilização. Defina tamanhos e regras de utilização do logótipo.
3. Em **Cores**, crie paletas com grupos nomeados e cores individuais. Adicione regras de utilização de cor.
4. Em **Tipografia**, registe tipos de letra com contexto de utilização e carregamentos de ficheiros de tipos de letra. Defina a sua escala tipográfica. Adicione regras de utilização de tipografia.
5. Crie modelos de casos de uso como **Imagem Hero**, **Visualização de Dados**, e **Cartão de Citação**. Adicione instruções e exemplos de referência a cada modelo.
6. Guarde as suas alterações

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-2c02e4e961fca8bbaec440c0705878b77a309756%2Fbrand-kit-visual-01-logos-colors.png?alt=media" alt="Brand Kit Visual Guidelines with SpaceOps logo variants and a named color palette"><figcaption><p>Adicione logótipos, cores e tipografia às Diretrizes Visuais.</p></figcaption></figure>

> **Dica**: Pode preencher as Diretrizes Visuais via MCP a partir das diretrizes da sua marca ou dos seus ativos visuais. [Saiba mais sobre o Brand Kit MCP →](broken://pages/7907cd708ca6e0b6be28224a7742ed29248808e1)

***

## Exemplo

Uma empresa poderia configurar as suas Diretrizes Visuais assim:

**Logótipos:** Quatro variantes para diferentes superfícies (claro, escuro, verde floresta, verde néon). Vários níveis de tamanho, do grande (secções hero) ao mínimo (rodapés e favicons). Regras que cobrem espaço livre, sem distorção e combinação com fundos.

**Cores:** Cinco paletas que abrangem a marca principal, hierarquia de texto, traços, modo escuro e uma paleta dedicada para gráficos. Regras que impõem cantos retos em todo o lado e preenchimentos sólidos para gráficos.

**Tipografia:** Três tipos de letra com ficheiros de fonte alojados. Uma serifada para títulos, sans-serif para o corpo, monoespaçada para rótulos. Uma escala tipográfica completa de Display até Caption. Regras que restringem a serifada a títulos e exigem monoespaçada em maiúsculas para rótulos.

**Modelos de casos de uso:** Um modelo de Imagem Hero com orientação de ilustração editorial e referências de landing page; um modelo de Visualização de Dados com exemplos de gráficos e regras de disposição; e um modelo de Cartão de Citação com orientação sobre tipografia, atribuição e posicionamento do logótipo.

***

## Detalhes da secção

### Logótipos

**Variantes do Logótipo**

Defina diferentes versões do seu logótipo para diferentes contextos de fundo.

| Campo                        | Descrição                                                                                                                   |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                     | Um nome descritivo para esta variante (por exemplo, "Cor total sobre branco", "Branco invertido sobre preto muito escuro"). |
| **Cor de Fundo**             | A cor hexadecimal para a qual esta variante foi concebida (por exemplo, `#ffffff`, `#002910`).                              |
| **Instruções de Utilização** | Quando e como usar esta variante. Inclua regras de espaço livre, restrições e lógica de combinação com fundos.              |
| **Ficheiro do Logótipo**     | Carregue a imagem do seu logótipo (SVG, PNG, JPG, GIF ou WebP).                                                             |

**Tamanhos do Logótipo**

Defina os tamanhos de renderização permitidos para que as ferramentas de IA nunca renderizem o seu logótipo demasiado pequeno ou demasiado grande.

| Campo                        | Descrição                                                                  |
| ---------------------------- | -------------------------------------------------------------------------- |
| **Nome**                     | Um rótulo para este nível de tamanho (por exemplo, "Grande", "Mínimo").    |
| **Largura**                  | Largura em píxeis (opcional se a altura estiver definida).                 |
| **Altura**                   | Altura em píxeis (opcional se a largura estiver definida).                 |
| **Instruções de Utilização** | Onde este tamanho deve ser usado (por exemplo, "secções hero", "rodapés"). |

**Regras de Utilização do Logótipo**

Regras em texto livre que regem o tratamento do logótipo.

| Campo     | Descrição                                                                                                                                           |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Regra** | O texto da regra (por exemplo, "O espaço livre mínimo é igual à altura do A em todos os lados", "Nunca estique, rode ou altere a cor do logótipo"). |

***

### Cores

**Paletas de Cores**

Agrupe as cores da sua marca em paletas nomeadas. Cada paleta contém cores individuais com valores hexadecimais e instruções de utilização.

Pode criar várias paletas para separar preocupações, por exemplo: Principal, Texto, Traços, Modo Escuro e Gráficos.

| Campo                        | Descrição                                                                                                      |
| ---------------------------- | -------------------------------------------------------------------------------------------------------------- |
| **Nome da Paleta**           | Um nome para este grupo de cores (por exemplo, "Principal", "Gráficos").                                       |
| **Nome da Cor**              | Um nome descritivo para cada cor (por exemplo, "Verde de Interação", "Texto Secundário").                      |
| **Valor da Cor**             | O valor hexadecimal (por exemplo, `#00ff64`).                                                                  |
| **Instruções de Utilização** | Quando e onde usar esta cor (por exemplo, "estados de hover e destaques interativos", "legendas e metadados"). |

**Regras de Utilização da Cor**

Regras em texto livre que regem a utilização da cor.

| Campo     | Descrição                                                                                                                                                                                                        |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Regra** | O texto da regra (por exemplo, "Todas as superfícies grandes devem usar verde escuro #002910", "Apenas cantos retos, border-radius: 0", "Visualização de dados: apenas preenchimentos sólidos, sem gradientes"). |

***

### Tipografia

**Tipos de Letra**

Registe os tipos de letra usados pela sua marca.

| Campo                        | Descrição                                                                                                             |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Nome**                     | O nome do tipo de letra exatamente como deve ser referido (por exemplo, "Saans", "Serrif VF").                        |
| **Instruções de Utilização** | Em que contextos este tipo de letra se aplica, fontes de recurso e substitutos específicos da plataforma.             |
| **Ligação do Google Fonts**  | Um URL do Google Fonts, se o tipo de letra estiver alojado lá.                                                        |
| **Ficheiro de Fonte**        | Carregue um ficheiro de fonte personalizado (por exemplo, .woff2). Os agentes podem carregá-lo através de @font-face. |

**Escala Tipográfica**

Defina a sua escala tipográfica completa associando configurações específicas de tamanho, peso e altura de linha a um tipo de letra.

| Campo                        | Descrição                                                                               |
| ---------------------------- | --------------------------------------------------------------------------------------- |
| **Tipo de Letra**            | A que tipo de letra registado este tamanho de texto pertence.                           |
| **Nome**                     | Um rótulo para este passo da escala (por exemplo, "Display", "H1", "Corpo", "Legenda"). |
| **Peso**                     | Peso da fonte (por exemplo, "400", "600").                                              |
| **Tamanho**                  | Tamanho da fonte em píxeis.                                                             |
| **Altura da Linha**          | Altura da linha em píxeis.                                                              |
| **Instruções de Utilização** | Onde este tamanho de texto deve ser aplicado.                                           |

**Regras de Utilização da Tipografia**

Regras em texto livre que regem o tratamento tipográfico.

| Campo     | Descrição                                                                                                                                                              |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Regra** | O texto da regra (por exemplo, "Serrif VF é apenas para títulos editoriais grandes", "Os rótulos monoespaçados devem estar sempre em maiúsculas, 11-12 px, peso 500"). |

***

### Modelos de casos de uso

Crie um modelo separado para cada tipo de ativo visual que a sua equipa produz. Cada caso de uso traz as suas próprias instruções e exemplos, para que uma ferramenta de IA possa recuperar orientações que correspondam ao resultado solicitado em vez de interpretar uma coleção plana de imagens não relacionadas.

Os modelos comuns incluem:

* **Imagem Hero:** Composição, proporção, tratamento do assunto, estilo de ilustração ou fotografia e exemplos de arte hero bem-sucedida.
* **Visualização de Dados:** Paleta de gráficos, rotulagem, tratamento da grelha e dos eixos, estilo de anotações e exemplos de gráficos alinhados com a marca.
* **Cartão de Citação:** Hierarquia tipográfica, posicionamento da atribuição, tratamento do fundo, posicionamento do logótipo e exemplos de cartões sociais aprovados.

Adicione outros casos de uso para os ativos que a sua equipa cria, como capturas de ecrã de produtos, capas de relatórios ou diapositivos de título de apresentações. Para cada um, forneça:

* **Instruções** que descrevem a composição pretendida, o estilo, os elementos obrigatórios e os padrões a evitar.
* **Exemplos** que mostram o caso de uso aplicado com sucesso e dão a uma ferramenta de IA uma referência visual concreta.

Use as secções estruturadas de Logótipos, Cores e Tipografia para regras que se aplicam a todos os ativos. Mantenha as instruções do modelo focadas no que é único para esse caso de uso visual.

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-680756a530524abde652d77d754a5e20863b3461%2Fbrand-kit-visual-02-use-case-template.png?alt=media" alt="Hero Image use-case template with composition instructions and example images"><figcaption><p>Os modelos de casos de uso dizem às ferramentas de IA como compor um visual específico.</p></figcaption></figure>

***

## Perguntas Frequentes

**Como acedo às Diretrizes Visuais nas minhas ferramentas de IA?** As Diretrizes Visuais estão disponíveis através do Brand Kit MCP. Ligue-o ao Claude, Cursor ou a qualquer ferramenta compatível com MCP para ler e escrever a sua identidade visual programaticamente. As variáveis Liquid do fluxo de trabalho ainda não estão disponíveis para os campos das Diretrizes Visuais.

**Posso preencher as Diretrizes Visuais usando IA?** Sim. Usando o Brand Kit MCP, pode pedir ao Claude para ler o PDF das diretrizes existentes da sua marca e escrever os campos estruturados diretamente no seu Brand Kit.

**Que casos de uso isto desbloqueia?** Qualquer ferramenta de IA ligada via MCP pode recuperar a sua identidade visual para produzir relatórios, apresentações, documentos de uma página e visualizações de dados alinhados com a marca, com as suas cores, tipos de letra e regras exatas.

**Qual é a diferença entre as instruções do caso de uso e a outra orientação estruturada?** As instruções de um modelo descrevem como produzir um tipo de ativo, como uma Imagem Hero ou um Cartão de Citação. As instruções ao nível do campo explicam quando usar um logótipo, cor ou tipo de letra específico, enquanto as regras de utilização da categoria definem guardrails mais amplos que se aplicam a todos os ativos.


---

# 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/visual-guidelines.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.
