39 lines
1.4 KiB
Markdown
39 lines
1.4 KiB
Markdown
# Approvals и лимиты write-инструментов
|
||
|
||
Дата: 18.11.2026 · P0 · human-approval
|
||
|
||
## Поток
|
||
|
||
1. Агент вызывает write-инструмент с `confirm=true`.
|
||
2. Tool Gateway **не выполняет** его сразу, а создаёт `tool_approvals` (pending)
|
||
и присылает в «Секретарь-Бета»:
|
||
`🔐 Подтверждение #N ... approve N / reject N`.
|
||
3. Человек отвечает `approve N` или `reject N`.
|
||
4. `approval-watcher` (Hermes, 30 с) выполняет approved-строку и присылает
|
||
результат в Matrix.
|
||
|
||
Проверено:
|
||
```
|
||
ha.call confirm → 202 approval_pending #5
|
||
approve 5 → выполнено, tool_approvals #5 = done
|
||
```
|
||
|
||
## Что требует подтверждения
|
||
|
||
| Инструмент | лимит |
|
||
|---|---|
|
||
| `ha.call` | 5/60 с |
|
||
| `hub.notify` | 10/60 с |
|
||
| `media.request` | 5/60 с |
|
||
| `calendar.create` | 10/60 с |
|
||
|
||
## Журнал
|
||
|
||
`hermes.tool_approvals`: `id, ts, actor, tool, args, decision (pending/approved/rejected/done/failed), result`.
|
||
Просмотр: `approvals.recent`; общий аудит — `tool_audit`/`audit.recent`.
|
||
|
||
## Ограничение
|
||
|
||
Агент получает `approval_pending`; он должен сказать пользователю
|
||
`approve <id>`, а не повторять вызов. Повторный вызов создаёт новый pending.
|