Projektagenten verstehen
Lege den Aufgabenbereich eines Agenten fest und verstehe das Zusammenspiel von Laufzeit, Modell, Anweisungen und Ausstattung.
3 Min. Lesezeit
Ein Projektagent ist eine benannte Konfiguration für Aufgaben in einem bestimmten Projekt. Du legst fest, wie er arbeitet und worauf er zugreifen darf, und gibst ihm eine Aufgabe mit einem prüfbaren Ergebnis. Jede Aufgabe, an der er arbeitet, läuft in einem Worker, einer laufenden Kopie des Agenten, die in einer eigenen Sandbox Dateien bearbeitet und Befehle ausführt. So kann ein Agent an mehreren Aufgaben gleichzeitig arbeiten. Der festgelegte Prüfer, eine Person oder ein unabhängiger Projektagent, prüft das Ergebnis vor dem Abschluss der Aufgabe. Neue Prüfungen, die menschliche Unabhängigkeit oder Kompetenznachweise voraussetzen, gehen in die menschliche Prüferkette; eine bereits einem Agenten zugewiesene Prüfung muss ausdrücklich an eine berechtigte Person übertragen werden.
Die passende Arbeitsform wählen
| Arbeitsform | Geeignete Arbeit | Was du festlegst |
|---|---|---|
| Chat | Fragen stellen, Wissen abrufen oder einen Text entwerfen. | Nachricht, Modell und gegebenenfalls Projektkontext. |
| Projektagent | Ein Repository prüfen, Dateien erstellen oder eine Aufgabe über mehrere Durchläufe bearbeiten. | Eine wiederverwendbare Agentenkonfiguration im Projekt. |
| Automatisierung | Festgelegte Schritte ausführen, auf Ereignisse reagieren oder zwischen Aktionen eine Freigabe einholen. | Einen versionierten Workflow und seine Eingaben. |
Auch ein Projektchat verwendet den eingebauten Chat-Assistenten. Die Wahl eines Projekts im Chat aktiviert keinen Projektagenten. Eine Agent-Node in einer Automatisierung hat wiederum ihre eigene Konfiguration.
Eine klare Verantwortung festlegen
Beginne mit einer Verantwortung, deren Ergebnis du beurteilen kannst, etwa: „Prüfe Änderungen auf Regressionen und belege deine Befunde.“ Das gehört in die dauerhaften Anweisungen des Agenten. Das konkrete Repository, Dateien, Abnahmekriterien und einen Termin beschreibst du in der jeweiligen Aufgabe.
Ein Agent gehört genau einem Projekt. Wer das Projekt lesen darf, sieht seine Agenten; wer es bearbeiten darf, kann sie im aktiven Projekt verwalten. Namen müssen innerhalb des Projekts eindeutig sein. Bis zu 50 Agenten sind möglich. Ein anderes Projekt braucht eine eigene Konfiguration, auch bei gleichem Namen und gleichen Anweisungen. Ein Projekt ohne eigene Agenten steht trotzdem nicht ohne da: Sofern ein Admin ihn nicht ausgeschaltet hat, übernimmt der Standard-Agent der Organisation seine Aufgaben, mit Einstellungen, die ein Admin für die ganze Organisation wählt.
Die Konfiguration verstehen
| Bestandteil | Was er bestimmt | Beispiel für deine Entscheidung |
|---|---|---|
| Agent-Laufzeit | Das Coding-Programm, das die Sitzung in einer Sandbox ausführt. | Wähle eine Laufzeit, die zum verfügbaren Zugang passt. |
| Modell und Provider | Das aufgerufene Modell und den bereitstellenden Provider. | Wähle eine für die Arbeit freigegebene Kombination. |
| Anweisungen | Wiederverwendbare Verantwortung und Arbeitsregeln, bis zu 20.000 Zeichen. | Verlange Belege und einen Bericht über durchgeführte Prüfungen. |
| Skills | Anweisungs-Bundles und ergänzende Dateien. | Ordne die Review-Checkliste des Teams zu. |
| Connectors und Tools | Verbundene Dienste und erlaubte Plattformoperationen. | Vergib Repository-Zugriff und nur die benötigten Aufgaben-Tools. |
| Secrets | Benannte Zugangsdaten der Organisation für die laufende Sitzung. | Nutze ein eng begrenztes Token für einen Dienst ohne Connector. |
Die Listen für Skills, Connectors, Tools und Secret-Namen erlauben jeweils bis zu 25 Einträge. Ein freigegebenes Schreib-Tool darf im Rahmen seiner Zugriffsregeln Daten ändern. Eine Anweisung zu vorsichtigem Vorgehen entzieht diese Berechtigung nicht. Nur Inhaber oder Admins dürfen Secret-Zuordnungen ändern. Das Wissen des Projekts zu durchsuchen braucht keine Freigabe: Das kann jeder Agent.
Vor der Zuweisung die Voraussetzungen prüfen
Die Provider-Zugangsdaten müssen zur gewählten Laufzeit und zum Modell passen. Außerdem muss Sandbox-Kapazität verfügbar sein: Ein Lauf wartet, bis einer der Agenten-Worker deiner Organisation frei ist. Eine erfolgreiche Chat-Antwort belegt diese Voraussetzungen nicht. Beschreibe in der Aufgabe das erwartete Ergebnis und füge das zu prüfende Material hinzu.
Sind diese Entscheidungen getroffen, erstelle einen Projektagenten. Die Aufgaben-Automatisierung erklärt Start, Steuerung und Prüfung seiner Arbeit.