# inngest-agents

Скилл для сборки и отладки агентов на Inngest и AgentKit: вызовы моделей, инструменты, ожидание одобрения человека, прогресс в реальном времени.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 657 установок · ★ 29
- Автор: inngest
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/inngest/inngest-skills/tree/HEAD/skills/inngest-agents/SKILL.md
- Обновлён: 2026-09-28
- HTML: https://affpapa.org/nevibecode/skills/inngest-agents

## Что делает

Скилл описывает, как строить агентов, которые переживают деплой, падение процесса и таймауты serverless. Агент задаётся через `createAgent` из AgentKit, а когда запуском владеет функция Inngest, вызовы модели идут через `step.ai` — так они повторяются и кешируются. Вокруг агента ставят обычные шаги: чтение из базы, побочные эффекты инструментов, ожидания, одобрения.

Внутри — рекомендованная архитектура из девяти пунктов и пример функции с типизированным событием. HTTP-слой проверяет авторизацию и быстро возвращает ответ, а саму работу ведёт функция Inngest. Состояние грузят внутри `step.run`, одобрение человека ждут через `step.waitForEvent`, прогресс публикуют нативным realtime. Для v4 советует `step.realtime.publish` и предупреждает: пакет `@inngest/realtime` от v3 ставить не надо, а процесс-local WebSocket не годится как единственный источник прогресса.

Есть чек-лист для инструментов: что за внешнее состояние меняет вызов, какой ключ идемпотентности защитит от повторной записи, безопасно ли хранить вывод в состоянии запуска. Параметры инструментов скилл велит проверять схемами, а идентификаторы арендатора брать из данных события, не из текста модели. Для одного короткого вызова модели без побочных эффектов всё это лишнее.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add inngest/inngest-skills --skill inngest-agents -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/inngest-agents/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/inngest-agents/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add inngest/inngest-skills --skill inngest-agents -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/inngest-agents/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add inngest/inngest-skills --skill inngest-agents -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/inngest-agents/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install inngest/inngest-skills inngest-agents
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/inngest-agents/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add inngest/inngest-skills --skill inngest-agents -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/inngest/inngest-skills --path skills/inngest-agents
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/inngest-agents/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add inngest/inngest-skills --skill inngest-agents -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/inngest/inngest-skills/tree/HEAD/skills/inngest-agents/SKILL.md

## Когда брать
- собрать агента, который переживает падение процесса и деплой
- добавить в агентский цикл вызовы инструментов и внешних API
- дождаться одобрения человека перед отправкой ответа
- транслировать прогресс агента в интерфейс из долговечного workflow
- ограничить параллелизм вызовов провайдера по арендатору

## Примеры запросов агенту
- собери durable support-агента на Inngest и AgentKit с вызовом инструментов
- добавь в этот агент ожидание одобрения через step.waitForEvent
- переведи прогресс агента на нативный realtime в v4

## Похожие
- [inngest](https://affpapa.org/nevibecode/skills/sickn33-inngest.md) — скилл · 1200 установок
- [workflow-automation](https://affpapa.org/nevibecode/skills/sickn33-workflow-automation.md) — скилл · 1500 установок
- [migrating-to-workflow-sdk](https://affpapa.org/nevibecode/skills/migrating-to-workflow-sdk.md) — скилл · 734 установки
- [convex-design](https://affpapa.org/nevibecode/skills/convex-design.md) — скилл · 36000 установок
- [add-voice](https://affpapa.org/nevibecode/skills/add-voice.md) — скилл · 319 установок
- [base44-cli](https://affpapa.org/nevibecode/skills/base44-cli.md) — скилл · 10900 установок

Из того же набора: [inngest/inngest-skills](https://affpapa.org/nevibecode/by/inngest/inngest-skills.md) — 10 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md