Kibana 中的 AI 助手设置

编辑

Kibana 中的 AI 助手设置

编辑
xpack.productDocBase.artifactRepositoryUrl
用于下载和安装 AI 助手 Elastic 产品文档工件的存储库 URL。默认为 https://kibana-knowledge-base-artifacts.elastic.co

为气隙环境配置产品文档

编辑

安装产品文档需要网络访问其工件存储库。对于气隙环境或远程网络流量被阻止或过滤的环境,必须手动将工件存储库部署到 Kibana 部署可访问的某个位置。

部署自定义产品文档存储库可以通过两种方式完成:使用 S3 存储桶或使用 CDN。

使用 S3 存储桶部署

编辑

1. 下载当前 Kibana 版本的工件

工件名称遵循以下模式:kb-product-doc-{productName}-{versionMajor}.{versionMinor}.zip

可用的产品有:- elasticsearch - kibana - observability - security

您必须从源存储库 (https://kibana-knowledge-base-artifacts.elastic.co/) 下载当前 Kibana 版本的工件。

例如,对于 Kibana 8.16:- kb-product-doc-elasticsearch-8.16.zip - kb-product-doc-kibana-8.16.zip - kb-product-doc-observability-8.16.zip - kb-product-doc-security-8.16.zip

2. 将工件上传到您的本地 S3 存储桶

将工件文件上传到您的自定义 S3 存储桶,然后确保它们已正确列在存储桶的索引中,类似于在浏览器中访问 https://kibana-knowledge-base-artifacts.elastic.co/ 时显示的存储桶列表。

3. 配置 Kibana 以使用自定义存储库

将以下行添加到您的 Kibana 配置文件中

# Replace with the root of your custom bucket
xpack.productDocBase.artifactRepositoryUrl: "https://my-custom-repository.example.com"

4. 重启 Kibana

然后,您应该能够从 AI 助手管理页面安装产品文档功能。

使用 CDN 部署

编辑

使用 CDN 部署与使用 S3 存储桶的方法非常相似。主要区别在于,我们需要手动生成存储桶列表并将其设置为 CDN 文件夹的索引页面。

1. 下载当前 Kibana 版本的工件

按照使用 S3 存储桶部署部分中的步骤操作

2. 将工件上传到 CDN

在您的 CDN 中创建一个文件夹,并将工件上传到其中。

3. 创建并上传存储桶列表

为该文件夹生成 S3 存储桶列表 XML 文件。

为此,请复制以下模板,并将 <Key> 标签中的版本替换为当前 Kibana 版本。

例如,对于 Kibana 8.17,请将文件中所有 8.16 的出现替换为 8.17

<ListBucketResult>
    <Name>kibana-ai-assistant-kb-artifacts</Name>
    <IsTruncated>false</IsTruncated>
    <Contents>
        <Key>kb-product-doc-elasticsearch-8.16.zip</Key>
    </Contents>
    <Contents>
        <Key>kb-product-doc-kibana-8.16.zip</Key>
    </Contents>
    <Contents>
        <Key>kb-product-doc-observability-8.16.zip</Key>
    </Contents>
    <Contents>
        <Key>kb-product-doc-security-8.16.zip</Key>
    </Contents>
</ListBucketResult>

然后将该 XML 文件上传到上传工件的同一 CDN 文件夹,然后配置该文件夹以将该文件作为文件夹的索引提供。

4. 配置 Kibana 以使用自定义存储库

将以下行添加到您的 Kibana 配置文件中

# Replace with the path to the CDN folder previously configured
xpack.productDocBase.artifactRepositoryUrl: "https://my-custom-repository.example.com"

5. 重启 Kibana

然后,您应该能够从 AI 助手管理页面安装产品文档功能。