文档首页/ 智果(AgentArts)智能体平台/ 常见问题/ 插件相关/ 如何配置插件请求参数中的默认值?
更新时间:2026-08-03 GMT+08:00
分享

如何配置插件请求参数中的“默认值”

配置请求参数的“默认值”可有效避免大模型运行时因插件参数值缺失而导致的报错。

同时,针对值较为稳定的参数,设置其“默认值”且隐藏其可见性可减少大模型的无效判断,从而提高插件调用效率。

您可以在插件工具的请求头(Header)、请求体(Body)和查询参数(Query)中添加参数并配置“默认值”。下面以在请求头(Header)中为参数配置默认值为例。

操作步骤

  1. 登录AgentArts智能体平台
  2. 选择左侧导航栏中“开发中心 > 组件库”,在“插件”页签中,单击需要配置参数的插件卡片。
  3. 在"工具列表"中找到目标工具,单击操作列的“编辑”
  4. 在请求参数列表中,定位到目标参数的“默认值”列,按以下规则填写:

    • API接口该参数已有默认值:在此列填入该默认值。大模型运行时将自动使用该值,无需人工干预。
    • API接口该参数无默认值:无需配置。大模型运行时,需由调用方手动传入该参数值。

    在智能体开发平台中配置插件工具的详细信息,请参考基于API创建插件

    如果请求参数设置了默认值,大模型运行时需使用不同的参数值,可返回插件工具的请求参数列表,重新修改该参数的“默认值”

    图1 添加默认值

相关文档