Koordinatorens ansvar

Fordi intet nedarves, opbygger koordinatoren hver underagent-prompt som en selvstændig briefing. Bemærk, hvordan målet, begrænsningerne og den specifikke del af arbejdet alle er beskrevet tydeligt — underagenten kunne køre på en maskine, der aldrig havde set samtalen.

Det er også derfor, at en AgentDefinition indeholder en system_prompt og allowed_tools efter princippet om mindst mulige privilegier: Hver underagent er afgrænset til sin rolle og får kun det, den har brug for.

Opdeling handler om at vælge, hvordan arbejdet skal opdeles. Der er to strategier, og eksamen forventer, at du matcher strategien med situationen:

• Fast arbejdsgang / promptkædning — til et kendt, sekventielt sæt trin (f.eks. udtræk -> valider -> formatér). Strukturen besluttes på forhånd.
• Adaptiv opdeling — til åbne undersøgelser, hvor du ikke kan kende delopgaverne, før du går i gang (f.eks. et undersøgelsesspørgsmål, der forgrener sig, efterhånden som du lærer mere).

Et andet opdelingsmønster, der er værd at kende, er kodegennemgang i flere gennemløb. Udfør først et lokalt gennemløb pr. fil og derefter et separat integrationsgennemløb på tværs af filer. En kodegennemgang af flere filer i ét gennemløb spreder modellens opmærksomhed og overser både lokale fejl og integrationsproblemer.

Koordinatoren delegerer ved at udstede Task-kald. Den afgørende ydelsesegenskab er: Flere Task-kald i ét svar kører parallelt.

For uafhængige delopgaver — tre undersøgelsesspørgsmål eller tre filer, der skal gennemgås — skal du udsende alle Task-kald samlet i stedet for ét pr. tur. Du får samtidighed uden ekstra arbejde.

Eksamen tester to forudsætninger: Koordinatorens allowedTools skal indeholde "Task", og hver underagent skal modtage hele sin kontekst eksplicit (Scene 2).

At dirigere betyder at sende hver delopgave til den rigtige underagent. Claude vælger primært ud fra agentens og værktøjets beskrivelser — ikke navnene.

En god beskrivelse angiver formålet, hvad den returnerer, inputformater med eksempler og grænserne for, hvornår den kan anvendes. Overlappende eller tvetydige beskrivelser fører til fejldirigering: Hvis to underagenter lyder, som om de begge håndterer 'data', kan koordinatoren vælge forkert.

Afgræns hver underagent snævert. Hold dig til 4-5 værktøjer pr. agent som det optimale punkt; 18+ værktøjer forringer pålideligheden af valget. Værktøjer efter princippet om mindst mulige privilegier handler ikke kun om sikkerhed — de gør dirigeringen mere præcis.

Når underagenterne vender tilbage, samler koordinatoren deres output i ét sammenhængende svar. Det er mere end sammenkædning.

• Bevar kildegrundlaget: Hver påstand skal kunne knyttes til sin kilde (URL, dokumentnavn, citat og udgivelsesdato).
• Annotér konflikter i stedet for stiltiende at vælge ét tal — og husk, at datoer ofte løser tilsyneladende modsigelser.
• Gengiv efter indholdstype: tabeller til økonomiske oplysninger, prosa til nyheder og lister til tekniske fund.

Samlingen er også det sted, hvor du bevarer delvise resultater: Hvis én underagent mislykkes, fletter koordinatoren stadig det sammen, der lykkedes, og markerer tydeligt, hvad der mangler.

Det femte ansvarsområde er det, der får skrøbelige systemer til at bryde sammen. Reglen er:

• Genopret forbigående fejl lokalt inde i underagenten (f.eks. en timeout — prøv igen dér).
• Eskalér fejl, der ikke kan genoprettes, opad med delvise resultater, så koordinatoren kan dirigere uden om dem.

To antimønstre, du skal undgå: at undertrykke en fejl i stilhed (koordinatoren får det aldrig at vide) og at afbryde hele arbejdsgangen, fordi én underagent mislykkedes. Én fejlende gren bør ikke få hubben til at bryde sammen.

Det er afgørende at skelne mellem en adgangsFEJL (som måske kan forsøges igen) og et gyldigt TOMT resultat (ingen match — slet ikke en fejl).

Koordinatoren kan kun dirigere uden om en fejl, hvis fejlen fortæller den tilstrækkeligt. En generisk "Operation failed" blokerer genoprettelse. En struktureret fejl muliggør intelligent dirigering.

Struktureret fejlkontekst omfatter fejltypen eller -kategorien, om den kan forsøges igen, den forespørgsel der blev forsøgt, eventuelle delvise resultater og alternativer. Med disse oplysninger beslutter koordinatoren, om den skal prøve igen, prøve et andet værktøj, flette delvise resultater eller eskalere.

Koordinatoren kører en agentisk løkke: Send forespørgslen, undersøg stop_reason, og hvis den er tool_use, så kør værktøjerne (herunder Task-delegeringer), tilføj resultaterne til historikken, og gentag indtil end_turn.

Afslut ved stop_reason — aldrig ved at analysere modellens tekst for ord som 'færdig' eller 'afsluttet'. Beslutninger om, hvornår arbejdet er fuldført, er modelstyrede. En iterationsgrænse er et sikkerhedsnet, ikke den primære stopmekanisme.

Brug fastkodet styring til garantier, som du skal håndhæve; lad ellers modellen bestemme forløbet.

Nogle fejl er ikke koordinatorens opgave at løse — de hører under et menneske. Gode udløsere for eskalering er:

• En udtrykkelig anmodning fra et menneske — eskalér med det samme.
• Politikhuller, som agenten ikke har en regel for.
• Manglende fremskridt efter rimelige forsøg.
• Overskridelse af tærskler (f.eks. en tilbagebetaling over en grænse).

Dårlige udløsere, som eksamen vil tilbyde som distraktorer: sentimentanalyse, modellens egen selvvurderede sikkerhed (1-10) eller klassifikatorer, der ikke er trænet til formålet. Og når en forretningsregel har økonomiske, juridiske eller sikkerhedsmæssige konsekvenser, skal du håndhæve den med et deterministisk hook, ikke med vejledning i en prompt — hooks er 100 % deterministiske, mens prompts kun er cirka 90 % sandsynlige.

Du kan nu tænke på en koordinator som en arkitekt:

• Dekomponér — brug faste pipelines til kendte sekvenser og adaptive pipelines til åbent arbejde; brug flere gennemløb (lokalt og derefter på tværs af filer) til kodereview.
• Uddelegér — udsend flere Task-kald i ét svar for at køre dem parallelt; medtag 'Task' i allowedTools.
• Dirigér — præcise beskrivelser uden overlap vælger den rigtige specialist; brug 4-5 værktøjer pr. agent.
• Aggregér — flet resultater med oprindelsesoplysninger, annotér konflikter, og bevar delvise resultater.
• Håndtér fejl — genopret lokalt efter midlertidige fejl; eskalér fejl, der ikke kan genoprettes fra, med struktureret kontekst og delvise resultater; undertryk eller afbryd aldrig hele arbejdsgangen i stilhed.

Frem for alt: underagenter arver ingen historik — videregiv konteksten eksplicit, og stop ved stop_reason, aldrig ved fortolket tekst. Håndhæv regler for økonomi, jura og sikkerhed med deterministiske hooks. Når du mestrer dette, har du styr på orkestreringsscenarierne.