说明文档
Multilingual-E5-large-instruct
Multilingual E5 Text Embeddings: A Technical Report. 梁王 (Liang Wang), 杨楠 (Nan Yang), 黄晓龙 (Xiaolong Huang), 杨林君 (Linjun Yang), Rangan Majumder, 魏福来 (Furu Wei), arXiv 2024
该模型有24层,嵌入维度为1024。
使用方法
以下是使用 MS-MARCO passage ranking 数据集对查询和文档进行编码的示例。
Transformers
import torch.nn.functional as F
from torch import Tensor
from transformers import AutoTokenizer, AutoModel
def average_pool(last_hidden_states: Tensor,
attention_mask: Tensor) -> Tensor:
last_hidden = last_hidden_states.masked_fill(~attention_mask[..., None].bool(), 0.0)
return last_hidden.sum(dim=1) / attention_mask.sum(dim=1)[..., None]
def get_detailed_instruct(task_description: str, query: str) -> str:
return f'Instruct: {task_description}\nQuery: {query}'
# 每个查询必须附带一个描述任务的单句指令
task = 'Given a web search query, retrieve relevant passages that answer the query'
queries = [
get_detailed_instruct(task, 'how much protein should a female eat'),
get_detailed_instruct(task, '南瓜的家常做法')
]
# 检索文档不需要添加指令
documents = [
"As a general guideline, the CDC's average requirement of protein for women ages 19 to 70 is 46 grams per day. But, as you can see from this chart, you'll need to increase that if you're expecting or training for a marathon. Check out the chart below to see how much protein you should be eating each day.",
"1.清炒南瓜丝 原料:嫩南瓜半个 调料:葱、盐、白糖、鸡精 做法: 1、南瓜用刀薄薄的削去表面一层皮,用勺子刮去瓤 2、擦成细丝(没有擦菜板就用刀慢慢切成细丝) 3、锅烧热放油,入葱花煸出香味 4、入南瓜丝快速翻炒一分钟左右,放盐、一点白糖和鸡精调味出锅 2.香葱炒南瓜 原料:南瓜1只 调料:香葱、蒜末、橄榄油、盐 做法: 1、将南瓜去皮,切成片 2、油锅8成热后,将蒜末放入爆香 3、爆香后,将南瓜片放入,翻炒 4、在翻炒的同时,可以不时地往锅里加水,但不要太多 5、放入盐,炒匀 6、南瓜差不多软和绵了之后,就可以关火 7、撒入香葱,即可出锅"
]
input_texts = queries + documents
tokenizer = AutoTokenizer.from_pretrained('intfloat/multilingual-e5-large-instruct')
model = AutoModel.from_pretrained('intfloat/multilingual-e5-large-instruct')
# 对输入文本进行分词
batch_dict = tokenizer(input_texts, max_length=512, padding=True, truncation=True, return_tensors='pt')
outputs = model(**batch_dict)
embeddings = average_pool(outputs.last_hidden_state, batch_dict['attention_mask'])
# 归一化嵌入向量
embeddings = F.normalize(embeddings, p=2, dim=1)
scores = (embeddings[:2] @ embeddings[2:].T) * 100
print(scores.tolist())
# => [[91.92852783203125, 67.580322265625], [70.3814468383789, 92.1330795288086]]
Sentence Transformers
from sentence_transformers import SentenceTransformer
def get_detailed_instruct(task_description: str, query: str) -> str:
return f'Instruct: {task_description}\nQuery: {query}'
# 每个查询必须附带一个描述任务的单句指令
task = 'Given a web search query, retrieve relevant passages that answer the query'
queries = [
get_detailed_instruct(task, 'how much protein should a female eat'),
get_detailed_instruct(task, '南瓜的家常做法')
]
# 检索文档不需要添加指令
documents = [
"As a general guideline, the CDC's average requirement of protein for women ages 19 to 70 is 46 grams per day. But, as you can see from this chart, you'll need to increase that if you're expecting or training for a marathon. Check out the chart below to see how much protein you should be eating each day.",
"1.清炒南瓜丝 原料:嫩南瓜半个 调料:葱、盐、白糖、鸡精 做法: 1、南瓜用刀薄薄的削去表面一层皮,用勺子刮去瓤 2、擦成细丝(没有擦菜板就用刀慢慢切成细丝) 3、锅烧热放油,入葱花煸出香味 4、入南瓜丝快速翻炒一分钟左右,放盐、一点白糖和鸡精调味出锅 2.香葱炒南瓜 原料:南瓜1只 调料:香葱、蒜末、橄榄油、盐 做法: 1、将南瓜去皮,切成片 2、油锅8成热后,将蒜末放入爆香 3、爆香后,将南瓜片放入,翻炒 4、在翻炒的同时,可以不时地往锅里加水,但不要太多 5、放入盐,炒匀 6、南瓜差不多软和绵了之后,就可以关火 7、撒入香葱,即可出锅"
]
input_texts = queries + documents
model = SentenceTransformer('intfloat/multilingual-e5-large-instruct')
embeddings = model.encode(input_texts, convert_to_tensor=True, normalize_embeddings=True)
scores = (embeddings[:2] @ embeddings[2:].T) * 100
print(scores.tolist())
# [[91.92853546142578, 67.5802993774414], [70.38143157958984, 92.13307189941406]]
Infinity
配合 Infinity 使用:
docker run --gpus all -v $PWD/data:/app/.cache -e HF_TOKEN=$HF_TOKEN -p \"7997\":\"7997\" \
michaelf34/infinity:0.0.68 \
v2 --model-id intfloat/multilingual-e5-large-instruct --revision \"main\" --dtype float16 --batch-size 32 --engine torch --port 7997
支持的语言
该模型基于 xlm-roberta-large 初始化,并持续在多语言数据集混合上进行训练。 它支持 xlm-roberta 的100种语言,但低资源语言可能会出现性能下降。
训练详情
初始化: xlm-roberta-large
第一阶段: 使用10亿个弱监督文本对进行对比预训练。
第二阶段: 基于 E5-mistral 论文中的数据集进行微调。
MTEB 基准评估
请查看 unilm/e5 以复现 BEIR 和 MTEB benchmark 上的评估结果。
常见问题
1. 我需要为查询添加指令吗?
是的,这是模型的训练方式,否则会出现性能下降。 任务定义应该是一个描述任务的单句指令。 这是一种通过自然语言指令为不同场景定制文本嵌入的方法。
请查看 unilm/e5/utils.py 了解我们评估时使用的指令。
另一方面,文档端不需要添加指令。
2. 为什么我复现的结果与模型卡片中报告的略有不同?
不同版本的 transformers 和 pytorch 可能导致微小但非零的性能差异。
3. 为什么余弦相似度分数分布在0.7到1.0之间?
这是已知且预期的行为,因为我们使用低温度0.01的 InfoNCE 对比损失。
对于文本检索或语义相似度等文本嵌入任务,重要的是分数的相对顺序而非绝对值,因此这不是问题。
引用
如果您发现我们的论文或模型有帮助,请考虑以下引用:
@article{wang2024multilingual,
title={Multilingual E5 Text Embeddings: A Technical Report},
author={Wang, Liang and Yang, Nan and Huang, Xiaolong and Yang, Linjun and Majumder, Rangan and Wei, Furu},
journal={arXiv preprint arXiv:2402.05672},
year={2024}
}
局限性
长文本将被截断至最多512个token。
intfloat/multilingual-e5-large-instruct
作者 intfloat
创建时间: 2024-02-08 12:59:32+00:00
更新时间: 2025-07-10 10:12:37+00:00
在 Hugging Face 上查看