# chat-middleware

Субагент chat-middleware для перехвата и изменения запросов к чат-модели перед вызовом API. Логирует промпты, блокирует запрещённые термины, подменяет ответы.

- субагент · `type=agent` · Claude Code, Cursor, Codex · ★ 521 у репозитория
- Автор: eavanvalkenburg
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/managedcode/dotnet-skills/tree/HEAD/catalog/Frameworks/Microsoft-Agent-Framework/skills/microsoft-agent-framework/references/official-docs/concepts/agents/middleware/chat-middleware.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/chat-middleware

## Что делает

Субагент встраивается между агентом и `IChatClient` (C#) или `ChatContext` (Python). Можно написать middleware классом (`ChatMiddleware`) или функцией с декоратором `@chat_middleware`. Внутри доступны все сообщения перед отправкой: middleware читает их, правит текст, добавляет префиксы или полностью подменяет ответ, не вызывая модель.

Пример из репозитория показывает `InputObserverMiddleware`, который логирует входящие сообщения и заменяет текст пользователя, и `security_and_override_middleware`, блокирующий слова `password`, `secret`, `api_key`, `token`. Если middleware вызывает `await call_next()`, управление передаётся следующему звену или модели. Без этого вызова цепочка прерывается — так middleware может вернуть готовый ответ.

Для C# нужен `Microsoft.Agents.AI` и метод `.Use()` на `IChatClient.AsBuilder()`. Для Python — `agent_framework` и класс `ChatMiddleware` или декоратор. Middleware регистрируют на уровне агента (работает во всех запусках) или на уровне одного `RunAsync`.

## Установка

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

**Вручную: положить файлы**
- Файл: `.claude/agents/chat-middleware.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/chat-middleware.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/chat-middleware.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/managedcode/dotnet-skills/tree/HEAD/catalog/Frameworks/Microsoft-Agent-Framework/skills/microsoft-agent-framework/references/official-docs/concepts/agents/middleware/chat-middleware.md

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

## Примеры запросов агенту
- Добавь middleware, который логирует все сообщения перед отправкой в `gpt-4o-mini`
- Блокируй запросы со словами `api_key` и `token` через `security_and_override_middleware`
- Создай класс `InputObserverMiddleware`, который заменяет текст пользователя на «Hello»

## Похожие
- [llm-input-output-guardrail-middleware-development](https://affpapa.org/nevibecode/skills/llm-input-output-guardrail-middleware-development.md) — скилл · ★ 73 у репозитория
- [hono-middleware](https://affpapa.org/nevibecode/skills/hono-middleware.md) — скилл · 452 установки
- [langchain-middleware](https://affpapa.org/nevibecode/skills/langchain-middleware.md) — скилл · 17200 установок
- [roblox-text-chat](https://affpapa.org/nevibecode/skills/roblox-text-chat.md) — скилл · 1200 установок
- [safe-action-middleware](https://affpapa.org/nevibecode/skills/safe-action-middleware.md) — скилл · 1200 установок
- [inngest-middleware](https://affpapa.org/nevibecode/skills/inngest-middleware.md) — скилл · 3800 установок

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

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

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