Blame
|
1 | # CT 118 – Paperclip benutzen (einfach erklaert) |
||||||
|
2 | |||||||
| 3 | > [!NOTE] |
|||||||
|
4 | > Diese Seite erklaert **die Benutzung von Paperclip** moeglichst einfach. Nicht primär Infrastruktur, nicht Container-Interna, sondern: **Wie komme ich rein, was mache ich dort, und woran sehe ich, ob etwas funktioniert?** |
||||||
|
5 | |||||||
|
6 | ## Was ist Paperclip ueberhaupt? |
||||||
|
7 | |||||||
|
8 | Paperclip ist in diesem Setup die Weboberflaeche unter: |
||||||
|
9 | |||||||
|
10 | ```text |
||||||
| 11 | https://agent.ls-cloud.biz |
|||||||
| 12 | ``` |
|||||||
|
13 | |||||||
|
14 | Darueber arbeitest du mit Agenten. |
||||||
|
15 | |||||||
|
16 | Ganz simpel gesagt: |
||||||
| 17 | - du oeffnest die Webseite |
|||||||
| 18 | - meldest dich an |
|||||||
| 19 | - waehlst einen Agenten |
|||||||
| 20 | - schreibst, was der Agent tun soll |
|||||||
| 21 | - liest die Antwort, Logs und den Status |
|||||||
|
22 | |||||||
|
23 | Wenn du nur diesen Teil verstehst, bist du schon weiter als viele Produktdokus. Tragisch, aber wahr. |
||||||
|
24 | |||||||
|
25 | ## Schnellstart in 30 Sekunden |
||||||
|
26 | |||||||
|
27 | Wenn du einfach nur loslegen willst: |
||||||
|
28 | |||||||
|
29 | 1. `https://agent.ls-cloud.biz` im Browser aufrufen |
||||||
| 30 | 2. bei **Authelia** anmelden |
|||||||
| 31 | 3. in Paperclip einen vorhandenen Agenten anklicken |
|||||||
| 32 | 4. unten oder im zentralen Eingabebereich deine Anweisung eingeben |
|||||||
| 33 | 5. Run / Send / Start ausloesen |
|||||||
| 34 | 6. warten, bis Status, Ausgabe oder Logs erscheinen |
|||||||
|
35 | |||||||
|
36 | ## Warum kommt zuerst ein Login? |
||||||
|
37 | |||||||
|
38 | Vor Paperclip sitzt **Authelia**. |
||||||
| 39 | Das ist die vorgeschaltete Anmeldung mit optionalem 2FA-Schutz. |
|||||||
|
40 | |||||||
|
41 | Das heisst: |
||||||
| 42 | - du kommst **nicht direkt** in Paperclip |
|||||||
| 43 | - du wirst zuerst zu `auth.ls-cloud.biz` umgeleitet |
|||||||
| 44 | - nach erfolgreichem Login landest du wieder bei `agent.ls-cloud.biz` |
|||||||
|
45 | |||||||
|
46 | Wenn du dich also wunderst, warum erst Login kommt: |
||||||
| 47 | ### Das ist korrekt und gewollt. |
|||||||
|
48 | |||||||
|
49 | ## So benutzt du Paperclip Schritt fuer Schritt |
||||||
|
50 | |||||||
|
51 | ## 1. Seite oeffnen |
||||||
|
52 | |||||||
|
53 | Im Browser aufrufen: |
||||||
|
54 | |||||||
|
55 | ```text |
||||||
| 56 | https://agent.ls-cloud.biz |
|||||||
| 57 | ``` |
|||||||
|
58 | |||||||
|
59 | ## 2. Bei Authelia anmelden |
||||||
|
60 | |||||||
|
61 | Wenn noch keine Session vorhanden ist: |
||||||
| 62 | - Benutzername eingeben |
|||||||
| 63 | - Passwort eingeben |
|||||||
| 64 | - falls verlangt: zweiten Faktor bestaetigen |
|||||||
|
65 | |||||||
|
66 | Danach wirst du zurueck zu Paperclip geleitet. |
||||||
|
67 | |||||||
|
68 | ## 3. In der Paperclip-Oberflaeche orientieren |
||||||
|
69 | |||||||
|
70 | Je nach Version kann die Oberflaeche leicht anders aussehen. Typisch sind aber folgende Bereiche: |
||||||
|
71 | |||||||
|
72 | - **Agentenliste** oder Auswahl vorhandener Agenten |
||||||
| 73 | - **Runs / Sessions / Tasks** |
|||||||
| 74 | - **Eingabefeld** fuer Anweisungen |
|||||||
| 75 | - **Ausgabe / Verlauf / Logs** |
|||||||
| 76 | - **Status** wie `idle`, `running`, `completed`, `failed` |
|||||||
|
77 | |||||||
|
78 | Wichtig: |
||||||
| 79 | Du musst nicht jeden Knopf verstehen. |
|||||||
| 80 | Fuer den Anfang reichen drei Dinge: |
|||||||
| 81 | - Wo waehle ich den Agenten? |
|||||||
| 82 | - Wo tippe ich meine Aufgabe ein? |
|||||||
| 83 | - Wo sehe ich die Antwort oder den Fehler? |
|||||||
|
84 | |||||||
|
85 | ## 4. Agent auswaehlen |
||||||
|
86 | |||||||
|
87 | Ein Agent ist vereinfacht gesagt der "Arbeiter" in Paperclip. |
||||||
|
88 | |||||||
|
89 | Du gibst ihm eine Aufgabe wie z. B.: |
||||||
| 90 | - etwas analysieren |
|||||||
| 91 | - etwas zusammenfassen |
|||||||
| 92 | - eine Struktur erstellen |
|||||||
| 93 | - einen Ablauf planen |
|||||||
|
94 | |||||||
|
95 | Wenn mehrere Agenten sichtbar sind: |
||||||
| 96 | - den passenden anklicken |
|||||||
| 97 | - schauen, ob er grundsaetzlich verfuergbar wirkt |
|||||||
| 98 | - falls ein Status angezeigt wird, ist `idle` oder `ready` meist gut |
|||||||
|
99 | |||||||
|
100 | ## 5. Aufgabe eingeben |
||||||
|
101 | |||||||
|
102 | Jetzt kommt deine eigentliche Anweisung. |
||||||
|
103 | |||||||
|
104 | ### Schlechtes Beispiel |
||||||
|
105 | |||||||
|
106 | ```text |
||||||
| 107 | mach mal server |
|||||||
| 108 | ``` |
|||||||
|
109 | |||||||
|
110 | Das ist inhaltlich duenn. Paperclip oder der Agent muessen dann raten, was du willst. |
||||||
|
111 | |||||||
|
112 | ### Besseres Beispiel |
||||||
|
113 | |||||||
|
114 | ```text |
||||||
| 115 | Analysiere, warum ein Webdienst nicht startet, und nenne mir die wahrscheinlichste Ursache. |
|||||||
| 116 | ``` |
|||||||
|
117 | |||||||
|
118 | ### Noch besseres Beispiel |
||||||
|
119 | |||||||
|
120 | ```text |
||||||
| 121 | Analysiere, warum der Dienst nicht startet, und gib mir: |
|||||||
| 122 | 1. die wahrscheinlichste Ursache |
|||||||
| 123 | 2. die betroffene Datei oder Komponente |
|||||||
| 124 | 3. einen konkreten Fix-Vorschlag |
|||||||
| 125 | ``` |
|||||||
|
126 | |||||||
|
127 | Faustregel: |
||||||
| 128 | ### Je klarer du schreibst, desto brauchbarer wird die Antwort. |
|||||||
|
129 | |||||||
|
130 | ## 6. Run starten |
||||||
|
131 | |||||||
|
132 | Je nach Oberflaeche heisst der Knopf eventuell: |
||||||
| 133 | - `Run` |
|||||||
| 134 | - `Start` |
|||||||
| 135 | - `Send` |
|||||||
| 136 | - oder etwas aehnliches |
|||||||
|
137 | |||||||
|
138 | Nach dem Start sollte sich sichtbar etwas tun: |
||||||
| 139 | - Status springt auf `running` |
|||||||
| 140 | - es erscheinen Logzeilen |
|||||||
| 141 | - spaeter eine Antwort oder ein Ergebnis |
|||||||
|
142 | |||||||
|
143 | Wenn **gar nichts** passiert: |
||||||
| 144 | - falscher Agent? |
|||||||
| 145 | - Browser haengt? |
|||||||
| 146 | - Run wurde nicht wirklich ausgeloest? |
|||||||
| 147 | - Seite neu laden und nochmal schauen |
|||||||
|
148 | |||||||
|
149 | ## Was bedeuten die Stati? |
||||||
|
150 | |||||||
|
151 | ### `idle` |
||||||
| 152 | Der Agent wartet und ist nicht aktiv beschaeftigt. |
|||||||
|
153 | |||||||
|
154 | ### `running` |
||||||
| 155 | Der Agent arbeitet gerade. |
|||||||
|
156 | |||||||
|
157 | ### `completed` |
||||||
| 158 | Der Lauf ist fertig. |
|||||||
| 159 | Es sollte eine Ausgabe, Antwort oder ein Ergebnis geben. |
|||||||
|
160 | |||||||
|
161 | ### `failed` |
||||||
| 162 | Der Lauf ist fehlgeschlagen. |
|||||||
| 163 | Dann sind Logs und Fehlermeldung wichtiger als jede Vermutung. |
|||||||
|
164 | |||||||
|
165 | ### `terminated` |
||||||
| 166 | Der Lauf wurde beendet oder abgebrochen. |
|||||||
|
167 | |||||||
|
168 | ## Wo lese ich das Ergebnis? |
||||||
|
169 | |||||||
|
170 | Meist an einer dieser Stellen: |
||||||
| 171 | - im Verlauf des Runs |
|||||||
| 172 | - im Ausgabebereich |
|||||||
| 173 | - in der Detailansicht des Tasks |
|||||||
| 174 | - in den Logs |
|||||||
|
175 | |||||||
|
176 | Wenn du nicht sicher bist, ob es geklappt hat, schau immer zuerst auf: |
||||||
| 177 | 1. **Status** |
|||||||
| 178 | 2. **sichtbare Antwort** |
|||||||
| 179 | 3. **Fehlermeldung / Logauszug** |
|||||||
|
180 | |||||||
|
181 | ## Typische Beispiele, was man damit machen kann |
||||||
|
182 | |||||||
|
183 | Mit Paperclip kannst du zum Beispiel: |
||||||
| 184 | - eine Aufgabe zusammenfassen lassen |
|||||||
| 185 | - einen Plan aus etwas Chaotischem machen lassen |
|||||||
| 186 | - technische Probleme grob analysieren lassen |
|||||||
| 187 | - Struktur fuer ein Projekt oder eine Doku bauen lassen |
|||||||
| 188 | - Ergebnisse und Laufverhalten von Agenten nachvollziehen |
|||||||
|
189 | |||||||
|
190 | ## Beispiel-Workflows |
||||||
|
191 | |||||||
|
192 | ## Workflow 1 – Etwas erklaeren lassen |
||||||
|
193 | |||||||
|
194 | Beispiel: |
||||||
|
195 | |||||||
|
196 | ```text |
||||||
| 197 | Erklaere mir dieses Problem in einfachen Worten und gib mir drei naechste Schritte. |
|||||||
|
198 | ``` |
||||||
| 199 | ||||||||
|
200 | Sinnvoll, wenn: |
||||||
| 201 | - ein Thema unklar ist |
|||||||
| 202 | - du aus Chaos erst einmal Struktur machen willst |
|||||||
|
203 | |||||||
|
204 | ## Workflow 2 – Technisches Problem einschaetzen lassen |
||||||
|
205 | |||||||
|
206 | Beispiel: |
||||||
|
207 | |||||||
|
208 | ```text |
||||||
| 209 | Pruefe diese Fehlermeldung und nenne die wahrscheinlichste Ursache. |
|||||||
|
210 | ``` |
||||||
| 211 | ||||||||
|
212 | Sinnvoll, wenn: |
||||||
| 213 | - du erst eine Richtung brauchst |
|||||||
| 214 | - du nicht blind irgendwo herumdoktern willst |
|||||||
|
215 | |||||||
|
216 | ## Workflow 3 – Antwort in brauchbares Format zwingen |
||||||
|
217 | |||||||
|
218 | Beispiel: |
||||||
|
219 | |||||||
|
220 | ```text |
||||||
| 221 | Gib mir die Antwort als kurze Checkliste mit Prioritaet hoch, mittel, niedrig. |
|||||||
|
222 | ``` |
||||||
| 223 | ||||||||
|
224 | Sinnvoll, wenn: |
||||||
| 225 | - du keine Laberantwort willst |
|||||||
| 226 | - du etwas sofort abarbeiten moechtest |
|||||||
| 227 | ||||||||
| 228 | ## Typische Probleme und was sie bedeuten |
|||||||
| 229 | ||||||||
| 230 | ## Problem: "Ich sehe nur den Login" |
|||||||
| 231 | Das ist normal. |
|||||||
| 232 | Authelia sitzt davor. |
|||||||
| 233 | Erst anmelden, dann geht es zu Paperclip weiter. |
|||||||
| 234 | ||||||||
| 235 | ## Problem: "Ich bin eingeloggt, aber sehe keine brauchbare Antwort" |
|||||||
| 236 | Dann kann es sein, dass: |
|||||||
| 237 | - der Agent haengt |
|||||||
| 238 | - der Run fehlgeschlagen ist |
|||||||
| 239 | - die Aufgabe zu unklar war |
|||||||
| 240 | - ein internes Adapter-/Backendproblem vorliegt |
|||||||
| 241 | ||||||||
| 242 | ## Problem: "Die Seite laedt, aber der Agent reagiert nicht" |
|||||||
| 243 | Dann ist oft **nicht** die Domain das Problem, sondern eher: |
|||||||
| 244 | - der Agent selbst |
|||||||
| 245 | - der Run selbst |
|||||||
| 246 | - ein internes Problem im Backend |
|||||||
| 247 | ||||||||
| 248 | ## Problem: "Ich bekomme nur Fehler" |
|||||||
| 249 | Dann auf Schluesselwoerter achten wie: |
|||||||
| 250 | - `failed` |
|||||||
| 251 | - `timeout` |
|||||||
| 252 | - `auth` |
|||||||
| 253 | - `adapter` |
|||||||
| 254 | - `workspace` |
|||||||
| 255 | - `parse` |
|||||||
| 256 | ||||||||
| 257 | Diese Begriffe sagen oft schon recht genau, in welche Richtung der Fehler geht. |
|||||||
| 258 | ||||||||
| 259 | ## Woran erkenne ich, ob eher die App oder eher die Infrastruktur kaputt ist? |
|||||||
| 260 | ||||||||
| 261 | ### Eher Infrastrukturproblem |
|||||||
| 262 | Wenn: |
|||||||
| 263 | - die Seite gar nicht aufgeht |
|||||||
| 264 | - nur 502 / Bad Gateway kommt |
|||||||
| 265 | - der Redirect voellig kaputt ist |
|||||||
| 266 | - du nicht sauber durch Authelia kommst |
|||||||
| 267 | ||||||||
| 268 | ### Eher App-/Agentenproblem |
|||||||
| 269 | Wenn: |
|||||||
| 270 | - Login klappt |
|||||||
| 271 | - die Seite laedt |
|||||||
| 272 | - aber der Agent nicht antwortet oder Runs scheitern |
|||||||
| 273 | ||||||||
| 274 | ## Mini-Checkliste bei Stoerungen |
|||||||
| 275 | ||||||||
| 276 | 1. Komme ich auf `https://agent.ls-cloud.biz`? |
|||||||
| 277 | 2. Werde ich sauber zu Authelia umgeleitet? |
|||||||
| 278 | 3. Komme ich nach dem Login wieder zur App? |
|||||||
| 279 | 4. Kann ich einen Agenten waehlen? |
|||||||
| 280 | 5. Startet ein Run? |
|||||||
| 281 | 6. Was sagt der Status? |
|||||||
| 282 | 7. Was sagen die Logs? |
|||||||
| 283 | ||||||||
| 284 | ## Praktische Merksaetze |
|||||||
| 285 | ||||||||
| 286 | > [!IMPORTANT] |
|||||||
| 287 | > Paperclip ist fuer die Benutzung kein Magieproblem, sondern fast immer nur ein Ablaufproblem: **Login, Agent waehlen, Aufgabe klar schreiben, Status lesen, Logs beachten.** |
|||||||
|
288 | |||||||
|
289 | > [!TIP] |
||||||
| 290 | > Wenn eine Antwort schlecht ist, ist oft nicht das Tool dumm, sondern die Anweisung zu unklar formuliert. Das klingt gemein, hilft aber erstaunlich oft. |
|||||||
|
291 | |||||||
|
292 | ## Wenn du nur einen einzigen Satz mitnehmen willst |
||||||
|
293 | |||||||
|
294 | ### Oeffnen, einloggen, Agent waehlen, Aufgabe klar schreiben, Ergebnis und Status lesen. |
||||||
|
295 | |||||||
|
296 | Damit kommt man in der Praxis schon ziemlich weit. |
||||||