# Хуки в Copilot Studio: автоматичні дії до і після роботи агента

> Хуки в Copilot Studio запускають потік за подією: на старті розмови, перед викликом інструмента, після помилки. Види хуків, приклади з офісу, налаштування й обмеження.

Джерело: https://przejmijai.pl/uk/artykuly/copilot-studio-hooki
Оновлено: 13 листопада 2026 р.
Автор: PrzejmijAI (przejmijai.pl)

Інструкції кажуть агентові, **що** робити, але агент вирішує, коли і як. Іноді цього замало. Ви хочете, щоб щось відбувалося **завжди**: на старті розмови отримати дані працівника, перед бронюванням перевірити бюджет, перед надсиланням запитання замаскувати номери документів. Для цього є **хуки** (hooks).

Опис ґрунтується на [дописі команди Microsoft CAT](https://microsoft.github.io/mcscatblog/posts/hooks-in-copilot-studio/). Хуки перебувають у попередній версії (public preview) і працюють лише в агентах на **Microsoft Copilot harness**. У класичному (standard) harness схожу роль виконують тригери тем. Різниці ми пояснюємо в статті [Microsoft Copilot harness чи standard](https://przejmijai.pl/uk/artykuly/copilot-studio-microsoft-copilot-harness-czy-standard).

## Чим хук відрізняється від skill

- **Skill** це підказки для агента: як виконати завдання. Агент сам вирішує, чи ним скористатися.
- **Хук** це виконання за подією. Коли подія стається, запускається підключений потік, без рішення моделі.

## Види хуків

| Подія | Коли спрацьовує | Що може зробити |
| --- | --- | --- |
| Start | на початку нової розмови | додати контекст до першого повідомлення |
| User prompt submitted | після надсилання повідомлення користувачем | замінити текст, який отримує агент |
| Pre tool use | безпосередньо перед викликом інструмента | дозволити, заблокувати або змінити параметри |
| Post tool use | після вдалого виклику інструмента | обмежити те, що побачить модель |
| After tool failure | коли інструмент поверне помилку | підказати, як спробувати ще раз |
| Error | при інших помилках | повторити, пропустити або перервати |

## Приклади з офісу

- **Кадровий агент (Start):** на початку розмови потік перевіряє країну працевлаштування й бажану мову працівника, який увійшов у систему. Агент одразу відповідає за відповідними нормами.
- **Маскування даних (User prompt submitted):** перш ніж запитання потрапить до агента, потік вирізає з нього ідентифікаційні номери. У прикладі Microsoft для цього використано сервіс Azure Language.
- **Контроль бюджету (Pre tool use):** перед бронюванням подорожі потік порівнює ціну з лімітом і блокує задорогий варіант із поясненням, яке агент передасть користувачеві.

## Як додати хук

1. У налаштуваннях агента виберіть **Add a hook**.
2. Виберіть подію.
3. Створіть новий потік або виберіть наявний. Той самий потік може працювати в багатьох агентах.
4. Для хуків, що стосуються інструментів, вкажіть у полі **Tools**, яких інструментів вони стосуються. Порожнє поле означає всі, також вбудовані. Поле з’являється лише тоді, коли агент має хоча б один інструмент.
5. Протестуйте в попередньому перегляді й перевірте слід виконання.

## Обмеження, про які треба пам’ятати

1. **Хук «пропускає» при помилці.** Якщо потік хука впаде, перевищить час або поверне нечитабельну відповідь, агент працює далі як звичайно. **Не будуйте критичних захистів лише на хуках.** Система бронювання сама має відхилити задороге бронювання.
2. **Маскування не видаляє даних.** Оригінальне повідомлення все одно потрапляє в Copilot Studio і до сервісів, використаних у потоці. Зберігання записів розмов треба налаштувати окремо.
3. **Ліміт часу.** Потік хука має відповісти швидко. Якщо не встигне, попередній перегляд покаже інформацію про перевищення часу.
4. **Назви вбудованих інструментів.** Перш ніж будувати логіку на назві інструмента, перевірте в попередньому перегляді, як він насправді називається.

Хуки добре поєднуються з [пам’яттю агента](https://przejmijai.pl/uk/artykuly/copilot-studio-pamiec-agenta). Пам’ять зберігає вподобання з розмов, а хук отримує із системи дані, які завжди мають бути актуальними. Для створення потоків знадобиться [Power Automate](https://przejmijai.pl/uk/artykuly/automatyzacja-pracy-biurowej-bez-programowania).
