更新时间:2026-07-15 gmt 08:00

示例:创建联网搜索插件-j9九游会登录

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

前提条件

开通agentarts服务

准备联网搜索api

本示例使用联网搜索api实现联网搜索功能,其api接口调用示例如下。请提前,获取到的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. 登录。
  2. 在左侧导航栏中选择“开发中心 > 组件库”,在“插件”页签,单击页面右上角“创建插件”。
  3. 根据以下步骤配置插件信息。
    图1 创建插件
    表1 基本信息

    参数

    填写说明

    基础信息

    openapi导入

    不使用

    名称

    填写“联网搜索”。

    描述

    填写“通过搜索引擎获取互联网实时信息,包括新闻、百科、网页内容等”。

    插件图标

    使用默认。

    仅我可见

    关闭

    配置信息

    插件url

    填写“https://qianfan.baidubce.com/v2/ai_search”。

    图2 填写示例

    鉴权方式

    选择“api key”。

    密钥位置

    选择“header”。

    参数列表

    新增一参数,参数名称填写“authorization”,参数值为bearer 格式,准备联网搜索api中获取的api key进行替换。

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

步骤2:创建工具

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

    参数

    参数说明

    基础信息

    名称

    填写“网络搜索”。

    描述

    填写“通过搜索引擎获取互联网实时信息,包括新闻、百科、网页内容等”。

    图3 填写示例

    配置信息

    工具path

    请求方式

    请求参数

    请求头(header)

    请求体(body)

    使用平台提供的自动解析功能,无需手动填写参数。

    单击“导入并解析”,输入准备联网搜索api中的接口示例后,单击“确定”。注意示例的请提前进行替换。

    在请求头(header)中将识别到的参数设置为“必填”。

    请求体(body)需要参考图5进行设置(如果自动解析结果与下图不符,请按照图片进行设置)。

    图4 请求头(header)填写示例
    图5 请求体(body)填写示例

    响应参数

    在下方参数列表中,添加一行参数。参数名称为“references”,描述填写“输出信息”,参数类型选择“array”。

    图6 填写示例
  2. 配置完单击“完成”。后续调试步骤请参考步骤3:调试发布插件

步骤3:调试发布插件

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

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

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

    鉴权信息:确认header中的authorization参数是否正确填写了bearer 格式,且key有效。

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

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

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

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

  1. 在“智能体管理 > 单智能体”页面,单击“创建智能体”。
  2. 名称、描述可填写为“联网搜索智能体”,单击“立即创建”。
    图8 创建单智能体应用
  3. “单智能体配置”页面,根据以下信息进行配置。
    表3 单智能体配置信息

    参数

    填写说明

    提示词

    输入“联网搜索”后,使用ai功能智能优化提示词,系统会自动填入优化后的内容

    图9 配置提示词

    模型

    在模型配置区域,选择一个可用的大模型。平台提供200万免费tokens,超出后调用大模型将产生费用,请根据您的业务需求选择合适的模型规格。

    图10 配置模型

    插件

    在配置页面中间,添加一个联网搜索插件。

    图11 配置插件

    其余参数

    使用默认,不进行设置。

  4. 在配置页面右侧,可以进行智能体调试。

    在对话框中输入一个需要实时信息的问题(例如“最新的新闻有哪些”)。如果智能体返回的回答中包含具体的实时数据、网页链接或新闻摘要,说明联网搜索插件已成功挂载并生效。

相关文档

网站地图