完成 Agentic Search 场景初始化后，您可以根据业务需求进一步配置场景能力，包括添加 Skill、MCP 和数据源，配置访问权限与全局变量，并通过对话功能验证场景效果。本文介绍如何配置 Agentic Search 场景。 ## 前提条件已创建并初始化 Agentic Search 场景。具体操作，请参见[创建场景](https://www.volcengine.com/docs/86958/2105957)和[初始化 Agentic Search 场景](https://www.volcengine.com/docs/86958/2551142)。 ## 操作步骤 ### 场景对话 1. 登录 [ContextSearch 控制台](https://console.volcengine.com/context-search)。 2. 在顶部导航栏，选择目标项目和地域。 3. 在左侧导航栏选择**我的场景**，然后单击目标 Agentic Search 场景。 4. 在对话框中输入您的问题或需求，然后单击发送按钮。系统将根据您配置的模型、Skill、MCP 和数据源输出结果。具体操作，请参见后续章节。 ### 查看 Trace 您可以开启 Trace 功能，查看输出的调用链路和详细执行信息，帮助您分析请求的处理过程。开启 Trace 功能的操作，请参见[查看配置信息](https://docs.volcengine.com/docs/86958/2552714)。开启 Trace 功能后，您可在输出结果下方单击 **Trace** 跳转到 OpenSearch 实例的 Dashboards 页面。登录后可查看 Trace 数据。具体操作，请参见[通过 Dashboards 查询 Agent Traces](https://docs.volcengine.com/docs/6465/2598388)。

说明

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

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

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

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

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

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

### Skill 管理 Skill 为 Agentic Search 提供特定任务处理能力。您可以根据业务需求为场景添加或移除 Skill，扩展场景的工具调用能力，以支持更复杂的搜索任务。 #### 创建 Skill 1. 在左侧导航栏选择 **Skills**，然后在 **Skills** 页面右上角单击**创建 Skill**。 2. 在**创建 Skill** 对话框中，单击文件上传区域并选择 Skill 文件或将 Skill 文件拖动至文件上传区域。

说明

仅支持 ZIP 格式文件。

文件大小上限为 100 MB。

3. 配置以下参数，然后单击**确定**。 |参数 |说明 | |---|---| |名称 |设置 Skill 的名称。命名规则如下：

* 只能包含字母、数字、点号（.）、下划线（_）和中划线（\-）。

* 必须以字母或数字开头。 | |描述（可选） |设置场景的描述。 | #### 后续操作创建 Skill 之后，您还可以在 **Skills** 页面上下载、编辑或删除 Skill。 ### MCP 管理 MCP 用于将 Agentic Search 与外部工具或服务连接，为场景提供更丰富的能力。您可以根据业务需求创建和管理 MCP 服务，使 Agent 在执行搜索任务时能够自主调用外部工具完成数据查询、系统操作等任务。 #### 创建 MCP 1. 在左侧导航栏选择 **MCP**，然后在 **MCP** 页面右上角单击**创建 MCP**。 2. **在创建 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 在执行搜索任务时能够检索相关数据，并结合检索结果生成更准确的回答。 #### 绑定数据源 1. 在左侧导航栏选择**数据源**，然后在**数据源**页面右上角单击**绑定数据源**。 2. 在**选择数据来源**面板中，单击目标数据源卡片中的 **+** ，然后单击**确定**。

说明

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

#### 解绑数据源当您不再需要使用绑定的数据源时，可在已绑定数据源卡片中单击**解绑**，然后单击**确定**来将数据源解除绑定。 ### 访问权限管理访问权限用于控制 Agentic Search 场景的调用范围。您可以根据业务需求配置场景的访问权限，确保只有经过授权的用户或应用能够访问和调用该场景。在左侧导航栏选择**访问权限**，然后**用户权限**页面上查看已授权访问的用户。如果不希望某个用户继续访问场景，可在该用户的**操作**列单击**删除**，然后单击**确定**来删除该用户。 ### 全局变量管理全局变量用于统一管理 Agentic Search 场景运行过程中使用的公共参数。您可以根据业务需求创建和管理全局变量，并在 Prompt、Skill、MCP 等配置中引用，提高配置复用性和维护效率。 #### 创建变量 1. 在左侧导航栏选择**全局变量**，然后在**全局变量**页面右上角单击**创建变量**。 2. 在创建变量对话框中，配置以下参数，然后单击**确定**。 |参数 |说明 | |---|---| |变量名 |设置全局变量的名称 | |变量值 |设置全局变量的值。 | |加密（可选） |勾选后，变量值将隐藏，可防止敏感信息泄露。 | #### 后续操作创建全局变量之后，您还可以在全局变量页面上编辑或删除变量。

上下文搜索