# BAAI/bge-reranker-v2-m3

**BAAI/bge-reranker-v2-m3** é um modelo reranker multilíngue com 568 milhões de parâmetros. Ele lê uma consulta e um conjunto de textos e retorna uma pontuação de relevância para cada texto em relação a essa consulta. [AI Inference](/pt-br/documentacao/plataforma/ai-inference/) executa o modelo sob o id `baai-bge-reranker-v2-m3`.

## Detalhes do modelo

O id do modelo é a string que uma chamada passa para selecionar este modelo. O repositório no HuggingFace contém o model card.

| Detalhe               | Valor                                                                     |
| --------------------- | ------------------------------------------------------------------------- |
| Nome do modelo        | BAAI/bge-reranker-v2-m3                                                   |
| Versão                | Original                                                                  |
| Categoria do modelo   | Reranker                                                                  |
| Id do modelo          | `baai-bge-reranker-v2-m3`                                                 |
| Tamanho               | 568M parâmetros                                                           |
| Modelo no HuggingFace | [BAAI/bge-reranker-v2-m3](https://huggingface.co/BAAI/bge-reranker-v2-m3) |
| Licença               | [Apache 2.0](https://choosealicense.com/licenses/apache-2.0/)             |

## Capacidades

Estes valores descrevem o modelo e não são campos do corpo da requisição. Para os campos que uma requisição de reranking carrega, e seus tipos, consulte [Invocação de modelos](/pt-br/documentacao/plataforma/ai-inference/invocacao-de-modelos/).

| Capacidade              | Valor     |
| ----------------------- | --------- |
| Dados de entrada        | Texto     |
| Comprimento de contexto | 8k tokens |
| Suporta LoRA            | Não       |

---

## Uso

Uma [função](/pt-br/documentacao/plataforma/functions/) invoca o modelo com `Azion.AI.run`, passando o id como primeiro argumento e o corpo da requisição como segundo. Este modelo não recebe um array `messages`: cada uma das duas operações abaixo tem o seu próprio corpo. Para enviar o mesmo corpo por HTTP, consulte [Invocação de modelos](/pt-br/documentacao/plataforma/ai-inference/invocacao-de-modelos/).

### Reranking

Uma requisição de reranking carrega a `query` e os `documents` a serem ranqueados em relação a ela:

```ts
const modelResponse = await Azion.AI.run("baai-bge-reranker-v2-m3", {
  "query": "What is deep learning?",
  "documents": [
    "Deep learning is a subset of machine learning that uses neural networks with many layers",
    "The weather is nice today",
    "Deep learning enables computers to learn from large amounts of data",
    "I like pizza"
  ]
})
```

O modelo retorna um array `results` ordenado do maior `relevance_score` para o menor, com uma entrada por documento, cada uma carregando a posição que o documento ocupava na requisição e o seu texto:

```json
{
  "id": "rerank-0123456789abcdef0123456789abcdef",
  "model": "baai-bge-reranker-v2-m3",
  "usage": {
    "total_tokens": 78
  },
  "results": [
    {
      "index": 0,
      "document": {
        "text": "Deep learning is a subset of machine learning that uses neural networks with many layers"
      },
      "relevance_score": 0.99951171875
    },
    {
      "index": 2,
      "document": {
        "text": "Deep learning enables computers to learn from large amounts of data"
      },
      "relevance_score": 0.98291015625
    },
    {
      "index": 3,
      "document": {
        "text": "I like pizza"
      },
      "relevance_score": 0.00001621246337890625
    },
    {
      "index": 1,
      "document": {
        "text": "The weather is nice today"
      },
      "relevance_score": 0.000016033649444580078
    }
  ]
}
```

### Pontuação

Uma requisição de pontuação carrega `text_1` e o array `text_2` que o modelo pontua em relação a ele:

```ts
const modelResponse = await Azion.AI.run("baai-bge-reranker-v2-m3", {
  "text_1": "What is deep learning?",
  "text_2": [
    "Deep learning is a subset of machine learning that uses neural networks with many layers",
    "The weather is nice today",
    "Deep learning enables computers to learn from large amounts of data",
    "I like pizza"
  ]
})
```

A resposta carrega o mesmo array `results`, com uma entrada e uma `relevance_score` para cada texto em `text_2`.

---

## Recursos relacionados

- [Invocação de modelos](/pt-br/documentacao/plataforma/ai-inference/invocacao-de-modelos.md): Todos os campos que uma requisição de reranking aceita e o endpoint HTTP que recebe o mesmo corpo.
- [Modelos de AI](/pt-br/documentacao/plataforma/ai-inference/modelos.md): Os outros modelos que AI Inference executa e o id ao qual cada um responde.
- [AI Inference](/pt-br/documentacao/plataforma/ai-inference.md): O produto que executa este modelo.
- [Functions](/pt-br/documentacao/plataforma/functions.md): O produto cujo runtime contém o binding que os exemplos desta página chamam.
- [Limites do AI Inference](/pt-br/documentacao/plataforma/ai-inference/limites.md): As condições sob as quais a Azion encerra ou desprovisiona um modelo.
- [Glossário](/pt-br/documentacao/plataforma/ai-inference/glossario.md): Onde id do modelo, comprimento de contexto e o restante do vocabulário do AI Inference são definidos.