1.8. 关于 BYO 知识库工具


OpenShift Lightspeed 服务使用大型语言模型(LLM)来生成问题的响应。您可以使用 BYO 知识库工具创建检索生成(RAG)数据库来提高 LLM 可用的知识。

在创建 RAG 数据库时,您可以为您的环境自定义 OpenShift Lightspeed 服务。例如,网络管理员可开发用于置备 OpenShift Container Platform 集群的标准操作流程(SOP)。然后,网络管理员可以通过包含 SOP 的信息来增强 BYO 知识库工具来增强 LLM 可用的知识。

要将自己的知识带到 LLM 中,您可以完成以下步骤:

  • 以 Markdown 格式创建自定义内容。
  • 使用 BYO 知识库工具将内容打包为容器镜像。
  • 将容器镜像推送到镜像 registry,如 quay.io
  • 更新 OLSConfig 自定义资源文件,以列出推送到镜像 registry 的镜像。
  • 访问 OpenShift Lightspeed 虚拟助手,并提交与您提供给 LLM 提供的自定义知识相关的问题。

    注意

    当您使用 BYO 知识库工具时,LLM 提供的文档将发送到 LLM 供应商。

1.8.1. 为 LLM 提供自定义知识

通过提供对位于远程镜像 registry 中的容器镜像的访问,自定义大型语言模型(LLM)可用的信息。此流程中的示例使用 quay.io 作为远程容器镜像 registry,自定义镜像的路径为 quay.io/<username>/my-byok-image:latest

重要

BYO 知识库工具只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议(SLA)支持,且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能,并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息,请参阅技术预览功能支持范围

先决条件

  • 以具有集群范围自定义资源(CR)文件(如具有 cluster-admin 角色的用户)的权限登录到 OpenShift Container Platform Web 控制台。
  • 您有一个可用于 OpenShift Lightspeed Service 的 LLM 供应商。
  • 已安装 OpenShift Lightspeed Operator。
  • 您要添加的自定义信息作为使用 .md 扩展的 Markdown 文件的集合。不支持其他文件格式。
  • 已使用 Podman 登录到 registry.redhat.io
  • 您有一个容器镜像 registry 的帐户,如 quay.io

流程

  1. 运行以下命令,使用 Markdown 文件为检索生成(RAG)数据库指定目录的位置,以及 BYO 知识库工具生成的镜像的路径:

    $ podman run -it --rm --device=/dev/fuse \
      -v $XDG_RUNTIME_DIR/containers/auth.json:/run/user/0/containers/auth.json:Z \
      -v <dir_tree_with_markdown_files>:/markdown:Z \
      -v <dir_for_image_tar>:/output:Z \
      registry.redhat.io/openshift-lightspeed-tech-preview/lightspeed-rag-tool-rhel9:latest
    Copy to Clipboard Toggle word wrap
    注意

    工具生成的容器镜像包含自定义 RAG 数据库。RAG 数据库向 LLM 提供其他信息。

  2. 运行以下命令,加载 BYO 知识库工具生成的容器镜像:

    $ podman load < <directory_for_image_tar>/<my-byok-image.tar>
    Copy to Clipboard Toggle word wrap
  3. 运行以下命令,显示本地计算机上的 podman 镜像:

    $ podman images
    Copy to Clipboard Toggle word wrap

    输出示例

    REPOSITORY                            TAG                IMAGE ID      CREATED       SIZE
    localhost/my-byok-image               latest             be7d1770bf10  1 minute  ago    2.37 GB
    ...
    Copy to Clipboard Toggle word wrap

  4. 运行以下命令,使用名称和目的地标记本地镜像,以便镜像可以推送到容器镜像 registry 中:

    $ podman tag localhost/my-byok-image:latest quay.io/<username>/my-byok-image:latest
    Copy to Clipboard Toggle word wrap
  5. 运行以下命令,将本地容器镜像推送到容器镜像 registry:

    $ podman push quay.io/<username>/my-byok-image:latest
    Copy to Clipboard Toggle word wrap
  6. 修改 OLSconfig CR,以部署新创建的 RAG 数据库以及现有数据库:

    1. 在 OpenShift Container Platform web 控制台中,点击 Operators Installed Operators
    2. 在屏幕顶部的 Project 下拉菜单中选择 All Projects
    3. OpenShift Lightspeed Operator
    4. 单击 OLSConfig,然后单击列表中的 集群配置 实例。
    5. YAML 标签。
    6. 插入 spec.ols.rag yaml 代码:

      OLSconfig CR 文件示例

      apiVersion: ols.openshift.io/v1alpha1
      kind: OLSConfig
      metadata:
        name: cluster
      spec:
        ols:
          rag:
            - image: quay.io/<username>/my-byok-image:latest 
      1
      Copy to Clipboard Toggle word wrap

      1
      其中 image 指定推送到镜像 registry 的镜像标签,以便 OpenShift Lightspeed Operator 可以访问自定义内容。OpenShift Lightspeed Operator 可以使用您创建的多个 RAG 数据库。
  7. 点击 Save

验证

  • 访问 OpenShift Lightspeed 虚拟助手,并提交与您提供给 LLM 的自定义内容相关的问题。

    OpenShift Lightspeed 虚拟助手根据自定义内容生成响应。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat