# agent-vs-run-scope

Субагент agent-vs-run-scope для Claude Code, Cursor и Codex, который объясняет разницу между middleware на уровне агента и на уровне запроса. Применяется, когда нужно понять, как и когда срабатывает middleware в Agent Framework.

- субагент · `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/agent-vs-run-scope.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/agent-vs-run-scope

## Что делает

Middleware можно регистрировать двумя способами: на уровне агента (применяется ко всем запросам и настраивается один раз при создании) или на уровне запроса (применяется только к конкретному вызову). Когда оба типа зарегистрированы, middleware уровня агента выполняется первым (снаружи), затем middleware уровня запроса (внутри), и только потом сам агент.

Субагент содержит примеры на C# и Python. В C# middleware регистрируется с помощью builder-паттерна `.AsBuilder().Use(...).Build()` — на уровне агента это делается один раз при конструировании, на уровне запроса создаётся декорированный агент прямо перед вызовом `RunAsync` или `RunStreamingAsync`. Python использует класс `AgentMiddleware` с аналогичным подходом.

## Установка

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

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

### Codex

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

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/agent-vs-run-scope.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/agent-vs-run-scope.md

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

## Примеры запросов агенту
- Покажи пример middleware уровня агента на C# для валидации безопасности
- Как применить debug middleware только к одному запросу в Claude Code
- Создай цепь из нескольких middleware для одного запроса агента

## Похожие
- [langchain-middleware](https://affpapa.org/nevibecode/skills/langchain-middleware.md) — скилл · 17200 установок
- [run-tests](https://affpapa.org/nevibecode/skills/run-tests.md) — скилл · 7000 установок
- [llm-input-output-guardrail-middleware-development](https://affpapa.org/nevibecode/skills/llm-input-output-guardrail-middleware-development.md) — скилл · ★ 73 у репозитория
- [amc-run-video-calibration](https://affpapa.org/nevibecode/skills/amc-run-video-calibration.md) — скилл · 664 установки
- [amc-run-sample-calibration](https://affpapa.org/nevibecode/skills/amc-run-sample-calibration.md) — скилл · 647 установок
- [scope-creep-detector](https://affpapa.org/nevibecode/skills/scope-creep-detector.md) — скилл · 690 установок

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

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

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