扣子支持开发者在搭建智能体时创建一些快捷指令，方便用户在与智能体会话时通过快捷指令快速、准确地输入信息。 # 功能说明 配置快捷指令后，智能体用户在智能体的对话框中可以直接通过指令发起预设的对话。快捷指令的行为可以是发送一段简单的文字、上传文件、使用插件或工作流等。多 Agent 模式下，全局配置中也支持添加快捷指令，默认不指定节点回答，智能体根据用户输入匹配对应的节点处理。 例如在翻译智能体中增加一个快捷指令，即原文输入框和目标语言列表，对话时你只需输入待翻译的内容和语言即可快速下发一条翻译指令。 # 创建简单指令 参考以下步骤，创建一个简单快捷指令。 1. 在编排页面，定位到**快捷指令**功能，然后单击 **+**。 2. 在弹出的页面，完成以下配置。 | **配置** | **说明** | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 按钮名称 | 输入快捷指令的按钮名称。例如：AI。 | | 指令名称 | 输入唤起该指令的名称，只支持使用字母和下划线。例如get\_ai\_news。仅发布到扣子商店会展示快捷指令框，其他渠道均不会展示快捷指令框，需输入指令名称唤起快捷指令。详细说明，请参考[发布渠道说明](https://www.coze.cn/open/docs/guides/shortcuts#6366770e)。 | | 指令描述 | 添加指令说明信息。 | | 指令行为 | 选择**直接发送**，即用户点击该指令时，直接发送一条消息给智能体。 | | 指令内容 | 输入用户点击该指令时发送的内容。例如：发送最新的三条 AI 新闻。 | 3. 配置完成后，可以在调试区，直接点击快捷指令查看效果。 如下图所示（左侧是快捷指令配置截图，右侧是调试截图），当点击**AI新闻**指令时，会自动发送配置好的指令内容。  # 创建组件指令 扣子提供了选择器、上传等组件，通过添加这些组件，可以设计更符合使用场景的快捷指令。 参考以下步骤，创建一个带组件的快捷指令。 1. 在智能体编排页面，定位到**快捷指令**功能，然后单击 **+**。 2. 在弹出的页面，完成以下配置。 | **配置** | **说明** | | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 按钮名称 | 输入快捷指令的按钮名称。例如：翻译。 | | 指令名称 | 输入唤起该指令的名称，只支持使用字母和下划线。例如translate。仅发布到扣子商店会展示快捷指令框，其他渠道均不会展示快捷指令框，需输入指令名称唤起快捷指令。详细说明，请参考[发布渠道说明](https://www.coze.cn/open/docs/guides/shortcuts#6366770e)。 | | 指令描述 | 添加指令说明信息。 | | 指令行为 | 选择显示**组件模板**。1. 添加组件名称，并选择组件的类型。1. 单击+按钮，增加组件。你可以在右侧面板实时预览组件效果。 如果你想直接使用工作流或插件的输出结果作为组件组成，勾选**直接使用插件或工作流**，并选择一个插件/工作流。系统会根据选择的插件/工作流的输出数据格式自动填充组件信息。 | | 指令内容 | 输入用户点击该指令时发送的内容。单击文本框上方的绑定按钮，插入组件。 所有添加的组件都必须要在指令内容中进行关联。 | 3. 配置完成后，可以在调试区，直接点击快捷指令查看效果。  # 内置指令名称 扣子开发平台提供了一些内置的指令名称。 微信/抖音小程序、微信、飞书、掘金渠道支持使用内置指令。 * /clear：清除当前智能体的对话上下文。 * /cancel\_oauth：清除当前智能体中所有插件的 OAuth 鉴权。 * /shortcuts：列出当前智能体所有可用的快捷名称列表，包括自定义的指令名称和内置的指令名称。  # 发布渠道说明 创建快捷指令后，仅发布到扣子商店会展示快捷指令框，其他渠道均不会展示快捷指令框，需输入指令名称唤起快捷指令。 | **发布渠道** | **说明** | | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | 扣子商店 | 在智能体对话页面展示快捷指令框。 | | 微信/抖音小程序、微信、飞书、豆包、多维表格、掘金、Chat SDK、API | 在智能体对话页面，输入指令名称（例如 /getweather）唤起快捷指令。 | # 其他操作 * 拖拽快捷指令卡片调整快捷指令的顺序。 * 单击编辑图标修改快捷指令。 * 单击删除图标删除快捷指令。