implementing-agent-modes

Guidelines to create/update a new mode for PostHog AI agent. Modes are a way to limit what tools, prompts, and prompt injections are applied and under what conditions. Achieve better results using your plan mode.

1. Przejrzyj istniejące tryby w katalogu ee/hogai/core/agent_modes/presets, aby sprawdzić, czy już istnieje tryb odpowiadający Twoim potrzebom. Tryby mogą być ograniczone do konkretnego produktu PostHog (np. Product analytics), obszaru funkcjonalnego (np. SQL) lub agenta (np. Instrumentation agent).
2. Jeśli chcesz utworzyć nowy tryb, dodaj go do schematu w pliku frontend/src/queries/schema/schema-assistant-messages.ts, a następnie przebuduj schemat poleceniem hogli build:schema lub pnpm run schema:build.
3. Utwórz lub zaktualizuj strukturę trybu, która powinna zawierać AgentToolkit z narzędziami specyficznymi dla trybu oraz AgentModeDefinition zawierającą definicję trybu, opis wstrzykiwany do kontekstu agenta i klasy dla toolkit'u.
4. Dodaj odpowiednie narzędzia do trybu, wybierając je z katalogów ee/hogai/tools lub innych dostępnych źródeł. Narzędzia mogą być kontekstowe i wstrzykiwane na konkretnych stronach interfejsu.
5. Jeśli wymagane jest dostosowanie promptu lub zachowania trybu, utwórz nowe executables w ramach definicji trybu.
6. Przetestuj tryb, upewniając się, że agent prawidłowo przełącza się między trybami za pomocą narzędzia switch_mode i że kontekst jest zachowywany podczas przełączania.