Agent Builder 是 Elastic 提供的智能代理构建能力，支持基于大语言模型（LLM）和 Elasticsearch 数据进行检索、分析和交互。通过 Agent Builder，可以快速构建面向业务场景的智能助手，例如运维问答助手、日志分析助手、安全分析助手和知识库助手等。
官方文档：Elastic Agent Builder。
创建Agent
以下步骤说明如何在 Kibana 中创建基于 AI 搜索开放平台的 Agent 并进行测试。
- 说明
需要 ES 9.3.2 及以上版本的实例。如未创建，请参见创建阿里云Elasticsearch实例。
单击Elasticsearch实例，单击目标实例。
单击。
单击Kibana的修改配置，确认已添加 Kibana 公网访问白名单。如未添加，请先增加白名单，详情请参见快速入门。
返回可视化控制页面，单击公网入口，输入用户名、密码，单击登录，进入Kibana页面。
说明如忘记密码，请参见重置实例访问密码。
单击左上角菜单图标，展开导航栏，单击。
单击连接器，跳转到连接器管理页面。
单击创建连接器，选择AI Connector，按照以下说明填写连接器信息：
Connector name：自定义名称。
服务类型：选择 OpenAI。
说明AI搜索开放平台的大模型接口兼容 OpenAI 接口定义，详情请参见内容生成服务。
Model ID：输入模型名称。支持的模型请参见支持的服务列表，例如 qwen-turbo、qwen-plus、qwen3-max。其中 ops-qwen-turbo 目前不支持在 AI 助手中使用。
展开 More options，在 URL 处填写模型服务地址，格式为：
http://{模型服务接入地址}/compatible-mode/v1/chat/completions。模型服务接入地址从页面的模型服务接入地址复制。API Key：在实例控制台，单击，复制模型调用API Key后的字符串。
Additional settings：Task type 选择 chat_completion。
说明模型服务接入地址和 API Key 均可在实例控制台的页面获取。创建 ES 8.15 及以上版本实例后，系统会自动创建 AI 推理模型。详情请参见AI搜索开放平台。
单击保存并测试。页面依次显示创建操作、运行测试、结果三个步骤，当结果区域提示"执行测试时，连接器运行成功"且底部出现"已创建 'xxx'"时，表示连接器创建并测试通过。
创建成功后，返回连接器管理页面，连接器列表中会显示新创建的 AI Connector 类型连接器。
回到 页面，刷新页面，页面显示：
"How can I help you?"对话界面，底部展示已连接的 Connector 和 Elastic AI Agent，表示 Agent 已创建完成。
使用示例
Agent 创建完成后，可以通过自然语言与 Elasticsearch 数据交互。Agent 会调用内置工具将自然语言翻译为 ES|QL 查询语句，查询 ES 实例中的数据并进行分析。
例如，当 Elasticsearch 集群中有索引存储了 API 的历史访问日志数据时，在对话框中输入"分析一下历史请求，找出最慢的API接口"。Agent 会执行以下推理过程：
调用内置工具（如
platform.core.search）识别相关数据源。定位到目标索引（如
api_access_logs）。自动生成 ES|QL 查询语句，对日志数据按 API 名称分组统计平均响应时间、最大响应时间和请求次数。
Agent 返回分析结果，包括：
最慢请求的详细信息（API 名称、请求路径、耗时、状态码等）。
各 API 的性能统计数据（平均耗时、最大耗时、请求次数），并以柱状图形式可视化展示。
性能优化建议（如针对慢查询 API 的排查方向）。