Átnéző ügynökök indítása

Ez az útmutató bemutatja, hogyan indíthat átnéző ügynököket pull requestek átnézéséhez.

A PR nézetéből

1. Nyissa meg a PR-t, és lépjen az Áttekintés fülére
2. Nyissa meg a ⋯ túlcsordulásmenüt, és válassza a Kérdezze az AI-t lehetőséget

Ez elindítja az alapból létrehozott pr_review pipeline-t, amely megnyitja a PR átnézési terét, és elindítja az átnézőket a munkaterület átnézési szintje szerint — alapértelmezés szerint hármat (az alapból létrehozott qa, architect és engineer ügynököt) —, majd a vezető ügynökkel konszolidáltatja az eredményt. Ezen az útvonalon Ön nem választja ki a szerepköröket. Ha kézben szeretné tartani, hogy mely szerepkörök fussanak, és melyikük mely fájlokat vizsgálja, használja az alábbi MCP eszközt vagy egy pipeline-lépést.

A dispatch_reviewers MCP eszközzel

Hívja meg egy meglévő átnézési térből:

dispatch_reviewers(
  space_id: "...",
  workspace_id: "...",
  reviewers: [
    {role: "reviewer"},
    {role: "security", scope: "src/auth/**"}
  ]
)

A space_id, a workspace_id és a reviewers mind kötelező. Minden átnézőspecifikáció egy role mezőt vesz át, valamint egy opcionális fájl-glob scope és egy prompt_override mezőt, amely lecseréli az alapértelmezett utasítást. Egy opcionális concurrency (1–8) korlátozza a párhuzamos indításokat; ha hiányzik, a munkaterület review_concurrency beállítása él (alapértelmezés szerint 3, a Beállítások → Munkaterület → Általános helyen állítható be).

Az eszköz azonnal visszatér a dispatched és az unmatched listával. Minden elindított átnéző résztvevőként bekerül a térbe, egy rendszerüzenet jelenti be, és a saját utasításával indul el. A megállapítások review_node üzenetekként érkeznek meg abba a térbe.

Indítás pipeline-lépésből

Nyissa meg a Beállítások → Munkaterület → Pipeline-sablonok helyet, nyisson meg egy sablont, majd:

1. Adjon hozzá egy Reviewer (prompt) csomópontot a palettáról
2. Válassza ki az elindítandó ügynököt, és írja meg az átnéző promptját, {{key}} helyőrzőkkel hivatkozva a felsőbb lépések kimeneteire (például {{repo_local_path}}, {{pr_number}})
3. Állítsa be a kimeneti kulcsot (alapértelmezés szerint reviewer_findings), hogy az alsóbb lépések olvashassák a megállapításokat

A lépés elindítja az ügynököt, és felfüggeszti magát, amíg az a futtatás be nem fejeződik. A motor ezután begyűjti a futtatás submit_output payloadját a pipeline állapotába, a csomópont kimeneti kulcsa alatt. (A paletta leírása még mindig azt írja, hogy a lépés egy complete_task hívásra vár — ilyen eszköz nem létezik; hagyja figyelmen kívül ezt a szöveget.)

Ágaztasson szét úgy, hogy több átnézőcsomópontot köt ugyanahhoz a felsőbb lépéshez, majd konszolidálja a kimeneteiket egy Consolidate (join) csomóponttal.

A szerkesztő minden elérhető nyelőhöz átkötözi a rejtett terminált, így az alapból létrehozott Step után hozzáadott csomópont is lefut. Az ugyanahhoz a felsőbb lépéshez bekötött szétágazó csomópontok párhuzamosan futnak.

Automatikus indítás új PR esetén

Ahhoz, hogy egy átnézési pipeline magától elinduljon:

1. Nyissa meg a sablont a Beállítások → Munkaterület → Pipeline-sablonok helyen
2. Húzza a PR közzétéve vagy a Külső PR megnyitva elemet a csomópontkönyvtár Triggerek szakaszából a vászonra (vagy válassza ki a Trigger hozzáadása szellemcsempéről)
3. Válassza ki az új csomópontot, és kapcsolja be az Engedélyezve lehetőséget a vizsgálójában, majd engedélyezze a sablont

Két esemény számít itt, és ezek nem felcserélhetők:

Esemény	Akkor tüzel, amikor	Payload-kulcsok
PullRequestPublished	Egy PR a Control Centeren keresztül nyílik meg — a PR-összeállító felületen, vagy amikor egy ügynök meghívja a pr_lifecycle.publish műveletet	pr_id, workspace_id, repo_owner, repo_name
ExternalPrDetected	A PR-lekérdező szolgáltatás egy közvetlenül a GitHubon megnyitott PR-t talál	repo_owner, repo_name, pr_number, pr_title, author

A github.com-on megnyitott PR soha nem váltja ki a PullRequestPublished eseményt, ezért egy csak ahhoz az eseményhez bekötött sablon nem fogja észlelni. Vegye figyelembe azt is, hogy a PullRequestPublished nem hordoz pr_number mezőt — egy olyan lépést, amelynek a szkriptje vagy a promptja a {{pr_number}} értékre hivatkozik, az ExternalPrDetected eseményből kell megtáplálni, vagy egy kézi futtatásból, amely megadja azt.

Ellenőrzőpont: engedélyezés után nyissa meg a Pipeline-ok oldalt, és győződjön meg róla, hogy megjelenik egy futtatás a következő illeszkedő PR-nál. Egy letiltva hagyott sablon eseményindítója a semmibe tüzel — a motor elutasítja a letiltott sablont, és futtatás indítása nélkül tér vissza.

Hogyan párosul egy szerepkör egy ügynökhöz

A dispatch_reviewers a munkaterület minden ügynökét pontozza az egyes kért szerepkörcímkék ellenében, a kis- és nagybetűk megkülönböztetése nélkül:

Illeszkedés	Pontszám
Egy készség, amely tartalmazza a szerepkörcímkét	+3
Egy cím, amely tartalmazza a szerepkörcímkét	+2
Egy ügynöknév, amely tartalmazza a szerepkörcímkét	+1

A pontszámok összeadódnak, és a legmagasabb összeg nyer (holtverseny esetén az elsőként megtalált jelölt). Ha egyetlen jelölt sem ér el nullánál nagyobb pontszámot, a specifikáció az eszköz unmatched listájában tér vissza ahelyett, hogy elindulna — így egy olyan szerepkör, amelyhez senki sem illeszkedik, jelentésre kerül, és soha nem marad ki csendben.

Az átnézési tér

Egy PR-hez pontosan egy átnézési tér tartozik, nem átnézőnként egy. A pr.ensureSpace idempotensen hozza létre, egy ReviewSpaceAssociation kapcsolja a PR-hez, és a PR head refjéhez provisionálódik. Minden elindított átnéző csatlakozik ehhez a térhez, és ott teszi közzé a review_node megállapításait; éppen ez teszi összehasonlíthatóvá a megállapításokat, és ez teszi lehetővé, hogy a vezető ügynök konszenzusra jusson köztük.

Az indítás figyelése

Minden elindított átnéző saját AgentRunLog-ot kap. A haladást itt követheti:

• Az átnézési tér, ahol a megállapítások élőben, folyamatosan érkeznek be
• A PR Átnézés füle, amely az átnézés állapotsávját és az ítéletet mutatja
• A Megfigyelhetőség → Élő (/workspaces/:id/observability) oldal, az ügynöknévsor futásonkénti állapottal, élő eltelt idővel, átiratfiókkal és leállításvezérlővel. Nincs hozzá billentyűparancs — az oldalsáv láblécéből érheti el.

Kapcsolódó útmutatók

• MI-alapú átnézés használata
• PR átnézése és összefésülése
• Pipeline-eseményindítók beállítása

Kapcsolódó fogalmak

• MI-átnézés
• Pipeline-ok és automatizálás