Eine Datei an einen laufenden Agenten senden

Während eine Aufgabe läuft, können Sie ihrem Agenten eine Datei übergeben — einen Screenshot des Fehlers, ein fehlgeschlagenes Log, eine Design-Vorlage, eine Datenprobe. Die Datei wird in den Workspace des Agenten geschrieben und Ihre Nachricht nennt den Pfad, sodass der Agent sie sofort öffnen kann.

Wo die Datei landet

Jeder Anhang wird nach /workspace/attachments/ im Workspace des Agenten geschrieben, und an Ihre Nachricht wird eine Zeile angehängt: [Attached screenshot: /workspace/attachments/intervention_…_screen.png]. Auf genau diesen Pfad beziehen Sie sich in weiteren Anweisungen zur Datei.

Aus der Weboberfläche

1. Öffnen Sie die Detailseite der laufenden Aufgabe und suchen Sie das Interventions-Eingabefeld.

2. Hängen Sie die Datei an und schreiben Sie Ihre Nachricht — zum Beispiel „Der Login-Button überlappt das Logo, siehe Screenshot“.

3. Absenden. Die Datei wird in den Workspace geschrieben, bevor der Agent Ihre Nachricht erhält — der genannte Pfad existiert also immer.

Aus Telegram

Senden Sie ein Foto an den Bot. Bei genau einer laufenden Aufgabe wird das Foto automatisch dieser zugeordnet; bei mehreren stellen Sie die Aufgaben-ID der Bildunterschrift voran und schreiben Ihre Nachricht dahinter:

3f9a1c2e-…  Der Login-Button überlappt das Logo

Der Bot bestätigt die Zustellung, und der Agent erhält Ihre Bildunterschrift mitsamt dem Pfad des Fotos.

Mehrere Dateien auf einmal

Eine Intervention kann mehrere Anhänge tragen. Jeder wird unter eigenem Namen geschrieben und in der Nachricht genannt, sodass der Agent sie unterscheiden kann. Zwei Dateien mit gleichem Namen überschreiben sich nicht gegenseitig.

Grenzwerte

Grenzwert	Wert	Was darüber hinaus passiert
Ein Anhang	4 MiB	Abgelehnt, mit Nennung des Limits und der tatsächlichen Größe
Alle Anhänge einer Nachricht	8 MiB	Abgelehnt — auf mehrere Nachrichten verteilen
Anhänge pro Nachricht	16	Abgelehnt

Nichts wird stillschweigend abgeschnitten oder verworfen: Ein Anhang kommt entweder Byte für Byte unversehrt an, oder Sie erhalten eine Fehlermeldung, die den Grund nennt.

Runner-Flotten

Das funktioniert identisch, ob die Aufgabe auf dem SupaCloud-Host selbst läuft oder an einen separaten Runner verteilt wurde. Die Datei reist gemeinsam mit Ihrer Nachricht über denselben Kanal, und die Maschine, die den Agenten ausführt, schreibt sie — es muss nichts über Hostgrenzen hinweg zugegriffen werden. Interventionen, Freigaben, Abbrüche sowie Modell- und Effort-Änderungen während des Laufs erreichen eine verteilte Aufgabe auf demselben Weg.

Anhänge beim Start

Dateien, die Sie beim Starten einer Aufgabe anhängen, nehmen denselben Weg: Sie werden vor dem ersten Zug des Agenten nach /workspace/attachments/ geschrieben — auf einem lokalen Lauf ebenso wie auf einem Flotten-Runner.

Wenn der Agent keine Bilder sehen kann

Hat das Modell der Aufgabe keine Bildfähigkeit, beschreibt SupaCloud jedes angehängte Bild in Text und hängt die Beschreibung an Ihre Nachricht an — so weiß auch ein Agent ohne Vision, was der Screenshot zeigt. Die Rohdatei bleibt in beiden Fällen im Workspace.

Welches Modell diese Beschreibung schreibt, ist eine Einstellung und keine feste Wahl: Einstellungen → Modelle → Vision-Modell. Bleibt das Feld leer, erbt der Arbeitsbereich die Instanz-Vorgabe; eine eingetragene Modell-ID überschreibt sie für diesen Arbeitsbereich. Dasselbe Modell ist auch der Rückfall des Visual-Verification-Judge, wenn ein Projekt kein eigenes Judge-Modell festgelegt hat.

Ist nirgends ein nutzbares Vision-Modell konfiguriert — nichts gesetzt, oder die eingetragene ID ist dem Modellkatalog unbekannt bzw. hat keine Zugangsdaten —, kann die Beschreibung nicht erzeugt werden. SupaCloud sagt das dann im Aktivitäts-Feed der Aufgabe („… konnte für dieses Modell nicht beschrieben werden“), statt das Bild stillschweigend zu übergehen. Die Rohdatei wird weiterhin zugestellt; der Agent kann sie nur nicht lesen, wenn er sie nicht selbst öffnet.

Foto mit /run-Bildunterschrift senden (Telegram)

In Telegram können Sie eine Aufgabe direkt aus einem Bild starten: Senden Sie das Foto mit /run <projekt> <agent> <prompt> als Bildunterschrift. Das Foto wird der neuen Aufgabe genauso angehängt wie über den Web-Composer, und die obige Regel für Modelle ohne Bildfähigkeit gilt unverändert. Ein Foto mit einer anderen Bildunterschrift geht weiterhin als Intervention an eine laufende Aufgabe.