Gmail 触发器

概览

使用 Gmail 触发器，在连接账号中发生 Gmail 事件时启动已部署的 crews，例如收到新邮件，或匹配标签/过滤器的消息。

启用 Gmail 触发器

在 CrewAI AMP 中打开你的部署
前往 Triggers 选项卡
找到 Gmail 并切换开关以启用

示例：处理新邮件

当新邮件到达时，Gmail 触发器会将 payload 发送到你的 Crew 或 Flow。下面是一个解析并处理触发 payload 的 Crew 示例。

@CrewBase
class GmailProcessingCrew:
    @agent
    def parser(self) -> Agent:
        return Agent(
            config=self.agents_config['parser'],
        )

    @task
    def parse_gmail_payload(self) -> Task:
        return Task(
            config=self.tasks_config['parse_gmail_payload'],
            agent=self.parser(),
        )

    @task
    def act_on_email(self) -> Task:
        return Task(
            config=self.tasks_config['act_on_email'],
            agent=self.parser(),
        )

Gmail payload 可通过标准上下文机制获取。

本地测试

使用 CrewAI CLI 在本地测试你的 Gmail 触发器集成：

# 查看所有可用触发器
crewai triggers list

# 使用真实感 payload 模拟 Gmail 触发器
crewai triggers run gmail/new_email_received

crewai triggers run 命令会使用完整的 Gmail payload 执行你的 crew，从而让你在部署前测试解析逻辑。

监控执行

跟踪触发运行的历史和性能：

故障排查

确保 Gmail 已在 Tools & Integrations 中连接
验证 Gmail 触发器在 Triggers 选项卡中已启用
使用 crewai triggers run gmail/new_email_received 在本地测试，以查看准确的 payload 结构
检查执行日志，并确认 payload 作为 crewai_trigger_payload 传递
记住：使用 crewai triggers run（而不是 crewai run）来模拟触发器执行