> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 触发器插件

本章节介绍 Xpert 插件体系中与 **Workflow Trigger** 相关的扩展实现，以及外部消息平台如何通过触发器把消息路由到数字专家。

当你希望数字专家不仅能在平台内聊天界面被触发，还能从外部消息系统或定时任务触发时，可以通过 Trigger 插件扩展。

## 集成与触发器的边界

外部 IM 接入通常拆成两个对象：

* **集成**：保存平台凭证、回调地址、长连接配置和运行状态，负责让 Xpert AI 与外部平台连通。
* **触发器**：出现在数字专家工作流中，负责把某个集成绑定到当前数字专家，并决定会话超时、消息汇总和消息路由。

因此，创建飞书、企业微信或钉钉机器人时，不是只保存集成就结束了。还需要在目标数字专家工作流中添加对应触发器并发布版本，消息才会进入该数字专家。集成的通用安装要求和推荐接入模式见 [集成说明](../integration/)。

## 当前文档范围

* [定时触发器插件实现](./schedule-trigger/)
* [飞书触发器](./lark-trigger/)
* [企业微信触发器](./wecom-trigger/)
* [钉钉触发器](./dingtalk-trigger/)

## 设计要点

Trigger 插件通常实现以下能力：

1. **触发器元数据（meta）**：用于在前端展示触发器名称、图标和配置表单。
2. **配置校验（validate）**：在发布前检查必填项和绑定冲突。
3. **发布与停用（publish / stop）**：负责注册与释放触发器运行时资源。
4. **启动恢复策略（bootstrap）**：控制系统重启后触发器是否自动恢复。

飞书、企业微信、钉钉触发器都采用持久化绑定：

```text theme={null}
integrationId -> xpertId
```

这可以避免同一个外部机器人同时触发多个数字专家。系统重启后，外部消息到达时会继续按持久化绑定分发；如果运行时回调暂时不存在，会进入插件的 handoff 分发队列。

## 关联功能

* 工作流触发器概念与节点说明： [触发器](../../workflow/trigger/)
* 数字专家多入口接入方式： [数字专家](../../agent/agent/)
* 插件体系总体说明： [插件概述](../overview/)