✅如何定义一个好的Function（Tool）？

想让模型会调用工具，就需要先定义好工具，他才知道调用哪个，但是模型怎么知道该调用哪个工具的呢？这就需要我们在定义工具的时候遵守一些原则，让模型可以更好地理解这些工具了。

给大家分享一些经验，按照这个标准来定义工具会让你少踩很多坑。



函数名称、描述、参数描述要清晰明了。

在我们之前自己写代码的时候，定义一个接口的时候，不太关注注释的，对于方法的作用以及入参、出参很少描述的很清楚。主要是因为这些方法使我们自己写代码调用，虽然注释不清楚，但是自己能清楚就行了。

可是如果是让大模型决策模型调用的话，如果方法名称，参数描述不写清楚的话，大模型肯定是不知道他具体的作用的。所以一定要描述清楚这个方法是干什么的，每一个参数的作用和格式都要写清楚。



扁平化的参数结构

尽量避免参数的多层嵌套，因为参数的嵌套都是通过json来描述的，如果层级比较多，很容易就搞错了。所以，尽可能扁平化的平铺参数。



不要有太多参数

虽然我们建议扁平化参数，但是也要控制参数的数量，千万不要特别多参数，函数参数的数量最好不超过 3-4 个。尤其是一些默认的参数，这些就不要定义在接口中了，在服务端自己补全就行了。

还有就是一些和鉴权有关的参数，也不要让模型传递，应该自己做好鉴权的事宜，而不是依赖模型。





可以使用枚举限定参数

为了防止模型捏造参数值，比如某一个参数的值传什么，我们可以把他从问答题变成选择题，实际在开发中，我们可以使用 enum 关键字明确列出所有可能值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
{
  "type": "function",
  "name": "search_restaurants",
  "description": "提供餐馆搜索功能",
  "parameters":
  {
    "type": "object",
    "properties":
    {
      "location":
      {
        "type": "string",
        "description": "The location to search."
      },
      "good_for":
      {
        "type": "string",
        "description": "What the restaurant is well-suited for.",
        "enum":
        [
          "families",
          "romantic_dating",
          "business_meeting",
          "large_groups",
          "solo_dining"
        ],
        #"families"明确对应了“带孩子”
      }
    },
    "required":
    [
      "location"
    ]
  }
}



对于good_for这个字段，我们通过enum规定了可选值的范围，模型会成功地将“能带孩子”映射到 good_for: "families"。



适当给一些few shot

对于参数的描述，可以通过一些few shot来辅助模型更好的理解该如何传参。

或者在工具定义完之后，也可以给一些关于工具的调用的示例。



友好的错误提示

之前我们自己写代码的时候，会经常做前置的参数检查，在检查不同过的时候，可能就简单的抛个异常。

再给大模型定义工具的时候，方法内部如果出现异常和错误，要尽可能给出友好的提示，让模型能读懂错误的原因，尤其是一些参数格式错误之类的，方便模型调整和优化。



返回值要让大模型能理解

返回值一定要清晰明了，包括返回值的参数的定义，要让模型能看懂返回的内容，他才知道这些东西他怎么用。



不要做复杂的工具调用链

多轮对话的时候，工具的调用结果是不会自动传递到下一轮的，所以我们需要自己传递，这就要求我们不要做很复杂去的工具链。如果确实有很多事情要做，可以把几个相关的工具封装一下，封装到一个工具中，这样也更加方便模型调用。