意图设置
概述
通过大模型回调客户预先定义好的函数，以完成特定任务，如“调大音量”、“拍照”等。大模型实时互动服务会将 Function Call 名称、参数和取值等，回调给 SDK、或者通过 HTTP发送给客户服务器，执行函数调用动作，客户在 SDK 拿到回调、服务器收到回调请求后，执行对应函数，并且可以将函数返回值返回给大模型实时互动服务。
需要注意的是，除了一些系统功能的function（音乐控制、文生图等），命中function后，模型只是输出结构化参数，扮演信息传递“通道”的角色，真正的执行需要自己的业务服务器或端侧sdk完成，因此模型不负责执行任务，也主动感知执行是否成功和执行状态。
创建Function模板
第一步，点击创建Function模板
第二步，填写基础配置，Function配置
1.基础配置
| 项目 | 填写说明 |
|---|---|
| 模板名称 | 模板名称必须唯一，支持汉字、英文字母、数字、英文格式的下划线，必须以英文字母或汉字开头，1~40个字符。 |
| 模板描述 | 可通过添加200字符以内的模板描述标记Function模板的用途，便于对模板的管理。 |
2.Function配置
可自定义function，同时我们也提供一些推荐的function。为保证function命中准确率，每一个function模版下最多可添加20个function。
推荐function
可根据场景选择对应的function，需要注意的是
1）系统内置function为系统能力，function会在云端执行。包括播放控制（play_control)、添加/删除声纹（voice_fp_add、voice_fp_remove）、文生图（image_generate），对应有声资源播放、声纹识别、文生图三个功能，以上三个功能为云端高级功能，开通之后才可搭配function执行生效。详情见内容资源播放、声纹使用、图片生成
2）系统内置的function仅支持修改例句
function填写项：
-
Function名称，描述，例句项填写
- Function名称：支持英文、数字、下划线，只能英文和下划线开头，40字符以内
- Function描述：可通过添加200字符以内的模板描述标记Function模板的用途，便于对模板的管理
- Function例句：这里关乎到意图识别的准确性，需尽量穷尽用户可能有的互动语言方式，function的命中和例句、描述填写有关
-
请求地址填写
- 发送SDK消息：填写参数名，选择参数类型，是否必填，参数描述
- HTTP协议：输入URL，为必填项
如需添加参数，点击添加参数；如需删除参数，点击右侧操作栏删除
- 如需添加Function，点击左下角添加Function
第三步，点击确定，完成创建，创建成功后可在【互动应用-大模型-Function Call】处选择已创建的Function Call。
function填写小tips
1、一个 AppID 只能绑定一个 Function 模版，因此此应用需要的所有function函数都需统一写入这一模版中
2、如果指令较少，建议将它们拆分配置。例如开灯、关灯应分别写成两个独立的 Function。
3、参数的使用：在大模型识别出用户意图后，用于向业务后端、设备端或应用逻辑传递结构化指令的参数集合。
例如：
“帮我设置一个下午 3 点的提醒”
“把灯调成暖黄色 30% 亮度”
-
并非所有 Function 都需要配置参数。例如“开灯”指令的执行结果是固定的——灯被打开，此类操作无需依赖额外信息，因此可以不设置任何参数。
但是，如果要支持“中等亮度”和“最亮”的不同开灯效果，就需要添加一个brightness（灯亮度）的参数，并为其定义两个可选枚举值：medium（中等亮度） 与 max（最亮）。
-
参数是否必填按钮：当某参数被设置为“必填”时，若用户指令未包含该参数，系统会提示用户补充；若模型命中了该 Function 但未成功解析必填参数，同样会提示补充该参数，且不会主动中断当前的函数调用流程。
- 什么情况下需要参数必填？：以“设置闹钟”为例，time （时间）是创建闹钟所必需的信息，应设为必填；而 event（提醒事件） 不影响闹钟能否被设定，因此可设为非必填。
- 参数无法命中？：当参数描述过于复杂时，模型可能无法命中参数。应对参数进行结构化描写，并可使用“强调：xxx”突出重点内容。
4、Function 例句建议尽可能填写完整、明确，以便模型准确识别意图并提升命中率。
查看或编辑已创建的Function模板
- 点击意图设置可看见Function模板列表
- 模板查找：右上角搜索栏通过模板名称或ID进行查找
- 模板删除：列表右侧操作下可点击删除
- 模板编辑：点击蓝色模板名字跳转模板详情