Opowiedz o błędzie. Dostań raport, z którym ruszy zespół i agent.

Czego potrzebujesz

• Google Chrome 145 lub nowszy na macOS, Windows albo Linux. Voice2Bug to wtyczka Chrome (Manifest V3). Inne przeglądarki nie są obsługiwane.
• Zwykła strona internetowa (http:// lub https://). Voice2Bug nie nagrywa na stronach przeglądarki, takich jak ustawienia chrome://, i nie działa w oknach incognito.
• Mikrofon jest opcjonalny. Bez niego, albo gdy odmówisz dostępu, nagranie trwa dalej bez dźwięku i nadal możesz robić zrzuty.
• Kod aktywacyjny, który dostaniesz e-mailem po rozpoczęciu testu albo od administratora workspace'u.

Instalacja i aktywacja Voice2Bug

1. Dodaj Voice2Bug do Chrome z Chrome Web Store i przypnij ikonę do paska narzędzi, żeby była zawsze pod ręką.
2. Otwórz okno Access: kliknij Start a trial na pływającym przycisku Report a bug albo w panelu bocznym. Okno pokazuje Current status z plakietką: CHECKING, SETUP, ACTIVE, EXPIRED lub ERROR.
3. Nie masz kodu? W części Don't have an activation code? wpisz e-mail, zaznacz zgodę i kliknij Send confirmation email. Potwierdź adres w skrzynce. Jeśli adres się kwalifikuje, wyślemy kod aktywacyjny.
4. Masz kod? W części Already have an activation code? wklej go i kliknij Activate Voice2Bug. Zobaczysz Access activated on this device.

Warto wiedzieć

• Test daje 30 dni pełnego dostępu bez karty. Twoje 30 dni liczy się dopiero od udanej aktywacji na tym urządzeniu, a nie od prośby o e-mail.
• Test przysługuje raz na adres: „No new license is issued after a trial has been used.”
• Jeśli workspace tego wymaga, potwierdź organizację: w Confirm organization access wpisz służbowy e-mail, kliknij Send code, potem wpisz kod i kliknij Confirm.
• Żeby odłączyć to urządzenie, użyj Manage this device → Remove access. Najpierw zatrzymaj aktywne nagranie.
• Administrator widzi kod aktywacyjny workspace'u w panelu admina: Settings → Current activation code.

Zgoda na przetwarzanie przy pierwszym nagraniu

Przy pierwszym nagraniu Voice2Bug pokazuje Voice2Bug Privacy Consent. Lista obejmuje cztery rodzaje danych (Screenshots, Audio Recording, Console Logs i Network Activity) i wszystkie cztery są wymagane. Kliknij Accept and continue, żeby nagrywać, albo Decline, żeby zrezygnować. Po odmowie nic nie jest nagrywane. Zebrane dane zostają na Twoim urządzeniu, dopóki nie wygenerujesz raportu.

Rozpocznij nagranie

Otwórz stronę, na której występuje błąd. Nagranie uruchomisz na trzy sposoby:

• pływającym przyciskiem Report a bug na stronie;
• ikoną Voice2Bug na pasku Chrome (jeśli ta karta nie ma jeszcze nagrania ani raportu, jedno kliknięcie zaczyna nagrywanie);
• przyciskiem Report a bug w panelu bocznym.

Za pierwszym razem Chrome zapyta o dostęp do mikrofonu. Podczas nagrania przycisk pokazuje czerwoną kropkę, czas i STOP.

Warto wiedzieć

• Żeby przesunąć pływający przycisk, otwórz ustawienia → “Report a bug” button position i wybierz róg. Wybór zapisuje się dla danej strony.
• Jeśli administrator ograniczył nagrywanie do wybranych stron, na pozostałych zobaczysz: „This domain is not in your organization's allowed sites list.”

Mów i klikaj jak zwykle

Korzystaj ze strony jak zwykle i mów na głos, co robisz, co widzisz i czego się spodziewałeś. Nie musisz nic pisać ani przełączać okien. Głos jest transkrybowany i łączony w czasie z kliknięciami, zrzutami i logami.

• Mówienie jest 3× szybsze niż pisanie.
• Język mowy wykrywa się automatycznie. Jakość raportów sprawdziliśmy dla polskiego i angielskiego.
• Od wersji 3.9.41 mały wskaźnik głosu obok licznika pokazuje, że wtyczka słyszy Twój głos.
• Gdy mikrofon jest niedostępny, zobaczysz „Recording without audio - microphone unavailable.”, a nagranie trwa dalej.
• Panel boczny może być otwarty w trakcie nagrania. Zamknięcie go nie zatrzymuje nagrania.

Zrób zrzut ekranu

• Kliknij i przeciągnij, żeby zaznaczyć fragment. Esc anuluje. Przy zbyt małym zaznaczeniu zobaczysz „Selection too small”.
• Zrzut obejmuje to, co widać w karcie. Nie ma zrzutu całej strony.
• W jednym raporcie zrobisz do 10 zrzutów. Potem zobaczysz „Screenshot limit reached (10/10). Stop the recording to build the report.”
• Każdy zrzut ma mały znak „Generated with Voice2Bug”.
• Skrót zmienisz pod adresem chrome://extensions/shortcuts.

Nagrywaj dalej na kolejnych stronach

Nagranie trwa dalej, gdy przechodzisz na inną stronę w tej samej karcie. Każda odwiedzona strona trafia do ścieżki nawigacji, a zrzuty możesz robić na każdej z nich.

Co zbiera się automatycznie

Dane wrażliwe i maskowanie

• Wpisywane wartości w polach hasła, e-maila, telefonu, liczby, wyszukiwania i adresu URL nie są zapisywane. W raporcie widać je jako „Typed redacted … value”. To samo dotyczy pól, których nazwa wskazuje na token, hasło, PIN, kartę, CVV, IBAN, sesję, cookie i podobne.
• Nagłówki zapytań: zostaje tylko krótka lista bezpiecznych nagłówków. authorization, cookie i x-api-key są zastępowane przez [REDACTED].
• Treść zapytań i odpowiedzi: wartości wyglądające na sekrety są zastępowane przed zapisaniem raportu.
• Zrzuty ekranu nie są automatycznie rozmywane. Zaznaczaj tylko potrzebny fragment.
• Administrator może ograniczyć nagrywanie do dozwolonych stron i pominąć wybrane domeny w ruchu sieciowym.

Gdzie dane są przetwarzane i przechowywane, opisuje polityka prywatności.

Zatrzymaj nagranie i odbierz raport

Kliknij STOP na pływającym przycisku albo Stop and build report w panelu bocznym. Voice2Bug zbiera dowody, filtruje logi i błędy sieci, prosi AI o szkic raportu i go zapisuje. W tym czasie możesz dalej przeglądać strony. Jeśli Chrome uśpi wtyczkę, postęp zostanie przywrócony.

Gdy coś pójdzie nie tak

• Report needs attention: kliknij Retry report albo Start new recording.
• „This recording has too many attachments”: nagraj krótszą sesję albo zrób mniej zrzutów.

Ścieżka nawigacji

Nikt nie musi pytać „na której to było stronie?”. Raport pokazuje po kolei adresy wszystkich stron odwiedzonych podczas nagrania, nad danymi o środowisku.

Co mówiłeś, obok każdego zrzutu

Sekcja Detailed Timeline / Observations zamienia nagranie w krótkie obserwacje. Każda pokazuje, skąd pochodzi:

• Source timing: m:ss - m:ss: dokładny fragment nagrania;
• Approximate timing albo Timing unavailable, gdy dopasowanie jest mniej pewne.

Jeśli AI nie jest pewne części raportu, raport to zaznacza, na przykład „AI confidence is low. Check the report against the source.”

Edytuj krok

Tytuł, Steps to Reproduce i elementy osi czasu można edytować. Kliknij tekst, żeby go zmienić. Zmienione elementy dostają plakietkę Edited. Usunięte można przywrócić: „Report item removed. Restore is available below.” Przyciskiem Revert w panelu lokalnych zmian cofniesz edycję.

Dodaj oczekiwany rezultat

W polu Expected result (podpowiedź: „What should happen?”) wpisz, co powinno było się stać. Pole mieści do 1200 znaków i zapisuje się automatycznie. Status pokazuje Saved, Unsaved changes lub Save failed. Oczekiwany rezultat trafia do wysyłanego raportu i jest widoczny dla agenta.

Co jest w raporcie

Zapisane raporty

W panelu bocznym → Saved reports zobaczysz raporty zapisane w tej przeglądarce. Raport możesz przypiąć do bieżącej karty, odpiąć albo usunąć. Lokalnie mieści się do 50 raportów (250 MiB), a Voice2Bug ostrzega przed zbliżeniem się do limitu. Usunięcie raportu z wtyczki nie usuwa kopii wysłanych już na serwer, do Jiry ani e-mailem.

Wszystkie sposoby wysyłki

Wysyłka do Jiry

1. Na karcie Jira wybierz Project i Issue type.
2. Kliknij Send to Jira. Zobaczysz „Created Jira issue KEY.”
3. Po zmianie raportu przycisk zmienia się na Update Jira ticket.

Zgłoszenie zawiera ścieżkę nawigacji, środowisko, oczekiwany rezultat, kroki, oś czasu, logi aktywności i ruch sieciowy, a zrzuty są w załącznikach.

• YOLO mode wysyła raport automatycznie po jego wygenerowaniu.
• Gdy zobaczysz „Delivery is unconfirmed. Check Jira before trying again.”, zajrzyj do Jiry przed ponowną wysyłką, żeby nie zrobić duplikatu.
• Połączenie z Jirą ustawia administrator: Ustawienia wysyłki.

Wysyłka do Lineara

Zespół ustawia administrator, projekt jest opcjonalny. Wysyłka do Lineara jest zawsze ręczna. Kliknij Send to Linear, a po zmianach Update Linear ticket. Zgłoszenie ma te same sekcje co w Jirze, zrzuty i link do raportu Voice2Bug.

Wysyłka e-mailem

Adresata ustawia administrator, a raport pokazuje go pod przyciskami, na przykład Destination: QA inbox. Gdy nic nie ustawiono, zobaczysz Destination: not configured. Zaznacz Send a copy to me, żeby dostać kopię. Po wysyłce przycisk zmienia się na Send again. Gdy zobaczysz „Email delivery was not confirmed”, sprawdź skrzynkę przed ponowną wysyłką.

Tą drogą raporty może też odbierać helpdesk, który przyjmuje zgłoszenia e-mailem.

Udostępnij linkiem

• Raport otworzy każdy, kto ma link. Wysyłaj go tylko osobom, które powinny go zobaczyć.
• Link działa, dopóki nie zostanie wyłączony albo raport nie zostanie usunięty. Administrator wyłącza linki i usuwa raporty w panelu admina (zobacz Linki i usuwanie raportów).
• Strony raportów nie są indeksowane przez wyszukiwarki.

Co może przeczytać agent kodujący

Agent kodujący nie widzi Twojej przeglądarki. Voice2Bug daje mu dowody przez serwer MCP: podsumowanie, kroki, konsolę, sieć, działania użytkownika, nawigację, transkrypcję i zrzuty. Agent zaczyna, gdy wydasz mu polecenie, na przykład „Fix the latest Voice2Bug report.”

Połączenie jest tylko do odczytu: „The connection cannot create, modify, or delete reports.”

Podłącz Claude Code

1. W panelu admina otwórz Connect coding agent → Claude Code i kliknij Copy Command. Polecenie zawiera już nazwę profilu Twojego workspace'u i adres serwera.
2. Wklej je w terminalu. Ma taką postać:

   claude mcp add --transport http --scope user <profile> "<server URL>" && claude mcp login <profile>

3. Otworzy się strona Connect a coding agent to Voice2Bug. Zaloguj się kontem Voice2Bug i zatwierdź.

Claude Code musi być wcześniej zalogowany (claude auth login).

Podłącz Codex

Te same kroki, w zakładce Codex w Connect coding agent:

codex mcp add <profile> --url "<server URL>" && codex mcp login <profile>

Zobacz Codex naprawia ostatni raport.

Claude Code naprawia ostatni raport

Przykładowe polecenia:

• Fix the latest Voice2Bug report.
• Read Voice2Bug report <link or ID> and find the root cause. Don't change code yet.
• Show me the failing network requests from the latest Voice2Bug report.

Agent sam decyduje, które narzędzia wywołać. Zwykle zaczyna od podsumowania, a potem czyta potrzebną konsolę, sieć i zrzuty. Jego zmiany sprawdzaj tak, jak każdy pull request.

Codex naprawia ostatni raport

Polecenia są te same co dla Claude Code.

Limity i odłączanie

• Agent czyta raporty z workspace'u, z którym jest połączony.
• Limity: 60 zapytań na minutę na połączenie. Zrzuty do 2 MB każdy.
• Żeby odłączyć agenta, otwórz panel admina → Connect coding agent → Active connections → Disconnect. Lokalnie uruchom claude mcp remove --scope user <profile> albo codex mcp remove <profile>.

Logowanie i zapraszanie zespołu

Do panelu admina zalogujesz się e-mailem i hasłem albo przez Magic Link. Strona Start prowadzi przez konfigurację: potwierdzenie organizacji, instalację i aktywację wtyczki, pierwszy raport i jego sprawdzenie, ustawienie wysyłki i wysłanie pierwszego raportu.

Otwórz Team → Invite User i podaj e-mail, imię i rolę:

Panel domyślnie jest po angielsku. Polski włączysz w Settings.

Ustawienia wysyłki: e-mail, Jira i Linear

W Integrations (Configure report delivery) kliknij Add Channel:

• E-mail: nazwa, odbiorcy albo adres przyjmowania zgłoszeń w helpdesku, czy to domyślny adresat, sekcje raportu i wysyłka automatyczna lub ręczna.
• Jira Cloud: Connect to Jira, potem domyślny projekt i typ zgłoszenia.
• Linear: Connect to Linear, potem zespół i opcjonalnie projekt.

Dozwolone strony

Wybierz, gdzie zespół może nagrywać: All pages albo Limited, czyli tylko na wpisanych stronach. Na pozostałych nagranie się nie uruchomi, a użytkownik zobaczy dlaczego. Możesz też wpisać domeny pomijane w ruchu sieciowym, na przykład analitykę albo usługi zewnętrzne.

Linki i usuwanie raportów

Bug Reports pokazuje raporty workspace'u z ich statusem (Submitted, Reviewing, Approved, Flagged, Archived). W widoku udostępnionych linków wyłączysz link do raportu albo usuniesz raport na stałe. Usunięcia nie da się cofnąć.

Test i dostęp

Przez 30 dni testu workspace ma pełny dostęp i nielimitowane raporty, bez karty i bez automatycznej płatności. Po końcu testu nagrywanie, treść raportów, eksporty i linki są zablokowane, ale konto i dane nie są automatycznie usuwane. Status pokazuje okno Access oraz Organisation → Current plan. Żeby kontynuować, napisz na support@voice2bug.com.

Jakie przeglądarki są obsługiwane?

Google Chrome 145 lub nowszy na komputerze. Inne przeglądarki nie są obsługiwane, a wtyczka nie działa w oknach incognito.

Dlaczego nie mogę nagrywać na tej stronie?

• To nie jest zwykła strona internetowa (na przykład ustawienia chrome://). Otwórz zwykłą stronę http(s).
• Karta była otwarta przed instalacją wtyczki: „Refresh this tab or open a regular webpage, then click Voice2Bug again.”
• Organizacja pozwala nagrywać tylko na wybranych stronach.
• Lokalna pamięć jest pełna: „Local report storage is full. Remove a saved report before recording again.”

Czy muszę mówić?

Nie. Głos i zrzuty są opcjonalne. Bez głosu raport powstaje z działań, zrzutów, logów i zapytań sieciowych. Mówienie daje raportowi „dlaczego”: czego się spodziewałeś i co wyglądało źle.

W jakich językach mogę mówić?

Język mowy wykrywa się automatycznie. Jakość raportów sprawdziliśmy dla polskiego i angielskiego.

Czy agent kodujący może zmienić albo usunąć raporty?

Nie. Połączenie MCP jest tylko do odczytu. Agent może czytać raporty, ale nie może ich tworzyć, zmieniać ani usuwać.

Gdzie są przechowywane dane i jak długo?

Zebrane dane zostają w przeglądarce, dopóki nie wygenerujesz raportu. Raporty są przechowywane, dopóki Ty lub administrator ich nie usuniecie, a linki działają do czasu ich wyłączenia. Podmioty przetwarzające i miejsca przechowywania opisuje polityka prywatności.