# 示例：创建联网搜索插件 本示例将介绍如何通过AgentArts智能体开发平台创建联网搜索插件，并进行插件的调试、发布，最终应用到Agent中。 #### 前提条件 - 已[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts0/agentarts_04_0000.html)。 - 登录用户为空间所有者、空间管理员、开发工程师，详细信息请参考[管理团队空间成员](https://support.huaweicloud.com/usermanual-agentarts0/agentarts_05_0216.html)。 #### 准备联网搜索API 本示例使用联网搜索API实现联网搜索功能，其API接口调用示例如下。请提前[创建API Key](https://console.bce.baidu.com/iam/#/iam/apikey/list)，获取到的API Key替换下方代码的\。 ``` 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/versatile/#/home/overview)，在左侧导航栏"个人空间"区域，选择目标空间。 2. 在左侧导航栏中选择"开发中心 \> 组件库"，在"插件"页签，单击页面右上角"创建插件"。 图1创建插件 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569422325.png) 3. 选择"API类型"的插件，然后根据以下步骤配置插件信息。 表1基本信息 | 参数 | 填写说明 | |:---|:---| | 插件类型 | 选择"API类型"。 | | 导入并解析 | 不使用 | | 插件图标 | 使用默认。 | | 名称 | 填写"联网搜索"。 | | 描述 | 填写"通过搜索引擎获取互联网实时信息，包括新闻、百科、网页内容等"。 | | 仅我可见 | 关闭 | 4. 单击"下一步"，在"配置信息"步骤中配置插件信息，请参照[表2]完成配置。 表2配置信息 | 参数 | 填写说明 | |:---|:---| | 协议 | 选择"https"。 | | 服务域名 | 填写"qianfan.baidubce.com"。 | | 基准URL | 填写"/v2/ai_search"，注意仅有一个/。 图2填写示例 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538542560.png) | | 权限校验 | 选择"API Key"。 | | 密钥位置 | 选择"Header"。 | | 参数列表 | 新增一参数，参数名称填写"Authorization"，参数值为Bearer \格式，\用[准备联网搜索API]中获取的API Key进行替换。 图3填写示例 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569342313.png) | 5. 配置完单击"确定"。平台会自动跳转至工具信息页面，请参考[步骤2：创建工具]为插件添加工具。 #### 步骤2：创建工具 1. 在"工具信息"页面，单击"创建工具"，请参照[表3]完成工具配置。 表3工具配置 | 参数 | 参数说明 | |:---|:---| | 展示名称 | 填写"网络搜索"。 | | 名称 | 填写"web_search"。 | | 描述 | 填写"通过搜索引擎获取互联网实时信息，包括新闻、百科、网页内容等"。 图4填写示例 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569422383.png) | | 工具URL 请求参数 请求头(Header) 请求体(Body) | **使用平台提供的自动解析功能，无需手动填写参数。** 单击"导入并解析"，输入[准备联网搜索API]中的接口示例后，单击"确定"。注意示例的\请提前进行替换。 在请求头(Header)中将识别到的参数设置为"必填"。 请求体(Body)需要参考[图6]进行设置（如果自动解析结果与下图不符，请按照图片进行设置）。 图5请求头(Header)填写示例 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569342353.png) 图6请求体(Body)填写示例 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569422261.png) | | 响应参数 | 在下方参数列表中，添加一行参数。参数名称为"references"，描述填写"输出信息"，参数类型选择"Array\"。 图7填写示例 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538382688.png) | 2. 配置完单击"确定"。后续调试步骤请参考[步骤3：调试发布插件]。 #### 步骤3：调试发布插件 工具创建完成后，工具列表会新增一行"待调试"状态的工具。工具只有调试后对应的插件才可以发布使用。 1. 在工具列表中，单击"调试"按钮，输入问题后，单击"开始调试"。 图8输入问题、调试工具 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569422273.png) 2. 调试成功后，工具状态随之变为"成功"，此时可单击右上角"发布"，发布插件。 #### 步骤4：在单智能体中使用插件 插件创建完成后，它仅仅是一个静态的资产。要让它真正发挥价值，需要将其挂载到一个具备思考能力的智能体身上。 在本小节中，将创建一个最基础的单智能体应用。您无需进行复杂的逻辑编排，只需简单的配置，即可让智能体获得联网搜索的能力，体验它如何打破模型训练数据的时效限制，自主获取互联网上的最新信息。 1. 返回AgentArts智能体开发平台总览页，单击"创建智能体"。 图9创建应用 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538382662.png) 2. 在创建应用页面选择"单智能体"，名称、描述可填写为"联网搜索智能体"，单击"立即创建"。 图10创建单智能体应用 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538382600.png) 3. 在"单智能体配置"页面，根据以下信息进行配置。 表4单智能体配置信息 | 参数 | 填写说明 | |:---|:---| | 提示词 | 输入"联网搜索"后，使用AI功能智能优化提示词，并填入优化好的提示词。 图11配置提示词 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569342267.png) | | 模型 | 在模型配置区域，选择一个可用的大模型。 图12配置模型 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569422237.png) | | 插件 | 在配置页面中间，添加一个联网搜索插件。 图13配置插件 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002538382538.png) | | 其余参数 | 使用默认，不进行设置。 | 4. 在配置页面右侧，可以进行智能体调试。 图14调试单智能体 ![](https://support.huaweicloud.com/usermanual-agentarts0/zh-cn_image_0000002569422317.png)