Cisco ogłosiło Project Quarry jako projekt open source 28 października 2026 r. README pokazuje, jak sklonować repozytorium, przygotować środowisko i przekazać skanerowi rozmowę w formacie JSON. Quarry ocenia reguły i zwraca wyniki; o tym, czy agent zostanie zablokowany, decyduje produkt, który integruje narzędzie.
Co Project Quarry sprawdza w śladzie agenta
Project Quarry analizuje wiadomości, wywołania narzędzi, ich wyniki i kolejność zdarzeń. Reguły mogą sprawdzać tekst, wyrażenia regularne RE2, pola strukturalne, użycie narzędzi oraz przebieg rozmów wieloetapowych. Cisco opisuje też interakcje MCP i dane multimodalne jako część zakresu projektu.
Zgodnie z Cisco wynik zawiera kroki i pola, które dopasowały się do reguły, oraz krótki fragment śladu. Typowe formaty sekretów są maskowane. Reguły nie tylko wskazują, że wzorzec wystąpił, lecz także pokazują jego związek z konkretnymi elementami rozmowy.
Instalacja i przykład wejścia
README Project Quarry podaje następującą kolejność poleceń:
git clone https://github.com/cisco-ai-defense/project-quarry.git
cd project-quarry
uv sync --frozen
Jeśli korzystasz z wbudowanego dostawcy modeli, do polecenia instalacyjnego dodaj --extra inference. Obsługiwane wersje Pythona to 3.11–3.13, a projekt udostępniono na licencji Apache 2.0.
Przykład skanowania przyjmuje rozmowę w formacie JSON podobnym do formatu OpenAI, z tablicą messages. To właśnie taką strukturę wejścia pokazuje repozytorium. Cisco podaje, że wiele frameworków agentów może już zapisywać ślady w tym formacie albo konwertować je do niego.
Przykładowa konfiguracja wybiera 14 lokalnych reguł, które działają bez danych uwierzytelniających do modeli. Cztery przykłady reguł semantycznych używają deterministycznych atrap opartych na słowach kluczowych. Służą do demonstracji i testów, a nie do podejmowania decyzji produkcyjnych.
Wynik reguły nie oznacza blokady
Quarry zwraca wykrycie wraz z uzasadniającymi je fragmentami śladu. Zintegrowany produkt może na tej podstawie wyświetlić alert, zablokować działanie, zredagować treść, poddać ją kwarantannie albo zapisać zdarzenie w logu. Sam silnik Quarry nie wybiera ani nie wykonuje tych reakcji.
Cisco podało 28 października, że Quarry działa produkcyjnie w Cisco AI Defense. W tym samym komunikacie firma opisała integrację z DefenseClaw jako planowaną.
Reguły są ładowane i kompilowane
Repozytorium oznacza Quarry jako wersję alfa. Składnia języka reguł, czyli DSL, może zmienić się przed wydaniem wersji 1.0.0, co może wymagać aktualizacji reguł. Podczas ładowania skaner analizuje i waliduje reguły, a następnie je kompiluje.
Interfejs wiersza poleceń obsługuje wyniki czytelne dla człowieka, JSON i CSV. Kod zakończenia 0 oznacza pełne skanowanie bez dopasowania, 1 pełne skanowanie z dopasowaniem, a 2 skanowanie nieprawidłowe lub niekompletne.