创建场景后，您需要对场景进行开发后才可启动和使用。本文介绍如何进行场景开发。 ## 注意事项本文仅针对知识库、图片搜索、视频搜索场景的场景开发。如需了解个性化搜推、Agentic Search 和多模态搜索的场景开发，请参见[个性化搜推](https://www.volcengine.com/docs/86958/2280881)、[Agentic Search](https://www.volcengine.com/docs/86958/2551135) 和[多模态搜索](https://www.volcengine.com/docs/86958/2563144)。 ## 操作步骤 1. 登录 [ContextSearch 控制台](https://console.volcengine.com/context-search)。 2. 在顶部导航栏，选择目标项目和地域。 3. 在左侧导航栏选择**我的场景**，然后单击目标场景。 4. 在场景配置页面，进行以下配置。 ### 基础配置 1. 在场景详情页面，单击**立即配置**进行存储和 Embedding 配置。 2. 在**基础配置**面板中，配置以下参数，然后单击**确定**。 |参数 |说明 | |---|---| |存储位置 |选择运行场景的实例类型。当前支持指定数据库实例。 | |数据库类型 |选择场景使用的数据库类型，当前支持**云搜索服务**、**Milvus** 和 **TOS Vectors**。 | |所属项目 |场景所属项目。基础配置时不可切换，如需切换，请关闭对话框后从顶部导航栏修改。 | |实例名称/ID |从下拉列表中选择目标 OpenSearch 实例。支持根据实例名称的关键字进行模糊搜索。如果需要新的 OpenSearch 实例，可参见[创建实例](https://www.volcengine.com/docs/6465/1117829)。

说明

仅 OpenSearch 2.9.0 或更新版本实例支持 ContextSearch。

| |用户名 |输入实例的用户名。

说明

此参数仅当数据库类型为云搜索服务或 Milvus 时可见。

| |密码 |输入实例的密码。

说明

此参数仅当数据库类型为云搜索服务或 Milvus 时可见。

| |向量桶 |从下拉列表中选择要使用的向量桶。如需创建新的向量桶，请参见[创建向量桶](https://www.volcengine.com/docs/6349/2174784)。

说明

此参数仅当数据库类型为 TOS Vectors 时可见。

| |选择模型/推理服务 |选择已经创建推理服务下关联的模型。如果需要新的推理服务，可参见[创建自定义推理服务](https://www.volcengine.com/docs/86958/1903197)。 | |API Key |选择用于调用模型的 API Key。如果需要新的 API Key，可参见[创建 API Key](https://www.volcengine.com/docs/86958/1913532)。 | |字段配置 |配置字段后，后续可对上传的检索文件进行数据结构化处理及搜索过滤。 | ### 重排序知识库场景将知识检索阶段的召回结果输入到重排序模型，进行语义级重排序，输出得分最高的 Top N 的文档。

说明

重排序默认为开启状态，支持自定义配置。如无需进行重排序，可关闭该功能。

说明

重排序默认为开启状态，支持自定义配置。如无需进行重排序，可关闭该功能。

|**参数** |**说明** | |---|---| |选择模型/推理服务 |选择已经创建推理服务下关联的模型。如果需要新的推理服务，可参见[创建自定义推理服务](https://www.volcengine.com/docs/86958/1903197)。 | |API Key |选择用于调用模型的 API Key。如果需要新的 API Key，可参见[创建 API Key](https://www.volcengine.com/docs/86958/1913532)。 | 视频搜索场景不涉及此配置项。 ### 知识问答知识库场景 |**参数** |**说明** | |---|---| |检索策略 |选择知识库的检索策略。

* 快速：以更快速度完成检索，适合追求效率的轻量任务。

* 标准：在速度与质量之间取得稳健平衡，适用于大多数日常需求。

* 深度：提供更全面、更细致的深度推理，为高要求场景打造的高精度模式。 | |返回数量 |设置检索返回的文档数量。 | 图片搜索场景 |**参数** |**说明** | |---|---| |返回数量 |设置检索返回的图片数量。 | 视频搜索场景 |**参数** |**说明** | |---|---| |返回数量 |设置检索返回的视频数量。 | ### 添加检索文件场景配置完成后将自动初始化。初始化完成后可添加检索文件。知识库场景 1. 在**检索文件**区域单击**添加**。 2. 在**添加文件**面板中，配置以下参数，然后单击**确定**。 |参数 |说明 | |---|---| |上传/选择文件 |选择**对象存储**或**本地文档**。当选择**本地文档**时，单击上传区域然后选择待上传的文件或将待上传的文件拖动至上传区域。 | |选择存储桶 |选择待添加文件所在的存储桶。如无可用存储桶，请先创建存储桶。具体操作，请参见[创建存储桶](https://www.volcengine.com/docs/6349/75024)。 | |目标文件夹 |选择待添加文件所在的文件夹。 | |结构化字段 |输入字段的名称和值。如需新的结构化字段，单击**添加字段**。 | |导入配置 |选择是否为导入的文件开启 OCR 模型。开启后，模型将从图片或扫描文档中识别并提取文字信息，可增强检索效果。子参数如下：

* 选择模型/推理服务：选择已经创建推理服务下关联的模型。如果需要新的推理服务，可参见[创建自定义推理服务](https://www.volcengine.com/docs/86958/1903197)。

* API Key：选择用于调用模型的 API Key。如果需要新的 API Key，可参见[创建 API Key](https://www.volcengine.com/docs/86958/1913532)。 | 图片搜索场景 1. 在**检索文件**区域单击**添加**。 2. 在**添加文件**面板中，配置以下参数，然后单击**确定**。 |参数 |说明 | |---|---| |上传/选择文件 |选择**对象存储**或**本地文档**。当选择**本地文档**时，单击上传区域然后选择待上传的文件或将待上传的文件拖动至上传区域。 | |选择存储桶 |选择待添加文件所在的存储桶。如无可用存储桶，请先创建存储桶。具体操作，请参见[创建存储桶](https://www.volcengine.com/docs/6349/75024)。 | |目标文件夹 |选择待添加文件所在的文件夹。 | |结构化字段 |输入字段的名称和值。如需新的结构化字段，单击**添加字段**。 | |导入配置 |选择是否为导入的图片开启图片理解模型。开启后，模型将为添加的图片自动生成描述文本，可增强检索效果。子参数如下：

* 选择模型/推理服务：选择已经创建推理服务下关联的模型。如果需要新的推理服务，可参见[创建自定义推理服务](https://www.volcengine.com/docs/86958/1903197)。

* API Key：选择用于调用模型的 API Key。如果需要新的 API Key，可参见[创建 API Key](https://www.volcengine.com/docs/86958/1913532)。

* Prompt：根据需求为模型添加提示词。示例：描述图片内容。 | 视频搜索场景 1. **检索**在**检索文件**区域单击**添加**。 2. 在**添加文件**面板中，配置以下参数，然后单击**确定**。 |参数 |说明 | |---|---| |上传/选择文件 |选择**对象存储**或**本地文档**。当选择**本地文档**时，单击上传区域然后选择待上传的文件或将待上传的文件拖动至上传区域。 | |选择存储桶 |选择待添加文件所在的存储桶。如无可用存储桶，请先创建存储桶。具体操作，请参见[创建存储桶](https://www.volcengine.com/docs/6349/75024)。 | |目标文件夹 |选择待添加文件所在的文件夹。 | |导入配置 |选择是否为导入的视频开启语音识别服务模型/推理服务和视频理解模型。开启后，模型会分别将音频中的语音内容自动转换为文本，并对视频内容进行语义分析，可增强检索效果。子参数如下：

* 选择模型/推理服务：选择已经创建推理服务下关联的模型。如果需要新的推理服务，可参见[创建自定义推理服务](https://www.volcengine.com/docs/86958/1903197)。

* API Key：选择用于调用模型的 API Key。如果需要新的 API Key，可参见[创建 API Key](https://www.volcengine.com/docs/86958/1913532)。

* Prompt：根据需求为模型添加提示词。示例：总结视频内容。 | |最大切片长度 |指定视频处理时单个切片允许的最长时长，超过该时长的视频将被自动分割为多个片段进行处理。可选值如下：

* 15 秒

* 30 秒

* 60 秒

* 自定义 |

说明

添加检索文件后可单击查看切片来查看文件切片的详情。

### 调试预览场景开发配置完成后，您在**调试预览**区域中输入您的问题或需求进行测试。

说明

对于知识库场景，输出结果中支持展示回答引用的文档信息。

## 查看日志您可以在场景开发页面单击**日志查询**查看场景的日志。支持按照时间段、日志等级、文件和关键词过滤日志。 ## 查看配置信息您可以在场景开发页面单击**配置信息**，查看场景的**基本信息**、**发布资源**、**存储位置**、**Embedding ** 和**访问信息**。 |**分类** |**详细信息** | |---|---| |基本信息 |包含场景的名称、描述和创建时间。 | |发布资源 |包含场景的状态、资源类型、规格和节点数量。您可以单击**停止**、**重启**或**变配**执行相应操作。 | |存储位置 |包含场景所属服务以及实例名称/ID。 | |Embedding |包含场景使用的 Embedding 模型和关联的推理服务。 | |访问信息 |包含场景的私有网络、可用区、子网、私网访问状态、公网访问状态、私网访问地址和公网访问地址。开启私网访问或公网访问后，可查看相应访问地址。 | ## 查看调用示例您可以在场景开发页面单击**调用示例**查看场景的调用示例，可选择 cURL 或 Python 格式的示例。 ## 查看监控您可以在场景开发页面单击**监控**查看场景的监控信息。监控指标包括 **QPS**、**TPS**、**平均响应时间**和**请求成功率**。支持根据时间范围筛选监控信息。 ## 发布场景场景调试完成后，可将场景发布至线上。 1. 在场景开发页面，单击**发布。** 2. 在**发布**对话框中，配置以下参数，然后单击**确定**。 |参数 |说明 | |---|---| |版本号 |设置发布场景的版本。版本号规则如下：

* 版本号不能超过 255 字符。

* 只能包含英文字母、数字及点号（.）。

* 不能包含连续的点号（.）。 | |描述 |可选。设置发布场景的描述，最多支持 50 个字符。 | |规格 |从下拉列表中选择资源规格。 | |节点数量 |设置节点数量。节点数量可设范围为 2~512。 | ## 版本管理每次发布都需生成一个新版本。您可以单击**版本管理**查看已发布的版本信息并视情况删除不需要的版本。

注意

使用中的版本无法删除。

版本删除后不可恢复，请谨慎操作。

上下文搜索