图文搜索支持文本、图片、图文等基于多种数据的查询。本文介绍如何进行图文搜索场景的开发。 ## 前提条件 * 已创建 OpenSearch 2.9.0 版本实例。具体操作请参见[创建实例](https://www.volcengine.com/docs/6465/70681)。 * 已创建 AI 搜索。具体操作请参见[创建 AI 搜索](https://www.volcengine.com/docs/6465/1263536)。 * 已创建图文搜索场景。具体操作请参见[创建场景](https://www.volcengine.com/docs/6465/1817531)。 ## 操作步骤 1. 登录[云搜索服务控制台](https://console.volcengine.com/es)。 2. 在顶部导航栏，选择目标项目和地域。 3. 在左侧导航栏选择 **AI 搜索**，查找并单击目标服务名称。 4. 在左侧导航栏选择**场景开发**，选择**零代码\-图文搜索**，然后单击目标场景。 5. 在场景配置页面，进行以下配置。 ### 配置 Embedding 模型在 **Embedding 模型**区域，配置如下参数，然后单击**确认**。 :::warning 当前仅支持 Multi\-Modal Embedding 类型的模型。模型配置需手动确认，确认后不支持修改，请谨慎操作。 ::: |参数 |说明 | |---|---| |模型/推理服务 |选择已经创建推理服务下关联的模型。如果需要新的推理服务，可参考[创建推理服务](https://www.volcengine.com/docs/6465/1347836)。 | |API Key |选择已经创建的 API Key。如果需要新的 API Key，可参见[创建 API Key](/docs/6465/1359479)。 | ### 添加检索文件 1. 在**检索文件**区域，单击**添加**。 2. 在**添加文件**对话框中，选择**对象存储**或**本地文档**。 * 对象存储：选择待添加文件所在的存储桶和目标文件夹，然后单击**确定**。如无可用存储桶，请先创建存储桶。具体操作，请参见[创建存储桶](https://www.volcengine.com/docs/6349/75024)。 * 本地文档：单击上传区域然后选择待上传的文件或将待上传的文件拖动至上传区域。上传完成后，单击**确定**。 ### 配置搜索参数配置以下参数。 |参数 |说明 | |---|---| |搜索类型 |选择**文搜图**或**图搜图**。|\ | ||\ | | * 文搜图：根据文本搜索相似图片。|\ | | * 图搜图：根据图片搜索相似图片。 | |返回数量 |设置返回结果的数量。取值范围：1~100。默认值：10。 | |结果起始位置 |设置返回结果的起始位置。取值范围：1~100。默认值：1。 | ## 调试预览场景开发配置完成后，您在**开发与调试**页签中根据添加的检索文件输入文本或上传图片进行测试。图片搜索支持 OCR，可识别图片中的文字，然后基于文字和图片进行混合搜索。例如输入“车牌”或上传包含“车牌”文字的图片时，都可搜索到相应内容。调试预览中返回的结果示例如下。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_867b34b97d59e6befa146de80fbc1b9d.png =855x) ## 发布场景场景调试完成后，可将场景发布至线上。 1. 在场景开发页面，单击**发布。** 2. 在**发布**对话框中，配置以下参数，然后单击**确定**。 |参数 |说明 | |---|---| |版本号 |设置发布场景的版本。 | |描述 |可选。设置发布场景的描述，最多支持 50 个字符。 | |可用区 |选择需要部署的可用区。默认继承 OpenSearch 实例的可用区。如果 OpenSearch 实例是单可用区，那么场景也只有一个可用区。 | |是否开启高可用 |开启高可用后，节点数量为 2 的整数倍。 | |资源类型 |选择 **CPU** 或 **GPU**。 | |规格 |从下拉列表中选择资源规格。 | |节点数量 |设置节点数量。|\ | ||\ | |* 未开启高可用：节点数量可设范围为 1~512。|\ | |* 开启高可用：节点数量为 2 的整数倍，最大值为 512。 | ## 版本管理每次发布都需生成一个新版本。您可以单击**版本管理**查看已发布的版本信息并视情况删除不需要的版本。 :::warning * 使用中的版本无法删除。 * 版本删除后不可恢复，请谨慎操作。 ::: ## 查看日志您可以在场景开发页面单击**日志查询**查看场景的日志。支持按照时间段、日志等级、文件和关键词过滤日志。 ## 查看配置信息您可以在场景开发页面单击**配置信息**，查看场景的**基本信息**、**发布资源**和**访问信息**。 |**分类** |**详细信息** | |---|---| |基本信息 |基本信息包含场景的名称、描述和创建时间。 | |资源配置 |资源配置包含可用区、状态、高可用、资源类型、规格和节点数量。 | |访问信息 |当前 AI 搜索开启公网和私网访问后，可查看访问信息包含公网访问地址和私网访问地址。具体操作，请参见[配置 AI 搜索公网访问](https://www.volcengine.com/docs/6465/1359459)和[配置 AI 搜索私有网络](https://www.volcengine.com/docs/6465/1347835)。您可以单击地址后的**调用示例**查看相应示例。 | ## 查看调用示例您可以在场景开发页面单击**调用示例**查看场景的调用示例，可选择 cURL 或 Python 格式的示例。