AI 助手（Elastic AI Assistant）使用指引_检索分析服务 Elasticsearch版(ES)-阿里云帮助中心

Elasticsearch新增了AI助手功能，可查询关于实例信息、监控、运维状态等，例如：查询本地实例集群的索引情况，从而提升您对Elasticsearch的使用体验。AI助手能够获取并分析实例和集群的索引及其他信息。如您在实际使用中对Elasticsearch实例或集群有疑问，建议首先向AI助手咨询。 {0A7B5602-9709-4D4E-98EE-185092E7BBDD}

前提条件

已创建阿里云ES 8.15及以上版本实例。具体操作，请参见创建阿里云Elasticsearch实例。
已开通阿里云搜索开放平台并创建AI推理模型。创建8.15及以上版本的实例之后，在Elasticsearch实例控制台自动创建AI模型。具体操作，请参见创建AI推理模型。
说明
开通AI搜索开放平台并获取平台的调用地址和身份鉴权信息，请参见开通服务、获取服务接入地址和管理API Key。
已登录ES实例的Kibana控制台。具体操作，请参见登录Kibana控制台。

背景信息

在Kibana配置中增加了参数密钥配置模块，AI 助手的使用需要设置2个参数的密钥，包含信息如下：

xpack.security.encryptionKey ：Elasticsearch中X-Pack安全模块的加密密钥。
xpack.encryptedSavedObjects.encryptionKey ：Elasticsearch中加密保存对象的密钥。

使用指引

登录阿里云Elasticsearch管理控制台。
单击Elasticsearch实例，单击所购买实例。
单击配置与管理 > 可视化控制。
单击Kibana的修改配置，如您未增加Kibana公网访问的白名单，请先增加白名单，详情请参见快速入门。
在Kibana配置页面，单击右上角修改配置，配置xpack.security.encryptionKey和xpack.encryptedSavedObjects.encryptionKey参数，单击确定。
说明
参数密钥长度32-100个字符，可以包含大小写字母和数字，关于安全密钥的说明，请参见Configure security in Kibana。
返回可视化页控制页面，单击公网入口，输入用户名、密码，单击登录，进入Kibana页面。
说明
如您忘记密码，详情请参见重置实例访问密码。
单击左上角图标，展开导航栏，单击Observability > 概览。
单击AI助手，然后单击设置GenAI连接器。
进入选择连接器，选择OpenAI。
说明
AI搜索开发平台的大模型接口包含兼容OpenAI的接口定义：内容生成服务。

在OpenAI编辑连接器界面，修改内容。

{EAE278AD-8B1C-480C-8060-D88AEB5D7C6F}

OpenAI连接器信息	内容

OpenAI连接器信息	内容
Connector name	名称，自行定义，本文以AI搜索平台为例。
URL	`http://default-v2x.platform-cn-shanghai.opensearch.aliyuncs.com/compatible-mode/v1/chat/completions`。说明 URL配置：请前往AI搜索开放平台，单击API Keys，复制公网API域名后的字符串粘贴到URL下面输入框中，后面加`/compatible-mode/v1/chat/completions`。
默认模型	支持的模型说明：支持的服务列表，可输入模型例如：qwen-turbo、qwen-plus、qwen-max，其中ops-qwen-turbo目前还不支持在AI助手中使用。
API密钥	API密钥。在实例的控制台，单击AI服务中心 > 模型管理，复制模型调用API Key后的字符串，粘贴到API密钥输入框中。

填完上述内容，单击下方保存。
然后单击连接器（AI搜索平台） > 管理连接器 > AI搜索平台后面图标，再单击运行。出现测试成功则操作正确。
单击关闭，再单击左上角图标，展开导航栏，单击Observability > 概览，然后单击AI助手。
说明
目前相关步骤已经完成，但您需要开启模拟函数才能正常使用，步骤如下：
在AI助手新对话页面，单击右上角标识 > AI助手设置 > 模拟函数调用，打开模拟函数调用开关，单击save changes。
完成步骤，可在AI助手对话框输入内容，与AI助手进行交互。

场景体验

导入样例数据
1. 进入Kibana主页，单击试用样例数据。
3. 单击其他样例数据集，导入左下角两个案例数据。
AI助手使用体验
1. 单击左上角图标，展开导航栏，单击Observability > 概览，然后单击AI助手。
2. 输入问题1：请列出当前集群的索引，不要包含隐藏索引或者系统索引。
3. 输入问题2：比较kibana_sample_data_ecommerce和kibana_sample_data_flights两个索引，有哪些重复的字段。

说明

关于AI助手的各种用法，请参见基于阿里云Elasticsearch Enterprise构建AI搜索与可观测Chatbot。

常见问题

问题：按步骤走完为什么还是无法与AI助手进行交互？

回答：请先单击关闭，以观察出现的错误，测试运行是否成功，并确认模拟函数是否未被调用。

问题：报错信息出现如下信息：get_alerts_dataset_infoget_dataset_infoalerts，是什么问题呢？

回答：如果函数名称生成出现错误，如图中示例（get_alerts_dataset_infoget_dataset_infoalerts）所示，将会出现上述问题。这是由于deepseek-r1等模型可能一次返回多个函数调用所致。在这种情况下，可以在问题中加入如下内容提醒大模型一次返回一个函数：请记住接下来的所有返回内容，一次返回结果只能返回一个函数的tool，即返回的内容只能有一个<|tool_use_start|>。示例：集群当前状态如何，请记住接下来的所有返回内容，一次返回结果只能返回一个函数的tool，即返回的内容只能有一个<|tool_use_start|>。

问题：报错信息出现如下信息：Failed to validate:Excess keys are not allowed:body.messages.message.data，是什么问题呢？

Failed to validate:Excess keys are not allowed:body.messages.message.data。

回答：可能是会话的内容太多了，建议开启一个新会话。

前提条件

背景信息

使用指引

场景体验

导入样例数据

常见问题