> For the complete documentation index, see [llms.txt](https://doc.ozforensics.com/oz-knowledge/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.ozforensics.com/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/api/oz-api/rules-of-assigning-analyses.md).

# Regras de atribuição de análises

As análises no sistema Oz podem ser aplicadas de duas maneiras:

* manualmente, por exemplo, quando se escolhe o cenário Liveness em nossa aplicação de demonstração;
* automaticamente, quando não se escolhe nada e apenas se atribuem todas as análises possíveis (via API ou SDK).

A atribuição automática significa que o sistema Oz decide por si mesmo quais análises aplicar aos arquivos de mídia com base em seu [tags](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/api/oz-api/media-tags.md) e tipo. Se arquivos forem enviados pela console da web, selecione as tags necessárias; se a foto ou o vídeo forem capturados via Web SDK, o SDK escolhe as tags automaticamente. Quanto ao tipo de mídia, ele pode ser `IMAGE` (uma foto)/`VIDEO`/`SHOTS_SET`, onde `SHOTS_SET` é um arquivo .zip equivalente a vídeo.

A seguir, encontram-se as tags e os requisitos de tipo para todas as análises. Se uma mídia não corresponder aos requisitos da análise específica, essa mídia será ignorada pelos algoritmos.

As regras listadas abaixo atuam por padrão. Para alterar a configuração de mapeamento, consulte [entre em contato conosco](mailto:info@ozforensics.com).

### [QUALITY (Liveness)](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/api/oz-api/types-of-analyses-and-what-they-check.md#quality-liveness-best-shot) <a href="#h.u3oofd1yob8x" id="h.u3oofd1yob8x"></a>

Esta análise é aplicada a todas as mídias, independentemente do [gesto](/oz-knowledge/oz-knowledge/pt-br/geral/conceitos-chave-de-oz-liveness-e-biometria/passive-and-active-liveness.md) gravado (as tags de gesto começam em `video_selfie`).

**Importante**: para processar uma foto na API 4.0.8 e anteriores, compacte-a em um arquivo .zip, aplique a `SHOTS_SET` tipo e marque-a com `video_*.` Caso contrário, ela será ignorada.

### [Biometria](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/api/oz-api/types-of-analyses-and-what-they-check.md#biometry) <a href="#h.cof1fpf9g1n9" id="h.cof1fpf9g1n9"></a>

Esta análise é aplicada a todas as mídias.

Se a pasta contiver menos de dois arquivos de mídia correspondentes, o sistema retornará um erro. Se houver mais de dois arquivos, todos os pares serão comparados, e o sistema retornará um resultado para o par com faces menos semelhantes.

### [COLLECTION](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/api/oz-api/types-of-analyses-and-what-they-check.md#blacklist) <a href="#h.a3bckcn8f9x5" id="h.a3bckcn8f9x5"></a>

Esta análise funciona somente quando se tem um banco de dados de imagens pré-criado, chamado COLLECTION. A análise é aplicada a todas as mídias na pasta (ou às marcadas como mídia de origem).

### [Best Shot](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/api/oz-api/types-of-analyses-and-what-they-check.md#quality-liveness-best-shot) <a href="#h.qiipj36r6mhw" id="h.qiipj36r6mhw"></a>

Best Shot é um complemento da análise QUALITY (Liveness). Requer a opção apropriada ativada. A análise é aplicada a todos os arquivos de mídia que podem ser processados pela análise QUALITY.

### [DOCUMENTS](/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/api/oz-api/types-of-analyses-and-what-they-check.md#documents) <a href="#h.6wezm218un2o" id="h.6wezm218un2o"></a>

{% hint style="info" %}
Este tipo de análise está obsoleto.
{% endhint %}

A análise DOCUMENTS é aplicada a imagens com tags `photo_id_front` e `photo_id_back` (documents), e `photo_selfie` (selfie). O resultado será positivo se o sistema encontrar a foto de selfie e a corresponder a uma foto em um dos documentos válidos da lista a seguir:

* carteira de identidade
* carteira de motorista
* passaporte estrangeiro

### Erros relacionados a tags

| **Código** | **Mensagem**                                                                   | **Descrição**                                                                                                                                                                        |
| ---------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 202        | Não foi possível localizar o rosto na mídia de origem `[media_id]`             | Nenhum rosto foi encontrado na mídia que está sendo processada, ou a mídia de origem possui tag incorreta (`photo_id_back`) ou tag ausente usada para a mídia.                       |
| 202        | BIOMETRY. A análise requer pelo menos 2 objetos de mídia para processamento    | Os algoritmos não encontraram as duas mídias adequadas para análise. Isso pode ocorrer quando apenas uma única mídia é enviada para a análise, ou quando uma mídia está sem uma tag. |
| 202        | Erro de processamento - não foram encontrados candidatos a documento na imagem | A análise DOCUMENTS não pode ser concluída porque a foto enviada parece não ser um documento, ou possui tag incorreta (não `photo_id_*`) ou tags ausentes.                           |
| 5          | Valores de tag inválidos/ausentes para processar a verificação de QUALITY      | As tags aplicadas não podem ser processadas pelo algoritmo QUALITY (muito provavelmente, as tags começam com `photo_*`; para QUALITY, elas devem ser marcadas como `video_*`)        |
| 5          | Valores de tag inválidos/ausentes para processar a verificação de COLLECTION   | As tags aplicadas não podem ser processadas pelo algoritmo COLLECTION. Isso pode acontecer quando uma mídia está sem uma tag.                                                        |


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.ozforensics.com/oz-knowledge/oz-knowledge/pt-br/guias/developer-guide/api/oz-api/rules-of-assigning-analyses.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.