Facade CodeRozwiązywanie problemów
Ustal, czy problem wynika z konfiguracji uruchamiania, z CLI czy z dostawcy modeli.
Sprawdź konfigurację uruchamiania
Uruchom polecenie Show Agent Launch z palety poleceń i wybierz folder roboczy. Raport pokazuje, jak każde CLI uruchomiłoby się teraz w tym miejscu: plik wykonywalny, katalog, argumenty i nazwy zmiennych środowiskowych. Wartości prywatne są ukryte.
Raport opisuje następne uruchomienie z bieżącymi ustawieniami. Nie opisuje agenta, który już działa. Jeśli żądanie się powiedzie, statystyki użycia dostawcy mogą potwierdzić, które konto je obsłużyło.
Znajdź swój problem
| Problem | Co sprawdzić |
|---|---|
| Nie możesz znaleźć pliku ustawień | Wybierz Open Settings, a następnie Edit in facade.json w sekcji Facade: Home. Jeśli zdalne okno otwiera ustawienia jako JSON, polecenie otwiera facade.json bezpośrednio. |
| Wpis nie pojawia się w New Agent | Sprawdź nazwę wpisu i jego pole type oraz upewnij się, że nie jest wyłączony przez enabled: false. Nieprawidłowe wpisy są widoczne w sekcji Unavailable wraz z przyczyną. |
| Nie można znaleźć pliku wykonywalnego | Zainstaluj CLI tam, gdzie działa projekt, albo podaj pełną ścieżkę w polu command. W przypadku OpenCode użyj wersji 2 (@opencode/cli). |
| Brakuje zmiennej wskazanej w odwołaniu środowiskowym | Host edytora musi mieć tę zmienną przed uruchomieniem agenta. Wyeksportowanie jej w otwartym terminalu nie zmienia środowiska hosta. |
| Argument koliduje z opcją kontrolowaną przez Facade | Usuń tę opcję z pola args. Zamiast tego użyj pola model, effort lub yolo na najwyższym poziomie. |
| Uwierzytelnianie kończy się niepowodzeniem lub model jest niedostępny | Sprawdź u dostawcy klucz, endpoint, region, identyfikator modelu i dostęp do konta. |
| Dostawca Codex nie odpowiada | Upewnij się, że jego endpoint obsługuje Responses API. |
| Agent nie widzi innego agenta | Sprawdź, czy ich projekty są połączone przez ten sam katalog Facade i czy ustawienia dostępu pozwalają na komunikację. |
| Własny program nie otrzymuje wiadomości | Wpisuj polecenia w jego terminalu. Wpisy custom nie otrzymują komunikacji ani narzędzi Facade. |
| Zapisane ustawienia nie zmieniły działającego agenta | Uruchom nowego agenta. Aby zachować rozmowę, zakończ agenta, a następnie uruchom go ponownie poleceniem Resume Agent z nowymi ustawieniami. |
Konfigurację SSH opisuje artykuł Uruchamiaj agentów na zdalnej maszynie, a błędy połączenia z telefonem — Kontynuuj z telefonu.
Zgłoś problem
Podaj, co próbowałeś zrobić, dokładny komunikat błędu, system operacyjny, wersje edytora i rozszerzenia, wersję CLI oraz wybrany wpis. Jeśli to możliwe, dołącz odpowiednie ustawienia z usuniętymi kluczami i wartościami prywatnymi.