本文介绍 Copilot 应用功能路由的定义和使用方法。
什么是功能路由
功能路由是 Copilot 应用的一种意图技能操作,主要用于 Copilot 应用被集成的场景。当用户输入匹配到的意图绑定了功能路由,则展示功能路由的卡片,用户点击卡片中的按钮则可以触发集成方注册的回调,例如跳转至一个移动端的页面。如果通过浏览器直接访问 Copilot 应用,功能路由也支持跳转用户定义的 URL。
创建功能路由
在 Copilot 应用的设计器中,打开代码选项,可添加功能路由。
功能路由配置
功能路由具有路由标识、描述、必填参数、可选参数、会话卡片等配置。
路由标识:用于集成方识别功能路由的唯一标识。
描述:功能路由描述。
必填参数:由于功能路由可被意图框架感知,为了确保意图框架调用功能路由时提取到必填参数,必填参数均为意图参数,当意图框架未提取到所有必填参数时,会进行追问而不会直接触发功能路由。
可选参数:可选参数支持用户配置是否为意图参数,意图参数表示会被意图框架感知并尝试从用户对话中提取,如不希望被意图框架提取则可以取消意图参数的配置。
会话卡片:包含标题、内容、跳转文案和默认链接,其中默认链接用于浏览器中访问 Copilot 应用时进行 URL 跳转。
配置示例如下图,需要注意的是意图参数的描述是必填项,描述的准确性将直接影响意图框架的参数提取效果。
点击功能路由设置面板中的运行按钮,可以预览功能路由卡片的效果。
意图绑定功能路由
新建一个意图,绑定操作选择对应的功能路由,则在该意图被识别后触发对应的功能路由,将生成一条卡片消息。
集成方注册功能路由回调
魔笔目前提供了 Android 和 iOS 的 Copilot SDK,用于将 Copilot 应用集成到移动端应用中,在使用 Copilot SDK 时可以注册功能路由回调,根据不同的路由标识和参数自定义处理逻辑。具体集成方式请参考 Android SDK 集成 和 iOS SDK 集成。