# 示例：创建联网搜索插件 本示例将介绍如何通过AgentArts智能体平台创建联网搜索插件，并进行插件的调试、发布，最终应用到Agent中。 #### 前提条件 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)。 #### 准备联网搜索API 本示例使用联网搜索API实现联网搜索功能，其API接口调用示例如下。请提前[创建API Key](https://console.bce.baidu.com/iam/#/iam/apikey/list)，获取到的API Key用于替换下方代码中的\。 调用该接口可能会产生第三方API调用费用，建议在使用前了解相关费率。 ``` curl --location --request POST 'https://qianfan.baidubce.com/v2/ai_search/web_search' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data-raw '{ "messages": [ { "role": "user", "content": "什么是Agent" } ] }' ``` #### 步骤1：创建插件 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏中选择"开发中心 \> 组件库"，在"插件"页签，单击页面右上角"创建插件"。 3. 根据以下步骤配置插件信息。 图1创建插件 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790064.png "点击放大") 表1基本信息 | 参数 || 填写说明 | |:---|---|:---| | 基础信息 | OpenAPI导入 | 不使用 | | 基础信息 | 名称 | 填写"联网搜索"。 | | 基础信息 | 描述 | 填写"通过搜索引擎获取互联网实时信息，包括新闻、百科、网页内容等"。 | | 基础信息 | 插件图标 | 使用默认。 | | 基础信息 | 仅我可见 | 关闭 | | 配置信息 | 插件URL | 填写"https://qianfan.baidubce.com/v2/ai_search"。 图2填写示例 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549557.png "点击放大") | | 配置信息 | 鉴权方式 | 选择"API Key"。 | | 配置信息 | 密钥位置 | 选择"Header"。 | | 配置信息 | 参数列表 | 新增一参数，参数名称填写"Authorization"，参数值为Bearer \格式，\用[准备联网搜索API]中获取的API Key进行替换。 | 4. 单击"下一步 创建工具"，进入工具创建页面，或单击"完成插件创建"。如果选择后者，后续可继续在插件详情中添加工具。请参考[步骤2：创建工具]为插件添加工具。 #### 步骤2：创建工具 1. 在"创建信息"页面中，请参照[表2]完成工具配置。 表2工具配置 | 参数 || 参数说明 | |:---|---|:---| | 基础信息 | 名称 | 填写"网络搜索"。 | | 基础信息 | 描述 | 填写"通过搜索引擎获取互联网实时信息，包括新闻、百科、网页内容等"。 图3填写示例 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790072.png "点击放大") | | 配置信息 | 工具path 请求方式 请求参数 请求头(Header) 请求体(Body) | **使用平台提供的自动解析功能，无需手动填写参数。** 单击"导入并解析"，输入[准备联网搜索API]中的接口示例后，单击"确定"。注意示例的\请提前进行替换。 在请求头(Header)中将识别到的参数设置为"必填"。 请求体(Body)需要参考[图5]进行设置（如果自动解析结果与下图不符，请按照图片进行设置）。 图4请求头(Header)填写示例 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389667.png "点击放大") 图5请求体(Body)填写示例 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549565.png "点击放大") | | 配置信息 | 响应参数 | 在下方参数列表中，添加一行参数。参数名称为"references"，描述填写"输出信息"，参数类型选择"Array\"。 图6填写示例 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549561.png "点击放大") | 2. 配置完单击"确定"。后续调试步骤请参考[步骤3：调试发布插件]。 #### 步骤3：调试发布插件 工具创建完成后，工具列表会新增一行"待调试"状态的工具。工具只有调试后对应的插件才可以发布使用。 1. 在工具列表中，单击"调试"按钮，输入问题后，单击"开始调试"。 如果调试结果显示失败，请检查以下几点： 鉴权信息：确认Header中的Authorization参数是否正确填写了Bearer \格式，且Key有效。 参数匹配：确认请求参数是否与联网搜索API要求的一致。 图7输入问题、调试工具 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687949910.png "点击放大") 2. 调试成功后，工具状态随之变为"成功"，此时可单击右上角"发布"，发布插件。 #### 步骤4：在单智能体中使用插件 插件创建完成后，它只是一个静态的资产。要使其真正发挥价值，需要将其挂载到一个具备思考能力的智能体上。 在本小节中，将创建一个最基础的单智能体应用。您无需编排复杂逻辑，只需简单配置，即可让智能体获得联网搜索的能力，体验它如何打破模型训练数据的时效限制，自主获取互联网上的最新信息。 1. 在"智能体管理 \> 单智能体"页面，单击"创建智能体"。 2. 名称、描述可填写为"联网搜索智能体"，单击"立即创建"。 图8创建单智能体应用 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687790076.png "点击放大") 3. 在"单智能体配置"页面，根据以下信息进行配置。 表3单智能体配置信息 | 参数 | 填写说明 | |:---|:---| | 提示词 | 输入"联网搜索"后，使用AI功能智能优化提示词，系统会自动填入优化后的内容。 图9配置提示词 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549553.png "点击放大") | | 模型 | 在模型配置区域，选择一个可用的大模型。平台提供200万免费Tokens，超出后调用大模型将产生费用，请根据您的业务需求选择合适的模型规格。 图10配置模型 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549569.png "点击放大") | | 插件 | 在配置页面中间，添加一个联网搜索插件。 图11配置插件 ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549545.png "点击放大") | | 其余参数 | 使用默认，不进行设置。 | 4. 在配置页面右侧，可以进行智能体调试。 在对话框中输入一个需要实时信息的问题（例如"最新的新闻有哪些"）。如果智能体返回的回答中包含具体的实时数据、网页链接或新闻摘要，说明联网搜索插件已成功挂载并生效。