所有使用场景共用同一套实例准备和连接步骤。连接成功后，可按业务需要选择向量检索、Collection 与 Slice 数据管理等能力。
准备实例
前提条件
已开通阿里云 Elasticsearch 服务，并已创建或准备创建 Agent 引擎版实例。
已规划实例所在的专有网络、交换机、访问白名单和客户端网络。
操作账号具有相应权限。例如，使用 Collection 时，管理通常需要
manage，数据读取需要read，数据写入需要write，详见Collection 权限。
创建实例
创建实例时Elasticsearch 版本选择 Agent 引擎版，生产环境建议至少配置 2 个查询节点，以便单个查询节点故障时仍可提供查询。更详细的参数配置请参见创建阿里云Elasticsearch实例。
节点数量和规格应分别依据写入吞吐、查询并发、向量索引构建、活跃数据集及缓存需求确定。持久数据使用按量计费的对象存储，无需提前选配存储容量或自行扩容。
连接实例
可以使用 Kibana Dev Tools、Elasticsearch 兼容客户端或任意 HTTP 客户端访问实例。连接参数请从实例详情页复制，详细信息请参见连接集群。
Agent 引擎版的访问域名因网络类型而异。域名只决定请求首先接入的节点角色，不限制请求类型；集群会将请求转发给实际负责处理的角色节点。
网络类型 | 域名 | 入口挂载节点 | 请求处理方式 |
私网 | 控制台显示的默认 Elasticsearch 私网域名 | 查询节点 | 支持读写。写入请求会转发给索引节点处理。 |
私网 |
| 索引节点 | 支持读写。查询请求会转发给查询节点处理。请将 |
公网 | 控制台显示的默认 Elasticsearch 公网域名 | 查询节点 | 公网只提供该域名，支持读写；写入请求会转发给索引节点处理。 |
通过私网访问时，两个域名在功能上都支持读写。生产环境建议查询请求使用默认私网域名，写入请求使用索引节点私网域名，以减少对查询节点的网络带宽占用。Bulk 写入、返回结果较大的查询或高并发场景尤其需要区分使用。通过公网访问时，读写请求均使用默认公网域名。例如实例 ID 为 es-cn-xxx 时，索引节点私网域名为 es-cn-xxx-index.elasticsearch.aliyuncs.com。
在 Kibana Dev Tools 中执行以下请求验证连接：
GET /该请求返回的 version.number 是 Elasticsearch 内核版本号，与控制台显示的产品版本号不同。使用 cURL 时，替换实例地址和用户名；执行后在提示中输入密码，避免把密码写进命令历史：
curl --user '<username>' 'https://<elasticsearch-endpoint>/'该示例使用 HTTPS。实例默认使用 HTTP；公网访问或传输业务凭据时必须先开启 HTTPS。仅在确认处于受控的专有网络连通性验证场景时，才使用控制台提供的 HTTP 地址。
选择客户端
Agent 引擎版对应内核版本 9.99.0。已有实例可通过 GET / 核对内核版本。
推荐使用与内核小版本一致的客户端（当前为 9.5.x）。同一主版本下，小版本不高于内核的客户端（9.0～9.5）均可正常调用；小版本高于内核的客户端不保证兼容。可调用的 API 始终由服务端内核版本决定，升级客户端不会让服务端获得更高内核版本才有的功能、API 或请求参数。具体规则参见 Elasticsearch 客户端兼容性说明。
自定义插件兼容性
需要打包或上传自定义插件时，请使用面向 Agent 引擎版构建并验证过的插件包。插件描述文件 plugin-descriptor.properties 中的 elasticsearch.version=9.99.0 是 Agent 引擎版预留的插件兼容标识：声明该值后，节点加载插件时会跳过内核版本校验，使插件得以加载。但它不校验插件与内核的二进制或 API 兼容性，也不是编译时依赖的内核版本；任意版本的插件仅修改这个字段并不能保证可用，仍须针对 Agent 引擎版重新构建并测试。
后续步骤
先完成一个向量检索示例：普通索引向量检索示例。
按租户、知识库或代码仓库组织数据：快速入门：按租户或知识库检索。
了解索引节点、查询节点和缓存如何配合：无状态架构与资源规划。