# Hooki w Copilot Studio: automatyczne akcje przed i po działaniu agenta

> Hooki w Copilot Studio uruchamiają przepływ przy zdarzeniu: na starcie rozmowy, przed wywołaniem narzędzia, po błędzie. Rodzaje hooków, przykłady z biura, konfiguracja i ograniczenia.

Źródło: https://przejmijai.pl/artykuly/copilot-studio-hooki
Aktualizacja: 13 listopada 2026
Autor: PrzejmijAI (przejmijai.pl)

Instrukcje mówią agentowi, **co** ma robić, ale to agent decyduje, kiedy i jak. Czasem to za mało. Chcesz, żeby coś działo się **zawsze**: na starcie rozmowy pobrać dane pracownika, przed rezerwacją sprawdzić budżet, przed wysłaniem pytania zamaskować numery dokumentów. Do tego służą **hooki**.

Opis opieramy na [wpisie zespołu Microsoft CAT](https://microsoft.github.io/mcscatblog/posts/hooks-in-copilot-studio/). Hooki są w wersji zapoznawczej (public preview) i działają tylko w agentach na **Microsoft Copilot harness**. W klasycznym (standard) harnessie podobną rolę pełnią wyzwalacze tematów. Różnice wyjaśniamy w artykule [Microsoft Copilot harness czy standard](https://przejmijai.pl/artykuly/copilot-studio-microsoft-copilot-harness-czy-standard).

## Czym hook różni się od skilla

- **Skill** to wskazówki dla agenta: jak wykonać zadanie. Agent sam decyduje, czy z niego skorzystać.
- **Hook** to wykonanie przy zdarzeniu. Gdy zdarzenie zachodzi, uruchamia się podpięty przepływ, bez decyzji modelu.

## Rodzaje hooków

| Zdarzenie | Kiedy działa | Co może zrobić |
| --- | --- | --- |
| Start | na początku nowej rozmowy | dodać kontekst do pierwszej wiadomości |
| User prompt submitted | po wysłaniu wiadomości przez użytkownika | podmienić tekst, który dostaje agent |
| Pre tool use | tuż przed wywołaniem narzędzia | zezwolić, zablokować albo zmienić parametry |
| Post tool use | po udanym wywołaniu narzędzia | ograniczyć to, co zobaczy model |
| After tool failure | gdy narzędzie zwróci błąd | podpowiedzieć, jak spróbować ponownie |
| Error | przy innych błędach | ponowić, pominąć lub przerwać |

## Przykłady z biura

- **Agent kadrowy (Start):** na początku rozmowy przepływ sprawdza kraj zatrudnienia i preferowany język zalogowanego pracownika. Agent od razu odpowiada według właściwych przepisów.
- **Maskowanie danych (User prompt submitted):** zanim pytanie trafi do agenta, przepływ wycina z niego numery identyfikacyjne. W przykładzie Microsoftu użyto do tego usługi Azure Language.
- **Kontrola budżetu (Pre tool use):** przed rezerwacją podróży przepływ porównuje cenę z limitem i blokuje zbyt drogą opcję z wyjaśnieniem, które agent przekaże użytkownikowi.

## Jak dodać hook

1. W ustawieniach agenta wybierz **Add a hook**.
2. Wybierz zdarzenie.
3. Utwórz nowy przepływ albo wybierz istniejący. Ten sam przepływ może działać w wielu agentach.
4. Przy hookach dotyczących narzędzi wskaż w polu **Tools**, których narzędzi dotyczy. Puste pole oznacza wszystkie, także wbudowane. Pole pojawia się dopiero, gdy agent ma choć jedno narzędzie.
5. Przetestuj w podglądzie i sprawdź ślad wykonania.

## Ograniczenia, o których trzeba pamiętać

1. **Hook „przepuszcza” przy błędzie.** Jeśli przepływ hooka się wysypie, przekroczy czas albo zwróci nieczytelną odpowiedź, agent działa dalej normalnie. **Nie opieraj krytycznych zabezpieczeń tylko na hookach.** System rezerwacji sam powinien odrzucić zbyt drogą rezerwację.
2. **Maskowanie nie usuwa danych.** Oryginalna wiadomość i tak trafia do Copilot Studio i do usług użytych w przepływie. Przechowywanie zapisów rozmów trzeba ustawić osobno.
3. **Limit czasu.** Przepływ hooka musi odpowiedzieć szybko. Gdy nie zdąży, podgląd pokaże informację o przekroczeniu czasu.
4. **Nazwy narzędzi wbudowanych.** Zanim oprzesz logikę na nazwie narzędzia, sprawdź w podglądzie, jak naprawdę się nazywa.

Hooki dobrze łączą się z [pamięcią agenta](https://przejmijai.pl/artykuly/copilot-studio-pamiec-agenta). Pamięć przechowuje preferencje z rozmów, a hook pobiera dane z systemu, które zawsze muszą być aktualne. Do budowy przepływów przyda się [Power Automate](https://przejmijai.pl/artykuly/automatyzacja-pracy-biurowej-bez-programowania).
