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

Хуки в Copilot Studio запускають потік за подією: на старті розмови, перед викликом інструмента, після помилки. Види хуків, приклади з офісу, налаштування й обмеження.
Інструкції кажуть агентові, що робити, але агент вирішує, коли і як. Іноді цього замало. Ви хочете, щоб щось відбувалося завжди: на старті розмови отримати дані працівника, перед бронюванням перевірити бюджет, перед надсиланням запитання замаскувати номери документів. Для цього є хуки (hooks).
Опис ґрунтується на дописі команди Microsoft CAT. Хуки перебувають у попередній версії (public preview) і працюють лише в агентах на Microsoft Copilot harness. У класичному (standard) harness схожу роль виконують тригери тем. Різниці ми пояснюємо в статті Microsoft Copilot harness чи 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): перед бронюванням подорожі потік порівнює ціну з лімітом і блокує задорогий варіант із поясненням, яке агент передасть користувачеві.
Як додати хук
- У налаштуваннях агента виберіть Add a hook.
- Виберіть подію.
- Створіть новий потік або виберіть наявний. Той самий потік може працювати в багатьох агентах.
- Для хуків, що стосуються інструментів, вкажіть у полі Tools, яких інструментів вони стосуються. Порожнє поле означає всі, також вбудовані. Поле з’являється лише тоді, коли агент має хоча б один інструмент.
- Протестуйте в попередньому перегляді й перевірте слід виконання.
Обмеження, про які треба пам’ятати
- Хук «пропускає» при помилці. Якщо потік хука впаде, перевищить час або поверне нечитабельну відповідь, агент працює далі як звичайно. Не будуйте критичних захистів лише на хуках. Система бронювання сама має відхилити задороге бронювання.
- Маскування не видаляє даних. Оригінальне повідомлення все одно потрапляє в Copilot Studio і до сервісів, використаних у потоці. Зберігання записів розмов треба налаштувати окремо.
- Ліміт часу. Потік хука має відповісти швидко. Якщо не встигне, попередній перегляд покаже інформацію про перевищення часу.
- Назви вбудованих інструментів. Перш ніж будувати логіку на назві інструмента, перевірте в попередньому перегляді, як він насправді називається.
Хуки добре поєднуються з пам’яттю агента. Пам’ять зберігає вподобання з розмов, а хук отримує із системи дані, які завжди мають бути актуальними. Для створення потоків знадобиться Power Automate.
Джерела і дата перевірки
Станом на 13 листопада 2026 р..
- дописі команди Microsoft CAT (microsoft.github.io)
Ціни, функції інструментів і закони можуть змінитися після цієї дати, тож перед важливими рішеннями перевірте актуальний стан у джерелі.