示例：创建联网搜索插件

本示例将介绍如何通过AgentArts智能体平台创建联网搜索插件，并进行插件的调试、发布，最终应用到Agent中。

前提条件

准备联网搜索API

本示例使用联网搜索API实现联网搜索功能，其API接口调用示例如下。请提前创建API Key，获取到的API Key替换下方代码的<AppBuilder API Key>。

调用该接口可能会产生第三方API调用费用，建议在使用前了解相关费率。

curl --location --request POST 'https://qianfan.baidubce.com/v2/ai_search/web_search' \
--header 'Authorization: Bearer <AppBuilder API Key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "messages": [
    {
      "role": "user",
      "content": "什么是Agent"
    }
  ]
}'

步骤1：创建插件

登录AgentArts智能体平台。
在左侧导航栏中选择“开发中心 > 组件库”，在“插件”页签，单击页面右上角“创建插件”。

根据以下步骤配置插件信息。

图1 创建插件

表1 基本信息
参数		填写说明
基础信息	OpenAPI导入	不使用
	名称	填写“联网搜索”。
	描述	填写“通过搜索引擎获取互联网实时信息，包括新闻、百科、网页内容等”。
	插件图标	使用默认。
	仅我可见	关闭
配置信息	插件URL	填写“https://qianfan.baidubce.com/v2/ai_search”。图2 填写示例
	鉴权方式	选择“API Key”。
	密钥位置	选择“Header”。
	参数列表	新增一参数，参数名称填写“Authorization”，参数值为Bearer <AppBuilder API Key>格式，<AppBuilder API Key>用准备联网搜索API中获取的API Key进行替换。

单击“下一步创建工具”，进入工具创建页面，或单击“完成插件创建”。如果选择后者，后续可继续在插件详情中添加工具。请参考步骤2：创建工具为插件添加工具。

步骤2：创建工具

在“创建信息”页面中，请参照表2完成工具配置。

表2 工具配置
参数		参数说明
基础信息	名称	填写“网络搜索”。
基础信息	描述	填写“通过搜索引擎获取互联网实时信息，包括新闻、百科、网页内容等”。图3 填写示例
配置信息	工具path 请求方式请求参数请求头(Header) 请求体(Body)	使用平台提供的自动解析功能，无需手动填写参数。单击“导入并解析”，输入准备联网搜索API中的接口示例后，单击“确定”。注意示例的<AppBuilder API Key>请提前进行替换。在请求头(Header)中将识别到的参数设置为“必填”。请求体(Body)需要参考图5进行设置（如果自动解析结果与下图不符，请按照图片进行设置）。图4 请求头(Header)填写示例图5 请求体(Body)填写示例
配置信息	响应参数	在下方参数列表中，添加一行参数。参数名称为“references”，描述填写“输出信息”，参数类型选择“Array<String>”。图6 填写示例

配置完单击“完成”。后续调试步骤请参考步骤3：调试发布插件。

步骤3：调试发布插件

工具创建完成后，工具列表会新增一行“待调试”状态的工具。工具只有调试后对应的插件才可以发布使用。

在工具列表中，单击“调试”按钮，输入问题后，单击“开始调试”。

如果调试结果显示失败，请检查以下几点：

鉴权信息：确认Header中的Authorization参数是否正确填写了Bearer <AppBuilder API Key>格式，且Key有效。

参数匹配：确认请求参数是否与联网搜索API要求的一致。
图7 输入问题、调试工具
调试成功后，工具状态随之变为“成功”，此时可单击右上角“发布”，发布插件。

步骤4：在单智能体中使用插件

插件创建完成后，它仅仅是一个静态的资产。要让它真正发挥价值，需要将其挂载到一个具备思考能力的智能体身上。

在本小节中，将创建一个最基础的单智能体应用。您无需进行复杂的逻辑编排，只需简单的配置，即可让智能体获得联网搜索的能力，体验它如何打破模型训练数据的时效限制，自主获取互联网上的最新信息。

在“智能体管理 > 单智能体”页面，单击“创建智能体”。
名称、描述可填写为“联网搜索智能体”，单击“立即创建”。

图8 创建单智能体应用

在“单智能体配置”页面，根据以下信息进行配置。

表3 单智能体配置信息
参数	填写说明
提示词	输入“联网搜索”后，使用AI功能智能优化提示词，系统会自动填入优化后的内容。图9 配置提示词
模型	在模型配置区域，选择一个可用的大模型。平台提供200万免费Tokens，超出后调用大模型将产生费用，请根据您的业务需求选择合适的模型规格。图10 配置模型
插件	在配置页面中间，添加一个联网搜索插件。图11 配置插件
其余参数	使用默认，不进行设置。