Använd planläge

Den här guiden visar hur du får fram en strukturerad plan från en agent innan den skriver någon kod.

I planläge researchar agenten skrivskyddat och dess enda leverabel är en typad plan: en beroendegraf av steg som du godkänner och som Control Center sedan kompilerar till verkligt arbete. Använd det när du vill se omfånget för en ändring, få stegen nedbrutna eller få risker och beroenden namngivna innan något rörs.

Växla en yta till planläge

Vilket som helst av följande växlar ytans läge, och ändringen sparas:

• Välj Plan i lägesmenyn längst till vänster i composerns verktygsfält
• Tryck på Shift+Tab
• Skicka /plan. Ett bart /plan aktiverar bara läget; /plan <request> aktiverar det och skickar resten som ditt meddelande

/plan färdas aldrig som text – det ställer in det lagrade läget, vilket är den auktoritet som verktygsytan, räckesförinställningen och prompten alla läser. Läget gäller därför för den här turen och varje tur efter den, tills du ändrar tillbaka det.

Läget lagras på ytan, så samma agent kan vara i planläge här och i agentläge någon annanstans.

Vad agenten producerar

1. Den researchar skrivskyddat – minnet, kodindexet, filer
2. Den anropar submit_plan en gång, med ett goal plus nodes där varje nod bär en stabil key, en title, en description och de nodnycklar som den dependsOn (vilket är det som låter oberoende arbete köra parallellt)
3. Den stannar

Verktyget validerar grafen – dubbla nycklar, hängande beroenden, cykler – och returnerar överträdelser som agenten ska åtgärda i stället för att acceptera en trasig plan.

Planen visas i samtalet som en kompakt rad som visar målet, dess status och antalet steg. Plan Studio – beroendegrafen, inspektorn per nod och kostnadsuppskattningen – öppnas som en flik bredvid samtalet: tryck på Öppna på raden, eller vänta helt enkelt, för en plan som landar inom 30 sekunder medan du tittar på samtalet öppnar sin flik själv.

Skrivskyddsgarantin är strukturell, men bara i den inbyggda harnessen

Control Centers egen harness bygger agentens verktygsregister från planlägets specifikation av verktygsytan, så det finns helt enkelt inget skriv-, redigerings- eller kommandoverktyg att anropa – begränsningen är inte en promptinstruktion som modellen kan prata sig ur.

Claude Code-adaptern får ingen sådan filtrering: läget når den som en begäran som dess egen runner kan följa eller inte, och Control Center ser bara dess mcp__*-anrop. Verkställandebrickan bredvid lägesmenyn visas exakt när så är fallet.

Agenten kan ställa klargörande frågor till dig

När begäran är tvetydig kan en planagent pausa och ställa upp till tre blockerande frågor till dig med verktyget ask_user. Det renderar ett formulär i samtalet – alternativ eller fritext – och körningen blockeras tills du svarar. Verktyget ligger på läsnivå, så det överlever planlägets skrivskyddade yta, och det är undantaget från godkännandeomslaget (en prompt framför en prompt skulle misslyckas stängt när ingen godkännare är ansluten, vilket nekar agenten själva akten att fråga).

Det behöver en yta att renderas i, så en engångsdispatch utan samtal får det inte. Att frontlasta omfånget, målrepot och acceptanskriterierna i ditt första meddelande är fortfarande snabbare än en tur och retur.

Prosa är ingen leverabel här. En körning som slutar utan att anropa submit_plan publicerar en synlig rad “Ended without submitting a plan (no submit_plan call).” i samtalet och flaggar körningen som en som missat sin leverabel. Körningens status stannar medvetet på completed – det håller pipelines och ärendens tillståndsmaskiner orörda – så läs raden, inte statusbrickan.

Godkänn planen

Från planens rad i samtalet trycker du på Godkänn och kör. I Plan Studios godkännandefält trycker du på Godkänn plan (eller Avvisa bredvid; godkännande är inaktiverat så länge grafen har ett valideringsfel).

Sedan:

1. Control Center kompilerar planen till en orkestrering och materialiserar den – ärendena och körningen. Ingen modell är inblandad i det här steget; det är deterministiskt
2. Planen körs som den agent som skrev den. Om någon annan ska kopplas in är den agentens beslut vid körning – den kan delegate_task ett steg till en bättre lämpad teamkamrat, inom arbetsytans tak för delegeringsdjup
3. Planens mål blir samtalets mål och arbetet körs i samma samtal: varje steg publicerar vad agenten ombads göra och strömmar tillbaka sin tur, så du följer det (och kan stoppa en tur) där du redan är
4. Målraden i samtalets Allmänt-sidopanel (under Att göra) bär körningens framsteg som settled/total och dess stoppknapp; Plan Studio visar tillstånd per nod i grafen och kan avbryta där också

Fortsätt arbeta utan att godkänna

Om du hellre stannar i det här samtalet än godkänner planen kan agenten anropa exit_plan_mode. Det är den enda sanktionerade utgången: den öppnar en varaktig godkännandebegäran kopplad till samtalet och returnerar pending – ytan förblir i planläge och agenten får inte agera. När begäran har godkänts växlar agentens nästa exit_plan_mode-anrop ytan från planläge till agentläge och låser upp dess muterande verktyg. En avvisning låter den öppna en ny begäran mot en reviderad plan.

För att lämna planläget växlar du composerns dropdown-meny (eller Shift+Tab), eller godkänner den inskickade planen. exit_plan_mode öppnar ett varaktigt godkännande som avgörs med MCP-verktyget decide_approval. Överlägget för räcken för blockerade verktygsanrop är en annan kö i minnet och bär inte planutgångsbegäranden.

Planläge i ett pipelinesteg

En pipelinenod av typen messaging.createSpace läser samtalets läge från nodkonfigurationens extra mode – extras['mode']: 'plan'. Nyckeln kräver exakt matchning: varje annan stavning, inklusive conversationMode eller dispatchMode, ignoreras tyst och ytan faller tillbaka på bodyns standardvärde, vilket är läget granskning, inte chatt. Ett promptAgent-steg ansluter till en yta som det inte skapade och ändrar inte dess behörigheter. Nodkonfigurationsredigerarens Utskicksläge-väljare (allParallel / manager) är till för noder som skickar ut team. Ange samtalets läge med extras['mode'] på en mall som öppnar ytan, eller på den nodens konfiguration via API:et.

Relaterade guider

• Chatta med en agent
• Använd ytor
• Arbeta i Plan Studio
• Kör en orkestrering

Relaterade koncept

• Lägen
• Orkestrering