> 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/memory-stores/memory-stores-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 que pode filtrar ao pesquisar, de forma semelhante a filtrar 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 de 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

Marque os 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-lhe filtrar ficheiros da Base de Conhecimento diretamente nas etapas do workflow, sem necessidade de importar para uma grelha apenas para marcar 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. No **Metadados personalizados** secção, clique **Adicione**
3. Introduza um **Chave** (p. ex., "country") e **Valor** (p. ex., "França")
4. Clique em **Guardar alterações**

### CSV / Google Sheets

Ao carregar um CSV ou uma Folha de cálculo Google, todas as colunas são guardadas como metadados. Pode escolher quais colunas são pesquisáveis. As restantes continuam a ser devolvidas como metadados, mas só podem ser usadas para filtragem.

### Outros métodos

* **API** - Use o [endpoint "Update" da API de Bases de Conhecimento](/docs/pt/contexto/memory-stores/memory-stores-api.md#supported-api-calls)
* **Workflow** - Use o [etapa "Knowledge Base Write"](/docs/pt/acoes/workflow-concepts/workflow-steps/memory-steps/memory-write.md)

## Filtragem com metadados

Use filtros de metadados nas etapas da Base de Conhecimento do seu workflow para delimitar os resultados da pesquisa.

**Exemplo:** Se tiver estudos de caso marcados com uma `country` chave, adicione um filtro na sua **Pesquisar na Base de Conhecimento** ou **Obter Ficheiro da Base de Conhecimento** etapa em que `country` é igual a `"Spain"` para obter apenas estudos de caso espanhóis.

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

Para exemplos detalhados de filtragem, consulte a [documentação da etapa de pesquisa da Base de Conhecimento](/docs/pt/acoes/workflow-concepts/workflow-steps/memory-steps/memory-search.md#filter-the-memory-store-optional).

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

Para filtros complexos, use 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** | Em array / Não em array      |

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

### Filtragem via API

Também pode filtrar usando o [endpoint "Search" da API de Bases de Conhecimento](/docs/pt/contexto/memory-stores/memory-stores-api.md#supported-api-calls).

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

## Boas práticas

* **Use chaves consistentes** - Padronize os nomes das chaves (sempre "country", e não por vezes "region") e os formatos dos valores (sempre "United States", e não "US" ou "USA")
* **Planeie a sua estratégia** - Decida por que dimensões precisa de filtrar antes de marcar o conteúdo
* **Metadados personalizados vs. Grids** - Use metadados personalizados para marcação ao nível do ficheiro; use Grids para marcação ao nível da linha 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/memory-stores/memory-stores-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.