# Błędy

> Komunikaty błędów, które zwracają narzędzia DevHub, i co zmienić w następnym wywołaniu.

Błąd DevHub mówi, co poprawić. Popraw argument i wywołaj ponownie. Jeden błąd nigdy nie jest powodem, by do końca sesji przestać używać DevHub. Komunikaty zwracane przez narzędzia są po angielsku i tak je tu podano.

## Dostęp i dostępność

| Komunikat                                                   | Co znaczy                                                                                                     | Co zrobić                                                                                                    |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `sign in required` (przy każdym żądaniu)                    | sesja użytkownika się skończyła; serwer przestał odpowiadać                                                   | powiedz użytkownikowi, by zalogował się do DevHub ponownie. Nie ponawiaj w pętli                             |
| `MCP tool "<name>" is disabled in Settings`                 | użytkownik wyłączył narzędzie                                                                                 | użyj innego narzędzia albo poproś użytkownika o włączenie go w Ustawienia > Serwer MCP > Dozwolone narzędzia |
| `MCP tool "<name>" is not available: requires <permission>` | plan Vartari użytkownika nie obejmuje tego obszaru dla agentów albo nie na poziomie, którego narzędzie wymaga | nie ponawiaj. Powiedz użytkownikowi, jakie uprawnienie komunikat wymienia                                    |
| `MCP tool "<name>" is not enabled for this endpoint`        | profil tego punktu końcowego nie oferuje narzędzia                                                            | użyj narzędzia, które dostajesz                                                                              |
| `Unknown tool`                                              | taka nazwa nie istnieje                                                                                       | bierz nazwy z listy narzędzi, nie z pamięci                                                                  |
| `<area> is not configured` lub `is not available`           | funkcja nie jest skonfigurowana w DevHub                                                                      | powiedz użytkownikowi; w wywołaniu nie ma czego poprawiać                                                    |

## Argumenty

| Komunikat                                                                     | Co zrobić                                                                                         |
| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `A claim needs an owner`                                                      | podaj `by` w `plan_claim` lub `plan_renew`                                                        |
| `query is required`                                                           | podaj niepusty `query`                                                                            |
| `workspaceId is required when saving a screenshot`                            | podaj `workspaceId` razem z `save`                                                                |
| `wait must be seconds from 0 to 45`                                           | podaj `wait` od 0 do 45                                                                           |
| `allowAgents must be true or false`                                           | podaj wartość logiczną                                                                            |
| `Request too large`                                                           | wyślij mniej w jednym wywołaniu; podziel treść                                                    |
| niezgodność hasha lub tekstu w `file_edit`, `file_replace`, `vault_file_edit` | przeczytaj plik ponownie i zbuduj edycję od nowa z nowego tekstu                                  |
| `already exists` przy tworzeniu                                               | plik już jest. Przeczytaj go; użyj `file_replace` lub `file_write`, jeśli zamiana jest zamierzona |
| skrypt jest odrzucany                                                         | `npm_script_list` pokazuje, co jest zadeklarowane. Uruchamiane są tylko zadeklarowane skrypty     |

## Vaulty

| Komunikat                                        | Co zrobić                                                                                                                                      |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `Vault not found or disabled`                    | weź `vaultId` z `vault_list`                                                                                                                   |
| `Vault is not configured for MCP write access`   | vault jest dla MCP tylko do odczytu. Poproś użytkownika o zezwolenie na zapis albo zapisz gdzie indziej                                        |
| `This note is in a knowledge folder: <problems>` | notatka łamie reguły tego folderu. Popraw to, co wylicza komunikat, i zapisz ponownie                                                          |
| `knowledge_search` nic nie zwraca                | brak wyniku nie oznacza braku notatki. `vault_overview`, potem `vault_files_search`; `knowledge_index_status`, potem `knowledge_index_refresh` |

## Punkty końcowe agentów

Agent uruchomiony przez DevHub pracuje według węższych reguł.

| Komunikat                                                                               | Co zrobić                                                    |
| --------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| `This agent works only in its own repository. Use its workspaceId.`                     | użyj `workspaceId` własnego repozytorium                     |
| `This agent may use only its own repository's, project's and organization's vaults.`    | weź `vaultId` z `vault_list`                                 |
| `This plan is not for this agent's repository.`                                         | bierz plany z `plan_ready`                                   |
| `An agent cannot start itself. Start a different agent, or answer the task yourself.`   | odpowiedz na zadanie samodzielnie albo uruchom innego agenta |
| `An agent cannot give another agent leave to start agents. Run it without allowAgents.` | pomiń `allowAgents`                                          |
| `An agent cannot close an investigation. …`                                             | napisz w odpowiedzi, że jest gotowe do zamknięcia            |

## Agenci i przebiegi

| Komunikat                                                                 | Co zrobić                                                                          |
| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| `No such agent on this endpoint. Call agent_list for the ones there are.` | weź `agentId` z `agent_list`                                                       |
| `No persona "<id>"` lub `No client "<id>"`                                | `agent_list` pokazuje to, co przyjmuje `agent_create`                              |
| `No such run`                                                             | weź `runId` z odpowiedzi `RUNNING`. Odpowiedź przebiegu jest przechowywana godzinę |
| `RUNNING <runId>`                                                         | to nie błąd. Wywołaj `agent_run_status` z `wait`                                   |

## Plany

| Komunikat                   | Co zrobić                                                                                                                                   |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| odmowa `plan_claim`         | odmowa podaje powód: ktoś trzyma krok, bramka jest otwarta albo krok w toku dotyka tych samych plików. Wywołaj `plan_ready` i weź inny krok |
| `Step not closed: <reason>` | katalog roboczy się nie scalił. Rozwiąż konflikt w katalogu roboczym, zrób commit i wywołaj `plan_close` ponownie                           |
| odmowa `plan_close`         | nie trzymasz kroku albo krok nie jest w stanie, który pozwala go zamknąć. Przeczytaj komunikat; `step_resume` pokazuje stan                 |
| odmowa `plan_create`        | identyfikator jest zajęty. Wybierz inny albo go pomiń                                                                                       |

## Szukanie przyczyny porażki

- `audit_list` z `tool` i `result` pokazuje nieudane wywołanie: argumenty, błąd, czas.
- `audit_analyze` pokazuje powtarzające się błędy i wolne narzędzia.
- `audit_summary` pokazuje odsetek udanych wywołań w oknie czasu.

## Powiązane

- [Ograniczenia](/pl/devhub/for-agents/limits/index.md)
- [Rozwiązywanie problemów](/pl/devhub/troubleshooting/index.md)
