功能路由

本文介绍 Copilot 应用功能路由的定义和使用方法。

什么是功能路由

功能路由是 Copilot 应用的一种意图技能操作,主要用于 Copilot 应用被集成的场景。当用户输入匹配到的意图绑定了功能路由,则展示功能路由的卡片,用户点击卡片中的按钮则可以触发集成方注册的回调,例如跳转至一个移动端的页面。如果通过浏览器直接访问 Copilot 应用,功能路由也支持跳转用户定义的 URL。

创建功能路由

在 Copilot 应用的设计器中,打开代码选项,可添加功能路由。

image

功能路由配置

功能路由具有路由标识、描述、必填参数、可选参数、会话卡片等配置。

  • 路由标识:用于集成方识别功能路由的唯一标识。

  • 描述:功能路由描述。

  • 必填参数:由于功能路由可被意图框架感知,为了确保意图框架调用功能路由时提取到必填参数,必填参数均为意图参数,当意图框架未提取到所有必填参数时,会进行追问而不会直接触发功能路由。

  • 可选参数:可选参数支持用户配置是否为意图参数,意图参数表示会被意图框架感知并尝试从用户对话中提取,如不希望被意图框架提取则可以取消意图参数的配置。

  • 会话卡片:包含标题、内容、跳转文案和默认链接,其中默认链接用于浏览器中访问 Copilot 应用时进行 URL 跳转。

配置示例如下图,需要注意的是意图参数的描述是必填项,描述的准确性将直接影响意图框架的参数提取效果。

image

点击功能路由设置面板中的运行按钮,可以预览功能路由卡片的效果。

image

意图绑定功能路由

新建一个意图,绑定操作选择对应的功能路由,则在该意图被识别后触发对应的功能路由,将生成一条卡片消息。

image

集成方注册功能路由回调

魔笔目前提供了 Android 和 iOS 的 Copilot SDK,用于将 Copilot 应用集成到移动端应用中,在使用 Copilot SDK 时可以注册功能路由回调,根据不同的路由标识和参数自定义处理逻辑。具体集成方式请参考 Android SDK 集成iOS SDK 集成