文档中心

上下文搜索

Agentic Search

配置 Agentic Search 场景

完成 Agentic Search 场景初始化后，您可以根据业务需求进一步配置场景能力，包括添加 Skill、MCP 和数据源，配置访问权限与全局变量，并通过对话功能验证场景效果。本文介绍如何配置 Agentic Search 场景。

前提条件

已创建并初始化 Agentic Search 场景。具体操作，请参见创建场景和初始化 Agentic Search 场景。

操作步骤

场景对话

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

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

在对话框中输入您的问题或需求，然后单击发送按钮。系统将根据您配置的模型、Skill、MCP 和数据源输出结果。具体操作，请参见后续章节。

查看 Trace

您可以开启 Trace 功能，查看输出的调用链路和详细执行信息，帮助您分析请求的处理过程。开启 Trace 功能的操作，请参见查看配置信息。

开启 Trace 功能后，您可在输出结果下方单击 Trace 跳转到 OpenSearch 实例的 Dashboards 页面。登录后可查看 Trace 数据。具体操作，请参见通过 Dashboards 查询 Agent Traces。

说明

Trace 配置当前为加白功能，如需使用，请提交工单申请。

开启 Trace 功能需提前在云搜索服务中完成以下操作：

创建 OpenSearch 3.3 实例。具体操作，请参见创建实例。

开启托管 OTLP 功能。具体操作，请参见开启托管 OTLP。

为托管 OTLP 开启私网接入点，并将私有网络设置为当前 Agentic Search 场景所使用的私有网络。具体操作，请参见开启私网接入点。

开启 Trace 功能后，您可以在 OpenSearch Dashboards 中查看可观测数据。具体操作，请参见通过 Dashboards 查询 Agent Traces。

Skill 管理

Skill 为 Agentic Search 提供特定任务处理能力。您可以根据业务需求为场景添加或移除 Skill，扩展场景的工具调用能力，以支持更复杂的搜索任务。

创建 Skill

在左侧导航栏选择 Skills，然后在 Skills 页面右上角单击创建 Skill。

在创建 Skill 对话框中，单击文件上传区域并选择 Skill 文件或将 Skill 文件拖动至文件上传区域。

说明

仅支持 ZIP 格式文件。

文件大小上限为 100 MB。

配置以下参数，然后单击确定。

参数	说明
名称	设置 Skill 的名称。命名规则如下：只能包含字母、数字、点号（.）、下划线（_）和中划线（-）。必须以字母或数字开头。
描述（可选）	设置场景的描述。

后续操作

创建 Skill 之后，您还可以在 Skills 页面上下载、编辑或删除 Skill。

MCP 管理

MCP 用于将 Agentic Search 与外部工具或服务连接，为场景提供更丰富的能力。您可以根据业务需求创建和管理 MCP 服务，使 Agent 在执行搜索任务时能够自主调用外部工具完成数据查询、系统操作等任务。

创建 MCP

在左侧导航栏选择 MCP，然后在 MCP 页面右上角单击创建 MCP。

在创建 MCP 面板中，配置以下参数，然后单击确定。

参数	说明
MCP 名称	设置 MCP 的名称。命名规则如下：只能包含字母、数字、点号（.）、下划线（_）和中划线（-）。必须以字母或数字开头。
描述（可选）	设置场景的描述。
MCP 配置	在代码框中输入 MCP 配置。示例字段说明如下： mcpServers：MCP Server 配置集合，可配置一个或多个 MCP Server。 server-name：MCP Server 的名称。 command：启动 MCP Server 的命令。 args：启动命令的参数列表。 env：启动 MCP Server 时注入的环境变量。 API_KEY：MCP Server 提供访问外部服务所需的 API Key。说明不同 MCP Server 支持的启动命令、参数及环境变量可能有所不同，请参考对应 MCP Server 的官方文档进行配置。

后续操作

创建 MCP 之后，您还可以在 MCP 页面上编辑或删除 MCP。

数据源管理

数据源为 Agentic Search 提供检索和问答所需的业务数据。您可以根据业务需求为场景添加和管理数据源，使 Agent 在执行搜索任务时能够检索相关数据，并结合检索结果生成更准确的回答。

绑定数据源

在左侧导航栏选择数据源，然后在数据源页面右上角单击绑定数据源。

在选择数据来源面板中，单击目标数据源卡片中的 +，然后单击确定。

说明

您可以重复此操作绑定多个数据源。

解绑数据源

当您不再需要使用绑定的数据源时，可在已绑定数据源卡片中单击解绑，然后单击确定来将数据源解除绑定。

访问权限管理

访问权限用于控制 Agentic Search 场景的调用范围。您可以根据业务需求配置场景的访问权限，确保只有经过授权的用户或应用能够访问和调用该场景。

在左侧导航栏选择访问权限，然后用户权限页面上查看已授权访问的用户。如果不希望某个用户继续访问场景，可在该用户的操作列单击删除，然后单击确定来删除该用户。

全局变量管理

全局变量用于统一管理 Agentic Search 场景运行过程中使用的公共参数。您可以根据业务需求创建和管理全局变量，并在 Prompt、Skill、MCP 等配置中引用，提高配置复用性和维护效率。

创建变量

在左侧导航栏选择全局变量，然后在全局变量页面右上角单击创建变量。

在创建变量对话框中，配置以下参数，然后单击确定。

参数
说明
变量名
设置全局变量的名称
变量值
设置全局变量的值。
加密（可选）
勾选后，变量值将隐藏，可防止敏感信息泄露。

后续操作

创建全局变量之后，您还可以在全局变量页面上编辑或删除变量。

最近更新时间：2026.09.17 16:42:45

这个页面对您有帮助吗？

有用

无用

参数	说明
变量名	设置全局变量的名称
变量值	设置全局变量的值。
加密（可选）	勾选后，变量值将隐藏，可防止敏感信息泄露。