# tool-approval

Субагент tool-approval разбирает шаблон human-in-the-loop: функция помечается как требующая одобрения, а ответ агента возвращается с approve или reject.

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

## Что делает

Субагент разбирает один сценарий: у агента есть функция, которую нельзя вызывать без разрешения человека. В C# такая функция — это `AIFunction`, обёрнутый в `ApprovalRequiredAIFunction`; в Python хватает параметра `approval_mode="always_require"` у декоратора `@tool`.

Дальше запуск идёт в два шага. Агент завершает ход не финальным ответом, а объектом `ToolApprovalRequestContent`, из которого видно имя функции и аргументы — их показывают человеку. Решение возвращается новым сообщением: `requestContent.CreateResponse(true)` или `false`, в тот же сеанс.

Пример собран вокруг проекта Azure AI Foundry: нужен endpoint и учётные данные Azure. `DefaultAzureCredential` в тексте годится для разработки; для продакшена там же советуют `ManagedIdentityCredential`, иначе credential probing и задержки. Проверять ответ на запросы одобрения нужно после каждого запуска, пока все вызовы не закрыты.

## Установка

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

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

### Codex

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

### Cursor

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

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

## Когда брать
- Пометить функцию агента как требующую одобрения человека
- Поймать `ToolApprovalRequestContent` в ответе и показать вызов пользователю
- Вернуть approve или reject в тот же сеанс агента
- Переписать пример на Python через `approval_mode`
- Не пропустить следующий запрос одобрения после повторного запуска

## Примеры запросов агенту
- Покажи, как обернуть функцию в `ApprovalRequiredAIFunction`, чтобы агент спрашивал подтверждение перед вызовом
- Сделай human-in-the-loop в Python: инструмент с `approval_mode="always_require"`
- Как вернуть отказ пользователя обратно агенту в той же сессии и получить результат?

## Похожие
- [copilot-sdk](https://affpapa.org/nevibecode/skills/copilot-sdk.md) — скилл · 76 установок
- [azure-queue-storage](https://affpapa.org/nevibecode/skills/azure-queue-storage.md) — скилл · 181 установка
- [azure-functions](https://affpapa.org/nevibecode/skills/azure-functions.md) — скилл · 90 установок
- [semantic-kernel-dotnet](https://affpapa.org/nevibecode/agents/semantic-kernel-dotnet.md) — субагент · 189 установок
- [microsoft-docs](https://affpapa.org/nevibecode/skills/github-microsoft-docs.md) — скилл · 14881 установка
- [azure-ai-projects-dotnet](https://affpapa.org/nevibecode/skills/azure-ai-projects-dotnet.md) — скилл · 1 установка

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

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

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