# Agent Triggers — 官方帮助文档存档

> 来源：https://docs.gumloop.com/core-concepts/agent_triggers.md + https://docs.gumloop.com/core-concepts/ai_trigger_creation.md
> 抓取日期：2026-05-30
> 状态：✅ 完整

---

## Overview

Two categories: **scheduled triggers** (recurring/one-time) and **event-based triggers** (external service events). Managed from Triggers section of agent config. AI-powered custom triggers can be built with natural language via "Create With AI".

## Scheduled Triggers

- **Recurring**: Cron schedule, min interval 1 min, timezone = browser timezone, AI generates cron from plain language
- **One-Time**: "In" mode (relative delay) or "At" mode (specific datetime). Auto-deleted after execution.
- **Prompt**: Message delivered to agent when trigger fires. Should be specific and actionable.
- **Self-Scheduling**: Agents can create/manage their own triggers during conversation ("Remind me at 9 AM", "In 30 min, check deployment", "Pause daily email check")

## Event-Based Triggers — 13+ Integrations

| Integration | Event | Mode |
|---|---|---|
| Gmail | New email in label | Real-time |
| Slack | New channel message | Real-time |
| Microsoft Teams | New channel message | Real-time |
| Google Drive | New file in folder | Real-time |
| Google Sheets | New/updated row | Polling (~60s) |
| Google Calendar | Upcoming event | Polling (~60s) |
| Notion | New/updated page | Polling (~60s) |
| Airtable | New/updated record | Polling (~60s) |
| Zendesk | New ticket/comment | Real-time |
| Salesforce | New/updated record | Polling (~60s) |
| Linear | New/updated issue | Polling (~60s) |
| Jira | New issue | Polling (~60s) |
| Parallel Web Monitor | Web changes | Real-time (webhook) |

Also: Google Forms, Typeform, HubSpot, incident.io

## Prompt Templates

- Template variables (`{Sender}`, `{Subject}`, `{Email Body}` etc.) replaced with actual event data
- "Pass Raw Data" toggle sends full JSON payload instead

## AI Trigger Creation ("Create With AI")

- Describe monitoring need in plain language
- Agent auto-detects monitoring requests in conversation
- Works across: Built-in Integrations (70+ services), External MCP Servers, Hosted MCP Servers
- Single trigger can combine servers of different types
- 6-step creation: Connect services → Discover tools → Build code → Test in sandbox → Capture baseline → Activate
- State management: sliding window of up to 5,000 checkpoint entries
- Polling: min 5 min, max 1 week
- Max 10 active AI triggers per agent per user
- Circuit breaker: >20 fires within 10 min → deactivation
- Read-only: trigger detects condition, agent takes action

## Operational Details

- **Credentials**: Always use trigger creator's credentials
- **Auto-disable**: After 3 consecutive failures (expired credentials, deleted resources, permission changes)
- **Overlapping runs**: New execution skipped if previous still running
- **Credits**: Same cost as normal chat messages