# Async Event Agent

构建异步/事件驱动 Agent，或让 Agent 响应外部事件（新邮件、webhook 回调、IM 消息、定时器、系统告警）、...

- Repository: https://github.com/bojieli/ai-agent-book (56844 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-10-08
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add bojieli/ai-agent-book --skill async-event-agent -g -a claude-code -y`
Codex: `npx skills add bojieli/ai-agent-book --skill async-event-agent -g -a codex -y`
Cursor: `npx skills add bojieli/ai-agent-book --skill async-event-agent -g -a cursor -y`
Gemini CLI: `npx skills add bojieli/ai-agent-book --skill async-event-agent -g -a gemini-cli -y`

## Description

构建异步/事件驱动 Agent，或让 Agent 响应外部事件（新邮件、webhook 回调、IM 消息、定时器、系统告警）、 处理工具执行期间的用户打断与多任务并发时使用。覆盖事件循环与安全点、三类事件触发工具、用户沟通与多渠道召回、 虚拟身份与隔离执行环境、队列式/取消式/并行式三种事件处理策略及紧急度判定，以及模型原生异步与同步接口兼容两条路线。 触发词：异步 Agent、事件驱动、event-driven、webhook、定时器、心跳、任务句柄、打断、steering、并行工具执行。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 异步与事件驱动 Agent

## 何时使用

- 要让 Agent 在**没有用户输入时也行动**：定时生成报告、周期性检查服务器、跟进未回复的邮件、到工作时间再拨打电话。
- 要接入**外部事件源**：新邮件到达、API 回调、IM/短信消息、GitHub PR 变更、支付失败告警。
- 要支持**执行期间被打断**：长任务运行中用户说"停""改一下预算""先帮我查个天气"。
- 要**同时管理多个并发任务**：并行跑几个脚本、先完成的先看结果、未达进度就取消。
- 要从回合制 ReAct 循环升级为长期运行的**事件循环 Agent**。
- 要评估某个模型/接口是否支持原生异步，或为不支持的接口设计兼容层。
- 任务需要在"发起"与"收尾"之间跨越多个回合（如代打电话、长时审批流）。
- Agent 需要以"活人感"与用户异步沟通（发消息、图片、文件、按紧急度推送提醒），而非必须打开指定会话。

## 核心原则

The rest: https://github.com/bojieli/ai-agent-book/blob/HEAD/skills/async-event-agent/SKILL.md