> 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/knowledge-bases/knowledge-base-metadata.md).

# Metadados da Base de Conhecimento

Filtrar ao pesquisar uma Base de Conhecimento

Os metadados são informações adicionais associadas aos ficheiros da sua Base de Conhecimento, pelas quais pode filtrar durante as pesquisas, de forma semelhante à filtragem de colunas numa folha de cálculo.

{% @arcade/embed url="<https://app.arcade.software/share/y41OGVJZuh8LHtOtcWlz>" flowId="y41OGVJZuh8LHtOtcWlz" %}

## Tipos de metadados

### Metadados padrão

Herdados automaticamente da origem (nome do ficheiro, URL da origem, data de carregamento, etc.). Os metadados padrão são só de leitura. Para os atualizar, faça alterações na origem e volte a sincronizar.

### Metadados personalizados

Adicione etiquetas aos ficheiros da Base de Conhecimento com os seus próprios pares chave-valor para organizar e filtrar conteúdo por dimensões como **Região**, **Produto**, **Público-alvo**, ou **Tipo de conteúdo**.

{% hint style="success" %}
Os metadados personalizados permitem filtrar ficheiros da Base de Conhecimento diretamente nas etapas do Workflow, sem precisar de os importar para uma Grid apenas para adicionar etiquetas e filtrar conteúdo.
{% endhint %}

## Adicionar metadados

### Metadados personalizados (IU)

1. Clique em qualquer ficheiro da sua Base de Conhecimento para abrir os respetivos detalhes
2. Na secção **Metadados personalizados** , clique em **Adicionar**
3. Introduza uma **Chave** (por exemplo, "country") e um **Valor** (por exemplo, "France")
4. Clique em **Guardar alterações**

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-52948fcc8499dafc67e51e4c6f7866005b244f9d%2Fkb-metadata-01-custom-metadata.png?alt=media" alt="Knowledge Base file details with custom metadata for country and product"><figcaption><p>Adicione metadados personalizados a um ficheiro da Base de Conhecimento.</p></figcaption></figure>

### CSV / Google Sheets

Ao carregar um ficheiro CSV ou uma folha do Google Sheets, todas as colunas são armazenadas como metadados. Pode escolher quais as colunas pesquisáveis. As restantes continuam a ser devolvidas como metadados, mas só podem ser usadas para filtragem.

### Outros métodos

* **API** - Utilize o [endpoint "Update" da API Knowledge Bases](https://docs.airops.com/docs/pt/contexto/knowledge-bases/knowledge-base-api.md#supported-api-calls)
* **Workflow** - Utilize a etapa ["Knowledge Base Write"](https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/memory-steps/memory-write.md)

## Filtrar com metadados

Utilize filtros de metadados nas etapas de Knowledge Base do seu Workflow para restringir os resultados da pesquisa.

**Exemplo:** Se tiver estudos de caso etiquetados com uma chave `country` , adicione um filtro na etapa **Search Knowledge Base** ou **Get Knowledge Base File** em que `country` é igual a `"Spain"` para obter apenas estudos de caso espanhóis.

{% hint style="info" %}
**Filtragem dinâmica:** Utilize as entradas do fluxo de trabalho para uma filtragem flexível. Defina o filtro como `country` igual a `{{input.region}}`, e depois passe diferentes valores de região em tempo de execução.
{% endhint %}

Para ver exemplos detalhados de filtragem, consulte a [documentação da etapa de pesquisa na base de conhecimento](https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/memory-steps/memory-search.md#filter-the-memory-store-optional).

### Operadores de filtragem (editor de código)

Para filtros complexos, utilize os operadores de consulta do MongoDB:

| Operador           | Descrição                    |
| ------------------ | ---------------------------- |
| **$eq**            | Igual a                      |
| **$ne**            | Diferente de                 |
| **$gt** / **$gte** | Maior que / Maior ou igual a |
| **$lt** / **$lte** | Menor que / Menor ou igual a |
| **$in** / **$nin** | Na lista / Fora da lista     |

{% hint style="info" %}
Para metadados de lista, como `"genres": ["thriller", "mystery"]`, a pesquisa corresponde a qualquer valor da lista.
{% endhint %}

### Filtragem através da API

Também pode filtrar através do [endpoint «Search» da API Knowledge Bases](https://docs.airops.com/docs/pt/contexto/knowledge-bases/knowledge-base-api.md#supported-api-calls).

{% @arcade/embed url="<https://app.arcade.software/share/1qOMDldFNqFWJ15cm6Wb>" flowId="1qOMDldFNqFWJ15cm6Wb" %}

## Boas práticas

* **Utilize chaves consistentes** - Uniformize os nomes das chaves (utilize sempre "country", nunca "region" em alguns casos) e os formatos dos valores (utilize sempre "United States", nunca "US" ou "USA")
* **Planeie a sua estratégia** - Decida por que dimensões pretende filtrar antes de etiquetar o conteúdo
* **Metadados personalizados vs. grelhas** - Utilize metadados personalizados para etiquetar ficheiros; utilize grelhas para etiquetar linhas de dados estruturados


---

# 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/knowledge-bases/knowledge-base-metadata.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.
