文档中心

上下文搜索

场景管理

场景开发

创建场景后，您需要对场景进行开发后才可启动和使用。本文介绍如何进行场景开发。

注意事项

本文仅针对知识库、图片搜索、视频搜索场景的场景开发。如需了解个性化搜推、Agentic Search 和多模态搜索的场景开发，请参见个性化搜推、Agentic Search 和多模态搜索。

操作步骤

在顶部导航栏，选择目标项目和地域。

在左侧导航栏选择我的场景，然后单击目标场景。

在场景配置页面，进行以下配置。

基础配置

在场景详情页面，单击立即配置进行存储和 Embedding 配置。

在基础配置面板中，配置以下参数，然后单击确定。

参数	说明
存储位置	选择运行场景的实例类型。当前支持指定数据库实例。
数据库类型	选择场景使用的数据库类型，当前支持云搜索服务、Milvus 和 TOS Vectors。
所属项目	场景所属项目。基础配置时不可切换，如需切换，请关闭对话框后从顶部导航栏修改。
实例名称/ID	从下拉列表中选择目标 OpenSearch 实例。支持根据实例名称的关键字进行模糊搜索。如果需要新的 OpenSearch 实例，可参见创建实例。说明仅 OpenSearch 2.9.0 或更新版本实例支持 ContextSearch。
用户名	输入实例的用户名。说明此参数仅当数据库类型为云搜索服务或 Milvus 时可见。
密码	输入实例的密码。说明此参数仅当数据库类型为云搜索服务或 Milvus 时可见。
向量桶	从下拉列表中选择要使用的向量桶。如需创建新的向量桶，请参见创建向量桶。说明此参数仅当数据库类型为 TOS Vectors 时可见。
选择模型/推理服务	选择已经创建推理服务下关联的模型。如果需要新的推理服务，可参见创建自定义推理服务。
API Key	选择用于调用模型的 API Key。如果需要新的 API Key，可参见创建 API Key。
字段配置	配置字段后，后续可对上传的检索文件进行数据结构化处理及搜索过滤。

重排序

知识库场景

图片搜索场景

视频搜索场景

将知识检索阶段的召回结果输入到重排序模型，进行语义级重排序，输出得分最高的 Top N 的文档。

说明

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

参数	说明
选择模型/推理服务	选择已经创建推理服务下关联的模型。如果需要新的推理服务，可参见创建自定义推理服务。
API Key	选择用于调用模型的 API Key。如果需要新的 API Key，可参见创建 API Key。

知识问答

知识库场景

图片搜索场景

视频搜索场景

参数	说明
检索策略	选择知识库的检索策略。快速：以更快速度完成检索，适合追求效率的轻量任务。标准：在速度与质量之间取得稳健平衡，适用于大多数日常需求。深度：提供更全面、更细致的深度推理，为高要求场景打造的高精度模式。
返回数量	设置检索返回的文档数量。

添加检索文件

场景配置完成后将自动初始化。初始化完成后可添加检索文件。

知识库场景

图片搜索场景

视频搜索场景

在检索文件区域单击添加。

在添加文件面板中，配置以下参数，然后单击确定。

参数	说明
上传/选择文件	选择对象存储或本地文档。当选择本地文档时，单击上传区域然后选择待上传的文件或将待上传的文件拖动至上传区域。
选择存储桶	选择待添加文件所在的存储桶。如无可用存储桶，请先创建存储桶。具体操作，请参见创建存储桶。
目标文件夹	选择待添加文件所在的文件夹。
结构化字段	输入字段的名称和值。如需新的结构化字段，单击添加字段。
导入配置	选择是否为导入的文件开启 OCR 模型。开启后，模型将从图片或扫描文档中识别并提取文字信息，可增强检索效果。子参数如下：选择模型/推理服务：选择已经创建推理服务下关联的模型。如果需要新的推理服务，可参见创建自定义推理服务。 API Key：选择用于调用模型的 API Key。如果需要新的 API Key，可参见创建 API Key。

说明

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

调试预览

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

说明

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

查看日志

您可以在场景开发页面单击日志查询查看场景的日志。支持按照时间段、日志等级、文件和关键词过滤日志。

查看配置信息

您可以在场景开发页面单击配置信息，查看场景的基本信息、发布资源、存储位置、Embedding 和访问信息。

分类	详细信息
基本信息	包含场景的名称、描述和创建时间。
发布资源	包含场景的状态、资源类型、规格和节点数量。您可以单击停止、重启或变配执行相应操作。
存储位置	包含场景所属服务以及实例名称/ID。
Embedding	包含场景使用的 Embedding 模型和关联的推理服务。
访问信息	包含场景的私有网络、可用区、子网、私网访问状态、公网访问状态、私网访问地址和公网访问地址。开启私网访问或公网访问后，可查看相应访问地址。

查看调用示例

您可以在场景开发页面单击调用示例查看场景的调用示例，可选择 cURL 或 Python 格式的示例。

查看监控

您可以在场景开发页面单击监控查看场景的监控信息。监控指标包括 QPS、TPS、平均响应时间和请求成功率。支持根据时间范围筛选监控信息。

发布场景

场景调试完成后，可将场景发布至线上。

在场景开发页面，单击发布。

在发布对话框中，配置以下参数，然后单击确定。

参数	说明
版本号	设置发布场景的版本。版本号规则如下：版本号不能超过 255 字符。只能包含英文字母、数字及点号（.）。不能包含连续的点号（.）。
描述	可选。设置发布场景的描述，最多支持 50 个字符。
规格	从下拉列表中选择资源规格。
节点数量	设置节点数量。节点数量可设范围为 2~512。

版本管理

每次发布都需生成一个新版本。您可以单击版本管理查看已发布的版本信息并视情况删除不需要的版本。

注意

使用中的版本无法删除。

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

最近更新时间：2026.07.09 11:37:39

这个页面对您有帮助吗？

有用

无用