Hooki - skrypty w cyklu pracy Codexa
Hooki to mechanizm rozszerzania Codexa, który uruchamia skrypty lub narzędzia MCP w trakcie pętli agenta. Możesz wykorzystać je między innymi do logowania rozmów, kontroli promptów pod kątem kluczy API, tworzenia trwałych wspomnień lub walidacji po zakończeniu tury. Polecenie /hooks w CLI służy do przeglądania źródeł hooków oraz zarządzania ich zaufaniem i wyłączeniami.
Przed uruchomieniem niezależnie zarządzanego hooka Codex wymaga sprawdzenia i zaufania jego konkretnej definicji. Zaufanie jest powiązane z bieżącym hashem definicji, więc nowy lub zmieniony hook zostaje pominięty do czasu zatwierdzenia. W /hooks możesz przejrzeć nowe lub zmienione hooki, zaufać im albo wyłączyć pojedyncze hooki, które nie są zarządzane centralnie.
Hooki mogą być zdefiniowane w pliku hooks.json albo jako tabele [hooks] w config.toml, a Codex ładuje pasujące hooki ze wszystkich źródeł. Warstwy konfiguracji o wyższym priorytecie nie zastępują hooków z niższych warstw. Jeśli jedna warstwa zawiera jednocześnie hooks.json i tabele [hooks], Codex scala te konfiguracje i ostrzega przy starcie; zalecana jest jedna forma na warstwę.
Pasujące hooki z wielu plików uruchamiają się wszystkie, a pasujące hooki-komendy dla tego samego zdarzenia startują równolegle. W efekcie jeden hook nie może powstrzymać rozpoczęcia innego pasującego hooka dla tego samego zdarzenia. Hooki projektowe są ładowane tylko wtedy, gdy zaufana jest warstwa .codex/ projektu, natomiast hooki niezarządzane wymagają przeglądu i zaufania przed uruchomieniem.
/hooks, aby sprawdzić skonfigurowane źródła hooków./hooks
Zastosowanie w praktyce
Użyj hooka do wysyłania rozmów do własnego systemu logowania lub analityki. Możesz uruchamiać kontrolę promptów, która blokuje przypadkowe wklejenie kluczy API. Hook może automatycznie podsumowywać rozmowy i tworzyć trwałe wspomnienia. Przy zakończeniu tury hook może uruchomić własną kontrolę walidacyjną, aby egzekwować standardy.
/hooks i ponownie ją przejrzyj oraz zatwierdź: zmiana hasha powoduje oznaczenie hooka do przeglądu i pominięcie go do czasu uzyskania zaufania.