Ct-118-Paperclipai - blame None

Blame

546dd5	Wiki	2026-04-08 20:55:40
Add CT 118 PaperclipAI article

# CT 118 – Paperclip benutzen (einfach erklaert)

> [!NOTE]

> 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?**

## Was ist Paperclip ueberhaupt?

Paperclip ist in diesem Setup die Weboberflaeche unter:

```text

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:

```text

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

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?