CT 118 – Paperclip benutzen (einfach erklaert)

Was ist Paperclip ueberhaupt?

Paperclip ist in diesem Setup die Weboberflaeche unter:

https://agent.ls-cloud.biz

Darueber arbeitest du mit Agenten.

Ganz simpel gesagt:

• du oeffnest die Webseite
• meldest dich an
• waehlst einen Agenten
• schreibst, was der Agent tun soll
• liest die Antwort, Logs und den Status

Wenn du nur diesen Teil verstehst, bist du schon weiter als viele Produktdokus. Tragisch, aber wahr.

Schnellstart in 30 Sekunden

Wenn du einfach nur loslegen willst:

1. https://agent.ls-cloud.biz im Browser aufrufen
2. bei Authelia anmelden
3. in Paperclip einen vorhandenen Agenten anklicken
4. unten oder im zentralen Eingabebereich deine Anweisung eingeben
5. Run / Send / Start ausloesen
6. warten, bis Status, Ausgabe oder Logs erscheinen

Warum kommt zuerst ein Login?

Vor Paperclip sitzt Authelia. Das ist die vorgeschaltete Anmeldung mit optionalem 2FA-Schutz.

Das heisst:

• du kommst nicht direkt in Paperclip
• du wirst zuerst zu auth.ls-cloud.biz umgeleitet
• nach erfolgreichem Login landest du wieder bei agent.ls-cloud.biz

Wenn du dich also wunderst, warum erst Login kommt:

Das ist korrekt und gewollt.

So benutzt du Paperclip Schritt fuer Schritt

1. Seite oeffnen

Im Browser aufrufen:

https://agent.ls-cloud.biz

2. Bei Authelia anmelden

Wenn noch keine Session vorhanden ist:

• Benutzername eingeben
• Passwort eingeben
• falls verlangt: zweiten Faktor bestaetigen

Danach wirst du zurueck zu Paperclip geleitet.

3. In der Paperclip-Oberflaeche orientieren

Je nach Version kann die Oberflaeche leicht anders aussehen. Typisch sind aber folgende Bereiche:

• Agentenliste oder Auswahl vorhandener Agenten
• Runs / Sessions / Tasks
• Eingabefeld fuer Anweisungen
• Ausgabe / Verlauf / Logs
• Status wie idle, running, completed, failed

Wichtig: Du musst nicht jeden Knopf verstehen. Fuer den Anfang reichen drei Dinge:

• Wo waehle ich den Agenten?
• Wo tippe ich meine Aufgabe ein?
• Wo sehe ich die Antwort oder den Fehler?

4. Agent auswaehlen

Ein Agent ist vereinfacht gesagt der "Arbeiter" in Paperclip.

Du gibst ihm eine Aufgabe wie z. B.:

• etwas analysieren
• etwas zusammenfassen
• eine Struktur erstellen
• einen Ablauf planen

Wenn mehrere Agenten sichtbar sind:

• den passenden anklicken
• schauen, ob er grundsaetzlich verfuergbar wirkt
• falls ein Status angezeigt wird, ist idle oder ready meist gut

5. Aufgabe eingeben

Jetzt kommt deine eigentliche Anweisung.

Schlechtes Beispiel

mach mal server

Das ist inhaltlich duenn. Paperclip oder der Agent muessen dann raten, was du willst.

Besseres Beispiel

Analysiere, warum ein Webdienst nicht startet, und nenne mir die wahrscheinlichste Ursache.

Noch besseres Beispiel

Analysiere, warum der Dienst nicht startet, und gib mir:
1. die wahrscheinlichste Ursache
2. die betroffene Datei oder Komponente
3. einen konkreten Fix-Vorschlag

Faustregel:

Je klarer du schreibst, desto brauchbarer wird die Antwort.

6. Run starten

Je nach Oberflaeche heisst der Knopf eventuell:

• Run
• Start
• Send
• oder etwas aehnliches

Nach dem Start sollte sich sichtbar etwas tun:

• Status springt auf running
• es erscheinen Logzeilen
• spaeter eine Antwort oder ein Ergebnis

Wenn gar nichts passiert:

• falscher Agent?
• Browser haengt?
• Run wurde nicht wirklich ausgeloest?
• Seite neu laden und nochmal schauen

Was bedeuten die Stati?

idle

Der Agent wartet und ist nicht aktiv beschaeftigt.

running

Der Agent arbeitet gerade.

completed

Der Lauf ist fertig. Es sollte eine Ausgabe, Antwort oder ein Ergebnis geben.

failed

Der Lauf ist fehlgeschlagen. Dann sind Logs und Fehlermeldung wichtiger als jede Vermutung.

terminated

Der Lauf wurde beendet oder abgebrochen.

Wo lese ich das Ergebnis?

Meist an einer dieser Stellen:

• im Verlauf des Runs
• im Ausgabebereich
• in der Detailansicht des Tasks
• in den Logs

Wenn du nicht sicher bist, ob es geklappt hat, schau immer zuerst auf:

1. Status
2. sichtbare Antwort
3. Fehlermeldung / Logauszug

Typische Beispiele, was man damit machen kann

Mit Paperclip kannst du zum Beispiel:

• eine Aufgabe zusammenfassen lassen
• einen Plan aus etwas Chaotischem machen lassen
• technische Probleme grob analysieren lassen
• Struktur fuer ein Projekt oder eine Doku bauen lassen
• Ergebnisse und Laufverhalten von Agenten nachvollziehen

Beispiel-Workflows

Workflow 1 – Etwas erklaeren lassen

Beispiel:

Erklaere mir dieses Problem in einfachen Worten und gib mir drei naechste Schritte.

Sinnvoll, wenn:

• ein Thema unklar ist
• du aus Chaos erst einmal Struktur machen willst

Workflow 2 – Technisches Problem einschaetzen lassen

Beispiel:

Pruefe diese Fehlermeldung und nenne die wahrscheinlichste Ursache.

Sinnvoll, wenn:

• du erst eine Richtung brauchst
• du nicht blind irgendwo herumdoktern willst

Workflow 3 – Antwort in brauchbares Format zwingen

Beispiel:

Gib mir die Antwort als kurze Checkliste mit Prioritaet hoch, mittel, niedrig.

Sinnvoll, wenn:

• du keine Laberantwort willst
• du etwas sofort abarbeiten moechtest

Typische Probleme und was sie bedeuten

Problem: "Ich sehe nur den Login"

Das ist normal. Authelia sitzt davor. Erst anmelden, dann geht es zu Paperclip weiter.

Problem: "Ich bin eingeloggt, aber sehe keine brauchbare Antwort"

Dann kann es sein, dass:

• der Agent haengt
• der Run fehlgeschlagen ist
• die Aufgabe zu unklar war
• ein internes Adapter-/Backendproblem vorliegt

Problem: "Die Seite laedt, aber der Agent reagiert nicht"

Dann ist oft nicht die Domain das Problem, sondern eher:

• der Agent selbst
• der Run selbst
• ein internes Problem im Backend

Problem: "Ich bekomme nur Fehler"

Dann auf Schluesselwoerter achten wie:

• failed
• timeout
• auth
• adapter
• workspace
• parse

Diese Begriffe sagen oft schon recht genau, in welche Richtung der Fehler geht.

Woran erkenne ich, ob eher die App oder eher die Infrastruktur kaputt ist?

Eher Infrastrukturproblem

Wenn:

• die Seite gar nicht aufgeht
• nur 502 / Bad Gateway kommt
• der Redirect voellig kaputt ist
• du nicht sauber durch Authelia kommst

Eher App-/Agentenproblem

Wenn:

• Login klappt
• die Seite laedt
• aber der Agent nicht antwortet oder Runs scheitern

Mini-Checkliste bei Stoerungen

1. Komme ich auf https://agent.ls-cloud.biz?
2. Werde ich sauber zu Authelia umgeleitet?
3. Komme ich nach dem Login wieder zur App?
4. Kann ich einen Agenten waehlen?
5. Startet ein Run?
6. Was sagt der Status?
7. Was sagen die Logs?

Praktische Merksaetze

Wenn du nur einen einzigen Satz mitnehmen willst

Oeffnen, einloggen, Agent waehlen, Aufgabe klar schreiben, Ergebnis und Status lesen.

Damit kommt man in der Praxis schon ziemlich weit.