文档首页/ 智能体平台 Versatile/ 常见问题/ 插件/ 如何配置插件请求参数中的默认值?
更新时间:2025-11-07 GMT+08:00
分享

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

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

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

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

  1. 登录Versatile智能体平台,在左侧导航栏“个人空间”区域,选择进入所需空间。

    如果已选择团队空间,界面显示为实际的团队空间名称,而非“个人空间”。

    图1 选择团队空间

  2. 在左侧导航栏中选择“开发中心 > 组件库 > 我的插件”,单击需要配置参数的插件。
  3. “插件详情”页面中,单击“工具信息”页签。
  4. “工具信息”页签中,单击左侧的“新建”

    如果您需要为已存在的工具设置参数的默认值,可以在工具列表中找到该工具,然后单击操作列中的“编辑”。

  5. “添加工具”弹框中输入工具的基本信息,并单击“下一步”

    如果在编辑已有工具时不需要修改这些基本信息,可以直接单击“下一步”。

  6. 您可以在请求参数列表的默认值列中为参数设置默认值。

    如果调用的API接口中的请求参数有默认值,您需要在“默认值”列中填写该参数的默认值。这样,在大模型运行时,将自动使用这些默认值。如果请求参数没有默认值,您可以不用配置。在这种情况下,当大模型运行时,需要手动输入这些参数的值。

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

    如果请求参数设置了默认值,但在大模型运行时需要修改该值,您可以在插件工具的请求参数中重新设置该参数的默认值。

    图2 添加默认值

相关文档