Agentenläufe und Zuschreibung
Wenn ein KI-Agent die Arbeit in Kanera wechselt, heißt es in der Akte. Seine Kommentare, Kartenänderungen und Aktivitätszeilen sind mit dem Namen des Agenten und der Person beschriftet, für die er gehandelt hat, sodass niemand die Agentenausgabe mit etwas verwechseln kann, das ein Teamkollege eingegeben hat. Während ein Agent eine Karte bearbeitet, kann er eine öffnen Ausführung: ein Live-Marker auf dem Kartenplättchen, der dem Rest des Teams mitteilt, dass die Arbeit bereits erledigt ist.
Wie Agentenarbeit zugeschrieben wird
Kanera zeichnet auf, wer eine Aktion basierend auf den dahinter stehenden Anmeldeinformationen durchgeführt hat.
| Verbindung | Wie seine Arbeit aussieht |
|---|---|
| OAuth, einschließlich Gerätecode | Als die Person, die den Agenten verbunden hat, mit a über <agent> Abzeichen. Der Agentenname ist der Name, unter dem sich der AI-Client registriert hat, z. B. Claude. |
| Persönlicher API-Schlüssel | Als Besitzer des Schlüssels, ohne Agentenbezeichnung. Ein Skript, das Sie mit Ihrem eigenen Schlüssel ausführen, liest sich vor. |
| Unbeaufsichtigter Agent oder Arbeitsbereich/Board-API-Schlüssel | Unter dem Verbindungs- oder Schlüsselnamen, nicht als Person. |
Der Unterschied liegt in der interaktiven OAuth-Gewährung, nicht im Transport. Die Kanera CLI unterstützt beides: Browser-Anmeldung mit kanera auth login --agent "Claude Code" Etiketten funktionieren über den Agenten, während die Anmeldung mit dem API-Schlüssel ihn als Besitzer des Schlüssels oder als Schlüssel aufzeichnet. Siehe Arbeiten Sie mit Codierungsagenten vom Terminal aus wie sich das auf einen Terminal-Workflow auswirkt.
Das Via-Abzeichen
Im Aktivitätsfeed einer Karte behält ein vom Agenten verfasster Kommentar den Namen und den Avatar der Person bei und fügt einen hinzu über <agent> Abzeichen daneben. Bewegen Sie den Mauszeiger über das Abzeichen, um beispielsweise zu sehen, wer den Kommentar für wen geschrieben hat Geschrieben von Claude im Auftrag von Amelia Hart. Kartenänderungen, die ein Agent vorgenommen hat, tragen dasselbe Abzeichen, mit einem Geschehen von … im Namen von … Tooltip.
Die Arbeit des Agenten unterliegt weiterhin der Rolle der verbundenen Person. Kanera überprüft bei jedem Schreibvorgang den aktuellen Zugriff auf das Zielboard, sodass ein Agent nichts tun kann, was seine Person nicht tun könnte.
Agent läuft
Ein Lauf ist die Arbeitssitzung eines Agenten auf einer Karte. Auf diese Weise verkündet ein Agent „Ich bin dabei“, bevor er mit der mehrstufigen Arbeit beginnt, und meldet den Fortschritt und das Ergebnis.
Starten Sie einen Lauf
Ein Agent startet einen Lauf mit dem runs.start MCP-Tool, das die Karte, einen kurzen Titel für die Arbeit und optional eine längere Fortschrittsnotiz und einen Link angibt, über den eine Person mitverfolgen kann, z. B. eine Pull-Anfrage oder ein Sitzungsprotokoll. Aus einer Shell stammt das gleiche Werkzeug kanera run start <card> "<title>", mit kanera run update und kanera run done berichten und abschließen. Integrationen können verwendet werden POST /api/v1/cards/{cardId}/agent-runs im öffentliche API.
Zum Starten oder Aktualisieren eines Laufs sind Editorzugriff auf die Platine der Karte und ein schreibberechtigter Berechtigungsnachweis erforderlich. Ein schreibgeschützter Schlüssel oder ein Beobachter können einen Lauf nicht öffnen.
Bevor es losgeht, sollte ein Agent anrufen runs.list B. um zu überprüfen, ob ein anderer Agent die Karte bereits bearbeitet, seinen eigenen Live-Lauf für dieselbe Aufgabe fortzusetzen oder den Live-Run-Konflikt eines anderen Agenten zu melden, bevor er überschneidende Arbeiten durchführt. Es gibt standardmäßig Live-Läufe oder den vollständigen Laufverlauf der Karte mit zurück includeEnded.
Der Chip auf dem Kartenplättchen
Während ein Lauf live ist, zeigt das Kartenplättchen vor dem Titel einen kleinen Glitzerchip. Bewegen Sie den Mauszeiger darüber oder lesen Sie es mit einem Screenreader, um den Agenten und die Arbeit zu sehen:
- Arbeiten: <Agent> funktioniert: <Titel>
- Auf eine Person warten: <Agent> wartet auf Sie: <Titel>, und der Chip wird bernsteinfarben.
Wenn mehr als ein Lauf auf der Karte aktiv ist, nennt das Etikett den ersten und fügt ihn hinzu (+N mehr). Der Chip wird in Echtzeit für alle Zuschauer aktualisiert und verschwindet, wenn der Lauf endet.
Ausführungszustände
| Status | Festgelegt von | Was es bedeutet |
|---|---|---|
running | Der Agent | Arbeiten. Jeder Lauf beginnt hier. |
blocked | Der Agent | Auf eine Person warten, beispielsweise eine Frage oder eine Genehmigung. Der Chip wird bernsteinfarben und Kartendetails werden angezeigt Ich warte auf dich. |
succeeded | Der Agent | Fertig. Beendet den Lauf. |
failed | Der Agent | Die Arbeit konnte nicht abgeschlossen werden. Beendet den Lauf. |
cancelled | Der Agent | Absichtlich angehalten. Beendet den Lauf. |
stalled | Kanera | Der Agent hat die Meldung eingestellt. |
running und blocked sind live und zeigen den Chip. Der Agent bewegt sich zwischen ihnen und meldet den Fortschritt mit runs.update, wobei die Zusammenfassung dessen, was gerade ausgeführt wird, auf eine Zeile beschränkt bleibt. succeeded, failed, und cancelled Beenden Sie den Lauf dauerhaft: Ein beendeter Lauf kann nicht geändert werden und eine weitere Aktualisierung wird abgelehnt.
Einen Lauf einstellen auf blocked wechselt den Chip. Es sendet selbst keine Benachrichtigung an irgendjemanden. Wenn der Agent eine bestimmte Person benötigt, sollte er auf der Karte auch einen Kommentar hinterlassen, der besagt, worauf er wartet.
Ins Stocken geratene Läufe
Jeder runs.update Anruf zählt als Herzschlag, auch wenn dieser nichts ändert. Kanera prüft jede Minute auf stille Läufe und markiert einen Live-Lauf stalled sobald fünfzehn Minuten ohne Herzschlag vergangen sind. Die runs.update Das Tool weist Agenten an, sich mindestens alle zehn Minuten zu melden.
Ein blockierter Lauf wird nicht mehr auf dem Chip angezeigt oder erscheint nicht mehr auf der Karte Agent läuft Abschnitt, sodass ein abgestürzter Agent eine Karte nicht so aussehen lassen kann, als sei sie belegt. Der Aktivitätsfeed der Karte zeichnet auf, dass Kanera den Lauf des Agenten als blockiert markiert. Ein angehaltener Lauf ist jedoch nicht abgeschlossen: Der Agent kann zurückkommen und ihn mit einem Terminalstatus beenden oder ihn auf setzen running fortfahren.
Die Agent-Workflow-Vorlage
Wenn Sie den Großteil der Arbeit eines Boards an Agenten übergeben, starten Sie den Arbeitsbereich über Agenten-Workflow Vorlage. Seine Listen folgen dem Verlauf eines Laufs, sodass die Tafel selbst zeigt, was die Agenten tun:
| Liste | Was es enthält |
|---|---|
| Rückstand | Das Werk liegt zur Übergabe an einen Makler bereit. |
| Agent arbeitet | Ein Agent hat eine running auf der Karte laufen. |
| Warte auf mich | Der Agent hat seine Ausführung auf eingestellt blocked und braucht eine Entscheidung von Dir. Die Laufzusammenfassung sagt, was es braucht. |
| Rezension | Die Arbeit ist für Ihre Bewertung bereit. Überprüfen Sie das Ergebnis, oft eine Pull-Anfrage im Pull-Anfrage Feld. |
| Fertig | Sie haben die Arbeit angenommen. Kanera markiert die Karte als abgeschlossen. |
Läufe bewegen oder vervollständigen niemals Karten von alleine. Agenten zeichnen die Originalliste auf, bevor sie eine Karte verschieben, und lesen dann die Karte und das Board vor der Übergabe noch einmal durch. Sie berücksichtigen die ursprüngliche Liste, aktuell verfügbare Listen und ihre Bedeutung, abgeschlossene und verbleibende Arbeit und wählen die Liste aus, die den tatsächlichen Status der Karte im Workflow dieses Boards widerspiegelt. Eine Rückkehr zur ursprünglichen Liste mag angebracht sein, erfolgt aber nicht automatisch. Listennamen und Reihenfolge geben kein Ziel vor. Wenn die Auswahl unklar ist, lassen sie die Liste unverändert, speichern andere Tracking-Updates und fragen nach.
Ein erfolgreicher Lauf deckt möglicherweise nur einen Teil einer Karte ab. Agenten füllen die Karte nur dann aus, wenn der vereinbarte Arbeitsablauf dies zulässt und seine Kriterien erfüllt sind; Diese Vorlage basiert standardmäßig auf menschlicher Akzeptanz. Vor ihrer endgültigen Antwort veröffentlichen sie einen Ergebniskommentar mit Änderungen, Überprüfung, Links, verbleibender Arbeit und dem Routing-Grund, beenden den Lauf entsprechend und überprüfen die gespeicherten Aktualisierungen. Schreibgeschützte und explorative Anfragen verursachen keine Tracking-Schreibvorgänge und explizite Benutzereinschränkungen haben Vorrang.
Die Vorlage fügt auch hinzu Funktion, Fehler, Pflicht, und Forschung Etiketten und eine Starterkarte, die den Ablauf erklärt. Der Agent eines Organisationsadministrators kann den Arbeitsbereich für Sie erstellen workspaces.create und templateId: "agent-workflow".
Läuft in Kartendetails und Aktivität
Öffnen Sie eine Karte mit einem Live-Lauf und einem Agent läuft Der Abschnitt erscheint direkt unter der Beschreibung. Jeder Lauf zeigt seinen Titel, den Agenten, seinen Status (Arbeiten oder Ich warte auf dich), als es zuletzt berichtete, und seine letzte Fortschrittsnotiz.
In diesem Abschnitt werden nur Live-Läufe angezeigt. Wenn ein Lauf endet, verschwindet er daraus und das Ergebnis wird zu einer Zeile im Aktivitäts-Feed der Karte, z abgeschlossen: <Titel> – <Abschlusszusammenfassung>, oder gescheitert oder abgesagt für die anderen Enden. Die abschließende Zusammenfassung ist die Notiz, die der Agent hinterlassen hat, als er den Lauf beendet hat. Bitten Sie die Agenten daher, daraus eine nützliche Aufzeichnung des Geschehens zu machen.
Der Beginn eines Laufs wird aufgezeichnet, der Kartenvorschub wiederholt ihn jedoch nicht; Im Live-Bereich werden Arbeiten während des Fluges gezeigt.
Benachrichtigungen über Agentenarbeit
Kanera lässt Sie normalerweise von Benachrichtigungen über Ihre eigenen Aktionen aus. Eine Ausnahme bildet die Arbeit, die Ihr Agent über OAuth erledigt hat: Sie werden darüber genauso benachrichtigt wie über die Arbeit eines Teamkollegen an einer Karte, die Sie beobachten oder der Sie zugewiesen sind, denn das Delegieren der Arbeit ist nicht dasselbe wie das Beobachten, wie sie geschieht.
Sobald ein Agent für Sie tätig wurde, erhält die Benachrichtigungsschublade einen Agent Registerkarte daneben Ungelesen und Alle. Es listet auf, was Ihre Agenten getan haben, ungelesene Benachrichtigungen und diejenigen, die in den letzten sieben Tagen gelesen wurden, und sein Etikett trägt die Anzahl der ungelesenen Nachrichten, z. B Agent (1). Jede Benachrichtigung trägt die über <agent> Abzeichen. Wenn Sie Benachrichtigungen nach Benutzer gruppieren, bildet die Arbeit Ihres Agenten eine eigene Gruppe mit der Bezeichnung <Person> über <Agent> anstatt mit deinem zu verschmelzen.
Das Starten und Beenden eines Laufs wird in der Aktivität der Karte aufgezeichnet, es wird jedoch nie eine Benachrichtigung gesendet. Benachrichtigungen decken ab, was der Agent tatsächlich getan hat, z. B. Kommentare, Bewegungen und Abschluss.
Agentenarbeit in „Erledigte Arbeit“.
Die Erledigte Arbeit view hält die Agentenausgabe von der eigenen Anstrengung der Leute getrennt. In einer Zeile, die ein Agent erstellt hat, ist neben der Person ein Glitzerzeichen zu sehen, und in der QuickInfo lautet „ Bearbeitet von <Person> über <Agent>. Der Avatar-Stapel der Tageszusammenfassung trägt das gleiche Zeichen.
Agentenzeilen werden nicht als eigene Arbeit der Person gezählt. Durch das Filtern der von einem Mitglied erledigten Arbeit werden nur die eigenen Aktionen dieser Person angezeigt, sodass die wöchentliche Lieferung niemals stillschweigend die Leistung eines Agenten als die Stunden einer anderen Person zählt.
Agentenaktivität ermitteln
- Benachrichtigungen: die Agent Auf der Registerkarte „Prüfung“ finden Sie die Überprüfungswarteschlange für alles, was Ihre Agenten getan haben.
- Eine Karte: Der Aktivitätsfeed der Karte wird angezeigt über <agent> Abzeichen und beendete Läufe. Ein Agent kann den vollständigen Ausführungsverlauf mit lesen
runs.listundincludeEnded. - Integrationen: Webhooks liefern
agentRun:startedundagentRun:updatedEreignisse für Automatisierungen, die auf Agentenarbeit reagieren.
Es gibt keinen boardweiten Filter für die Agentenaktivität im Aktivitätsfeed oder in der erledigten Arbeit.