导入训练好的模型和词汇表

编辑

如果您想在受限或封闭网络中安装训练好的模型,请参阅 这些说明

选择模型后,必须将其及其分词器词汇表导入到您的集群中。导入模型时,由于其大小,必须将其分块并逐个分块导入以进行分部分存储。

训练好的模型必须以 TorchScript 表示形式才能与 Elastic Stack 机器学习功能一起使用。

Eland 是一个 Elasticsearch Python 客户端,它提供了一个简单的脚本,用于将 Hugging Face 变压器模型转换为其 TorchScript 表示形式,进行分块处理,并上传到 Elasticsearch;因此,它是推荐的导入方法。您可以将 Python Eland 客户端安装在您的机器上,也可以使用 Docker 镜像构建 Eland 并运行模型导入脚本。

使用已安装的 Eland 客户端导入

编辑
  1. 使用 PyTorch 附加依赖项安装 Eland Python 客户端

    python -m pip install 'eland[pytorch]'
  2. 运行 eland_import_hub_model 脚本以从 Hugging Face 下载模型,将其转换为 TorchScript 格式,并上传到 Elasticsearch 集群。例如

    eland_import_hub_model \
    --cloud-id <cloud-id> \ 
    -u <username> -p <password> \ 
    --hub-model-id elastic/distilbert-base-cased-finetuned-conll03-english \ 
    --task-type ner  

    指定 Elastic Cloud 标识符。或者,使用 --url

    提供访问集群的身份验证详细信息。请参阅 身份验证方法 以了解更多信息。

    指定 Hugging Face 模型中心中模型的标识符。

    指定 NLP 任务的类型。支持的值为 fill_masknerquestion_answeringtext_classificationtext_embeddingtext_expansiontext_similarityzero_shot_classification

有关更多详细信息,请参阅 https://elastic.ac.cn/guide/en/elasticsearch/client/eland/current/machine-learning.html#ml-nlp-pytorch

使用 Docker 导入

编辑

如果您想在不安装 Eland 的情况下使用它,请运行以下命令

$ docker run -it --rm --network host docker.elastic.co/eland/eland

eland_import_hub_model 脚本可以直接在 docker 命令中运行

docker run -it --rm docker.elastic.co/eland/eland \
    eland_import_hub_model \
      --url $ELASTICSEARCH_URL \
      --hub-model-id elastic/distilbert-base-uncased-finetuned-conll03-english \
      --start

$ELASTICSEARCH_URL 替换为您 Elasticsearch 集群的 URL。请参阅 身份验证方法 以了解更多信息。

身份验证方法

编辑

使用导入脚本时,可以使用以下身份验证选项

  • 用户名/密码身份验证(使用 -u-p 选项指定)

    eland_import_hub_model --url https://<hostname>:<port> -u <username> -p <password> ...
  • 用户名/密码身份验证(嵌入在 URL 中)

    eland_import_hub_model --url https://<user>:<password>@<hostname>:<port> ...
  • API 密钥身份验证

    eland_import_hub_model --url https://<hostname>:<port> --es-api-key <api-key> ...