Używaj trybu planu

Ten poradnik pokazuje, jak wydobyć z agenta ustrukturyzowany plan, zanim napisze on jakikolwiek kod.

W trybie planu agent prowadzi badania tylko do odczytu, a jego jedynym rezultatem jest typowany plan: graf zależności kroków, który zatwierdzasz, a Control Center następnie kompiluje go do rzeczywistej pracy. Użyj go, gdy chcesz poznać zakres zmiany, uzyskać rozbicie kroków albo poznać ryzyka i zależności, zanim cokolwiek zostanie tknięte.

Przełącz przestrzeń w tryb planu

Każda z tych czynności przełącza tryb przestrzeni, a zmiana jest utrwalana:

Wybierz Plan z listy rozwijanej trybów po skrajnej lewej stronie paska narzędzi pola tworzenia wiadomości
Naciśnij Shift+Tab
Wyślij /plan. Samo /plan tylko uzbraja tryb; /plan <request> uzbraja go i wysyła resztę jako Twoją wiadomość

/plan nigdy nie jest wysyłane jako tekst — ustawia zapisany tryb, czyli to, co czytają powierzchnia narzędzi, preset guardrailów i prompt. Tryb obowiązuje więc w tej turze i w każdej kolejnej, dopóki go nie zmienisz z powrotem.

Tryb jest przechowywany w przestrzeni, więc ten sam agent może być w trybie planu tutaj, a gdzie indziej w trybie agenta.

Co tworzy agent

Prowadzi badania tylko do odczytu — pamięć, indeks kodu, pliki
Wywołuje submit_plan raz, z goal oraz nodes, z których każdy niesie stały key, title, description i klucze węzłów, od których zależy (dependsOn) — to właśnie pozwala niezależnej pracy biec równolegle
Zatrzymuje się

Narzędzie waliduje graf — zduplikowane klucze, wiszące zależności, cykle — i zwraca naruszenia do poprawienia przez agenta, zamiast przyjąć zepsuty plan.

Plan pojawia się w rozmowie jako zwarty wiersz pokazujący cel, jego status i liczbę kroków. Plan Studio — graf zależności, inspektor węzłów i szacunek kosztów — otwiera się jako karta obok rozmowy: naciśnij Otwórz na wierszu albo po prostu poczekaj, bo plan, który pojawi się w ciągu 30 sekund, gdy patrzysz na rozmowę, sam otwiera swoją kartę.

Gdy żądanie jest niejednoznaczne, agent planu może się zatrzymać i zadać Ci maksymalnie trzy pytania blokujące narzędziem ask_user. Renderuje ono formularz w rozmowie — opcje albo dowolny tekst — a uruchomienie jest wstrzymane, dopóki nie odpowiesz. Narzędzie należy do poziomu odczytu, więc przetrwa powierzchnię tylko do odczytu trybu planu, i jest wyłączone z otoczki zatwierdzania (prośba o zatwierdzenie przed pytaniem domyślnie odmawia, gdy nie ma podłączonego zatwierdzającego, pozbawiając agenta samej możliwości zapytania).

Potrzebuje przestrzeni, w której może się wyrenderować, więc jednorazowe wysłanie bez rozmowy go nie otrzymuje. Podanie z góry zakresu, docelowego repozytorium i kryteriów akceptacji w pierwszej wiadomości i tak jest szybsze niż dodatkowa runda pytań i odpowiedzi.

Proza nie jest tu rezultatem. Uruchomienie, które kończy się bez wywołania submit_plan, publikuje w rozmowie widoczny wiersz “Ended without submitting a plan (no submit_plan call).” i oznacza uruchomienie jako takie, które nie dostarczyło swojego rezultatu. Status uruchomienia celowo pozostaje completed — dzięki temu maszyny stanów potoków i zgłoszeń pozostają nietknięte — więc czytaj ten wiersz, a nie plakietkę statusu.

Zatwierdź plan

Z wiersza planu w rozmowie naciśnij Zatwierdź i uruchom. Na pasku zatwierdzania Plan Studio naciśnij Zatwierdź plan (albo Odrzuć obok; zatwierdzanie jest wyłączone, dopóki graf ma błąd walidacji).

Następnie:

Control Center kompiluje plan do orkiestracji i materializuje go — czyli zgłoszenia i uruchomienie. W tym kroku nie uczestniczy żaden model; jest deterministyczny
Plan wykonuje się jako agent, który go napisał. To, czy włączyć kogoś jeszcze, jest decyzją tego agenta w czasie uruchomienia — może on przez delegate_task przekazać krok lepiej dopasowanemu członkowi zespołu, w granicach limitu głębokości delegowania obszaru roboczego
Cel planu staje się celem rozmowy, a praca biegnie w tej samej rozmowie: każdy krok publikuje to, o co poproszono agenta, i strumieniuje z powrotem jego turę, więc śledzisz ją (i możesz zatrzymać turę) tam, gdzie już jesteś
Wiersz celu w panelu bocznym Ogólne rozmowy (w sekcji Zadania) niesie postęp uruchomienia jako settled/total oraz jego przycisk zatrzymania; Plan Studio pokazuje stan poszczególnych węzłów na grafie i również tam pozwala anulować

Pracuj dalej bez zatwierdzania

Jeśli wolisz zostać w tej rozmowie, zamiast zatwierdzać plan, agent może wywołać exit_plan_mode. To jedyne sankcjonowane wyjście: otwiera trwałe żądanie zatwierdzenia powiązane z rozmową i zwraca pending — przestrzeń pozostaje w trybie planu, a agent nie może działać. Gdy żądanie zostanie zatwierdzone, następne wywołanie exit_plan_mode przez agenta przełącza przestrzeń z trybu planu na tryb agenta i odblokowuje jego narzędzia mutujące. Odrzucenie pozwala mu otworzyć nowe żądanie wobec zmienionego planu.

Aby opuścić tryb planu, przełącz listę rozwijaną w polu tworzenia wiadomości (albo Shift+Tab) lub zatwierdź przesłany plan. exit_plan_mode otwiera trwałe zatwierdzenie rozstrzygane narzędziem MCP decide_approval. Nakładka guardrailów dla zablokowanych wywołań narzędzi to inna, trzymana w pamięci kolejka i nie przenosi żądań wyjścia z trybu planu.

Tryb planu w kroku potoku

Węzeł potoku messaging.createSpace odczytuje tryb rozmowy z extra mode konfiguracji węzła — extras['mode']: 'plan'. Klucz wymaga dokładnego dopasowania: każda inna pisownia, w tym conversationMode lub dispatchMode, jest po cichu ignorowana, a pokój otrzymuje domyślną wartość treści, czyli tryb przeglądu, a nie czatu. Krok promptAgent dołącza do pokoju, którego nie utworzył, i nie nadaje mu ponownie uprawnień. Lista Tryb wysyłania w edytorze konfiguracji węzła (allParallel / manager) dotyczy węzłów wysyłania zespołu. Tryb rozmowy ustaw przez extras['mode'] w szablonie, który otwiera przestrzeń, albo w konfiguracji tego węzła przez API.