# langchain-webhooks-events

Скилл langchain-webhooks-events для Claude Code отправляет события цепочек LangChain 1.0 и LangGraph в HTTP-вебхуки или Kafka без блокировки основного потока. Передаёт телеметрию вызовов инструментов и мониторинга.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 4 установки · ★ 2935 у репозитория
- Автор: Jeremy Longshore
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/skills/.curated/langchain-webhooks-events/SKILL.md
- Обновлён: 2026-11-01
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/langchain-webhooks-events

## Что делает

Скилл решает проблему передачи событий из агентов LangChain 1.0 и LangGraph во внешние приёмники вроде Kafka, Redis Streams или HTTP-эндпоинтов. При обычной отправке через FastAPI `BackgroundTasks` данные уходят только после закрытия HTTP-ответа, из-за чего телеметрия запаздывает. Синхронные колбэки внутри асинхронных цепочек ещё опаснее: медленный сетевой запрос замораживает генерацию токенов.

Внутри используется класс `EventDispatchHandler`, унаследованный от `AsyncCallbackHandler`. Каждое событие отправляется через `asyncio.create_task` по схеме fire-and-forget. Чтобы сборщик мусора Python не удалил задачу в полёте, ссылки на неё сохраняются в локальном наборе до завершения. Вывод шагов обрезается до 4000 символов, а доставка маркируется составным ключом идемпотентности из `run_id`, типа события и индекса шага. Метод `drain()` ждёт завершения очереди перед остановкой процесса.

Для работы нужны Python 3.10+, пакеты `langchain-core` и `langgraph` версий от 1.0 до 2.0, библиотека `httpx` от 0.27, а также клиент выбранной очереди вроде `aiokafka` или `redis`. Привязка обработчика через `with_config` сломает телеметрию: LangGraph не передаёт такие колбэки во вложенные графы, поэтому передавать их нужно строго через словарь `config` при вызове `ainvoke`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill langchain-webhooks-events -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill langchain-webhooks-events -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill langchain-webhooks-events -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jeremylongshore/tons-of-skills-marketplace skills/.curated/langchain-webhooks-events
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill langchain-webhooks-events -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/jeremylongshore/tons-of-skills-marketplace --path skills/.curated/langchain-webhooks-events
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add jeremylongshore/tons-of-skills-marketplace --skill langchain-webhooks-events -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/HEAD/skills/.curated/langchain-webhooks-events/SKILL.md

## Когда брать
- отправлять события шагов LangGraph во внешние вебхуки
- передавать телеметрию агента в Kafka или Redis Streams без пауз в генерации
- пробрасывать обработчики событий во вложенные подграфы через `config`
- защищать доставку вебхуков ключами идемпотентности и подписью HMAC

## Примеры запросов агенту
- Настрой асинхронный EventDispatchHandler для отправки tool_end событий LangChain в вебхук с HMAC-подписью
- Покажи, как пробросить колбэки во вложенные подграфы LangGraph через config в ainvoke
- Сделай отправку событий агента в Kafka через aiokafka с составным ключом идемпотентности

## Похожие
- [langchain-architecture](https://affpapa.org/nevibecode/skills/langchain-architecture.md) — скилл · 13150 установок
- [langchain-fundamentals](https://affpapa.org/nevibecode/skills/langchain-fundamentals.md) — скилл · 18500 установок
- [langchain-dependencies](https://affpapa.org/nevibecode/skills/langchain-dependencies.md) — скилл · 17000 установок
- [langchain-development](https://affpapa.org/nevibecode/skills/langchain-development.md) — скилл · 726 установок

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

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