KI-Agenten: Was sie sind und wie Sie Schritt für Schritt Ihren eigenen erstellen

Jeder spricht über KI-Agenten. Aber wenn man die meisten Leute fragt, was ein Agent eigentlich ist, bekommt man eine vage Antwort wie "KI, die Dinge autonom erledigt."

Die Realität ist jedoch viel nützlicher. Agenten sind keine Kategorie. Sie sind ein Spektrum.

Dieser Leitfaden erklärt, wo auf diesem Spektrum sich verschiedene KI-Tools befinden, was eine einfache LLM-Interaktion von einem echten agentischen Workflow unterscheidet, und wie du deinen eigenen Agenten mit Claude Code baust und ihn mit Telegram verbindest, ohne selbst Code schreiben zu müssen.

Bevor wir loslegen, folge mir auf X und tritt meinem Telegram-Kanal bei, den ich gerade erstellt habe und auf dem ich täglich mehr KI-Inhalte poste. Beides ist kostenlos.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp

Was etwas zu einem Agenten macht

Claude zu fragen "Was soll ich heute posten?" ist kein Agent. Das ist ein Chat.

Claude zu sagen "Finde die drei Themen, die gerade im KI-Bereich im Trend liegen, wähle das mit dem größten Engagement-Potenzial, verfasse einen Beitrag in meinem Stil und speichere ihn in einer Datei" und alles ohne dein Zutun erledigen zu lassen – das ist ein Agent.

Der Unterschied liegt nicht im Modell. Er liegt in der Struktur darum herum.

Ein Agent hat drei Dinge, die ein normaler Chat nicht hat: Werkzeuge, die er selbstständig aufrufen kann – Suche, Dateisysteme, Code-Ausführung, externe APIs. Gedächtnis, das über Aufgaben hinweg bestehen bleibt, nicht nur innerhalb einer Sitzung. Und eine Schleife, die so lange läuft, bis die Aufgabe erledigt ist, nicht nur bis eine Antwort generiert wurde.

Je mehr dieser drei Dinge du hinzufügst, desto weniger bist du involviert. Das ist die Idee.

Das Spektrum: Vom Chat zum Agenten

Am einen Ende hast du einen einfachen Chat. Du fragst, Claude antwortet, die Sitzung endet. Keine Werkzeuge, kein fortlaufendes Ziel, keine Fähigkeit, in der Welt zu handeln.

Eine Stufe höher: Claude mit aktivierten Werkzeugen. Wenn Claude vor der Antwort im Internet sucht, eine angehängte Datei liest oder ein Bild erstellt, ist er bereits leicht agentisch. Du hast ihm nicht Schritt für Schritt gesagt, er solle diese Dinge tun – er hat selbst entschieden, dass er sie braucht.

Weiter oben: mehrstufige Workflows. Du gibst ein Ziel vor, Claude zerlegt es in Schritte, führt jeden aus, überprüft das Ergebnis und liefert eine fertige Ausgabe. Du bist zwischen den Schritten nicht involviert.

Ganz oben: vollständig autonome Agenten. Der Agent läuft nach einem Zeitplan, überwacht Eingaben, ruft externe Dienste auf und erledigt komplexe Aufgaben ohne menschlichen Eingriff. Du setzt einmal das Ziel und überprüfst die Ausgabe.

Der Unterschied zwischen dem unteren und dem oberen Ende ist kein anderes Modell. Es ist das, was das Modell umgibt: Werkzeuge, die es aufrufen kann, Gedächtnis, das Kontext trägt, und eine Schleife, die so lange läuft, bis die Aufgabe erledigt ist.

Arten von Agenten, die du heute bauen kannst

Um dir eine Vorstellung davon zu geben, wie Agenten heute tatsächlich aussehen können, habe ich unten ein paar Beispiele zusammengestellt. Das sind keine Grenzen – du kannst alles bauen, was zu deiner spezifischen Situation passt.Recherche-Agent: Sammelt Informationen zu einem Thema, liest mehrere Quellen, extrahiert das Wesentliche und liefert eine strukturierte Zusammenfassung. Du gibst ihm eine Frage. Er gibt dir eine Antwort, deren manuelle Zusammenstellung Stunden gedauert hätte.

Schreib-Agent: Schreibt Inhalte nach einem von dir definierten System. Gib ihm deinen Ton, dein Format, deine Zielgruppe und dein Thema. Er kümmert sich um Entwürfe, Überarbeitungen und Korrekturen, ohne dass du jeden Satz selbst managen musst.

Code-Agent: Schreibt Code, führt ihn aus, liest die Fehler, behebt sie und macht weiter. Du beschreibst, was der Code tun soll. Der Agent übernimmt die Implementierungs- und Debugging-Schleife.

Geschäfts-Agent: Erledigt repetitive Geschäftsaufgaben: E-Mails entwerfen, Kundenanfragen bearbeiten, Leads qualifizieren, Berichte erstellen. Läuft auf Autopilot, sobald du die Regeln definiert hast.

Persönlicher Agent: Verwaltet deinen Zeitplan, organisiert Aufgaben, bereitet Briefings vor und erledigt die Planungsarbeit, die du täglich manuell machst.

Deinen ersten Agenten bauen – Hier starten

Du wirst Claude Code verwenden, um einen Telegram-Bot zu bauen, der auf einem Remote-Server läuft und Claude als sein Gehirn nutzt. Claude Code schreibt den gesamten Code für dich, du beschreibst einfach auf Englisch, was du willst. Sobald er eingerichtet ist, erfolgt die gesamte Kommunikation mit dem Bot direkt über Telegram.

Der gesamte Aufbau dauert etwa 10-20 Minuten. Du musst nicht programmieren können.

System-Prompt-Vorlagen – In Prompt 2 einfügen

Wenn du Prompt 2 aus dem unten stehenden Setup ausführst, musst du beschreiben, welche Art von Agenten du haben möchtest. Hier sind fertige Vorlagen. Kopiere die passende, füge sie in Prompt 2 an der Stelle ein, wo steht "Der Agent sollte sein:", und Claude Code wird diesen spezifischen Agenten bauen. Passe alle Details an deine Situation an.

Recherche-Agent

1Du bist ein Recherche-Agent. Deine Aufgabe ist es, Informationen zu jedem Thema, das ich dir nenne, zu sammeln, zu analysieren und zu synthetisieren.
2
3Wenn du eine Recherche-Aufgabe erhältst:
41. Identifiziere die 3-5 wichtigsten Unterfragen, die beantwortet werden müssen
52. Suche nach Informationen zu jeder einzelnen
63. Bewerte die Qualität und Relevanz jeder Quelle
74. Extrahiere nur das, was die Frage direkt beantwortet
85. Liefere eine strukturierte Zusammenfassung mit: wichtigsten Erkenntnissen, unterstützenden Beweisen und Lücken, die du nicht füllen konntest
9
10Format: Verwende Überschriften, Aufzählungspunkte und klare Abschnitte.
11Wenn du dir bei etwas unsicher bist, sag es explizit.
12Keine Füllwörter. Jeder Satz sollte Informationen enthalten.

Schreib-Agent

1Du bist ein Schreib-Agent. Du schreibst Inhalte in meiner Stimme und in meinem Stil.
2
3Mein Stil:
4- Konversationell, direkt, keine Unternehmenssprache
5- Kurze Sätze und Absätze
6- Konkrete Zahlen und Beispiele statt vager Behauptungen
7- Endet immer mit etwas, das der Leser tun oder worüber er nachdenken sollte
8
9Wenn du eine Schreibaufgabe erhältst:
101. Frage nach Thema, Zielgruppe und gewünschter Länge, falls nicht angegeben
112. Schreibe einen ersten Entwurf
123. Überprüfe ihn anhand meiner Stilregeln
134. Liefere die endgültige, veröffentlichungsbereite Version
14
15Füge niemals unnötige Einleitungen hinzu. Beginne mit dem wichtigsten Punkt.

Code-Agent

1Du bist ein Code-Agent. Deine Aufgabe ist es, Code zu schreiben, zu debuggen und zu verbessern.
2
3Wenn du eine Programmieraufgabe erhältst:
41. Bestätige dein Verständnis davon, was der Code tun soll
52. Schreibe die Lösung mit klaren Kommentaren
63. Identifiziere alle Randfälle oder potenziellen Fehler
74. Wenn es Fehler gibt, debugge sie systematisch, bevor du um Hilfe bittest
8
9Regeln:
10- Schreibe sauberen, lesbaren Code mit aussagekräftigen Variablennamen
11- Füge immer Fehlerbehandlung hinzu
12- Erkläre in einfacher Sprache, was jeder Hauptabschnitt tut
13- Wenn du dir bezüglich der Anforderungen unsicher bist, stelle eine klärende Frage, bevor du fortfährst

Geschäfts-E-Mail-Agent

1Du bist ein Business-E-Mail-Agent. Du schreibst professionelle E-Mails in meinem Namen.
2
3Mein Kommunikationsstil:
4- Direkt und respektvoll
5- Keine unnötigen Förmlichkeiten
6- Kommt im ersten Satz zur Sache
7- Endet mit einem klaren nächsten Schritt
8
9Wenn du eine E-Mail-Aufgabe erhältst:
101. Identifiziere das Ziel der E-Mail (informieren, anfragen, nachfassen, bestätigen)
112. Schreibe eine Betreffzeile, die den Zweck der E-Mail widerspiegelt
123. Verfasse die E-Mail in maximal 3-5 kurzen Absätzen
134. Ende mit einem klaren Aufruf zum Handeln oder einem nächsten Schritt
14
15Schreibe immer versandfertige E-Mails, keine Vorlagen mit auszufüllenden Lücken.

Persönlicher Planungs-Agent

1Du bist mein persönlicher Planungs-Agent. Du hilf mir, meine Arbeit zu organisieren, Aufgaben zu priorisieren und meine Woche zu planen.
2
3Wenn ich meine Aufgaben oder Ziele teile:
41. Identifiziere, was dringend vs. wichtig ist
52. Schlage eine realistische Reihenfolge basierend auf Abhängigkeiten vor
63. Schätze den Zeitaufwand für jede Aufgabe
74. Markiere alles, was delegiert oder eliminiert werden könnte
8
9Wenn ich ein Projekt beschreibe:
10- Zerlege es in konkrete nächste Aktionen
11- Identifiziere die einzelne wichtigste Sache, die zuerst zu tun ist
12- Erstelle eine einfache Checkliste, der ich folgen kann
13
14Halte alles praktisch. Keine motivierenden Füllwörter. Nur der Plan.

Was du vor dem Start brauchst

1 – Ein Claude-API-Schlüssel von console.anthropic.com. Das ist ein Entwickler-Schlüssel, du zahlst pro Nutzung, keine feste monatliche Gebühr. Für einen persönlichen Bot, der 50 Nachrichten pro Tag sendet, betragen die Kosten je nach gewähltem Modell 1-5 $ pro Monat.

2 – Ein Telegram-Bot-Token von BotFather.

3 – Einen VPS mit Linux. Für einen persönlichen Telegram-Bot brauchst du nichts Leistungsstarkes – 1 CPU, 1 GB RAM und 20 GB Speicher sind mehr als ausreichend. Jeder Basisplan von DigitalOcean, Hetzner oder Vultr funktioniert und kostet etwa 4 bis 6 $ pro Monat. Sobald du den Server hast, installiere Claude Code, indem du in deinem Terminal npm i -g @anthropic-ai/claude-code ausführst.

Welches Claude-Modell du für deinen Bot verwenden solltest und was es tatsächlich kostet:

Für die meisten persönlichen Bots ist Sonnet 4.6 die richtige Wahl – stark genug für jede Aufgabe und für den täglichen Gebrauch erschwinglich. Verwende Haiku 4.5, wenn du die Kosten minimieren möchtest. Opus 4.8 ist nur für einen komplexen Analyse-Agenten sinnvoll, bei dem die Antwortqualität entscheidend ist.

Deinen ersten Agenten bauen – Schritt 1

Öffne dein VPS-Terminal und starte Claude Code. Füge diesen Prompt ein und lass ihn alles bauen.

Gib dem Agenten eine Persönlichkeit

1Baue mir einen Telegram-Bot, der die Claude-API als sein Gehirn verwendet.
2
3Anforderungen:
4- Sprache: Python
5- Bibliothek für Telegram: python-telegram-bot
6- Claude-Modell: claude-sonnet-4-6
7- Der Bot empfängt eine Nachricht, sendet sie an die Claude-API und gibt Claudes Antwort an Telegram zurück
8- Behalte den Gesprächsverlauf pro Benutzer bei – jeder Benutzer hat innerhalb der Sitzung seinen eigenen Kontext
9- Füge einen /start-Befehl hinzu, der den Bot vorstellt
10- Füge einen /clear-Befehl hinzu, der den Gesprächsverlauf für diesen Benutzer zurücksetzt
11
12Erstelle alle notwendigen Dateien: Hauptbot-Datei, requirements.txt und eine .env-Dateivorlage für API-Schlüssel.
13Harte keine API-Schlüssel im Code – lies sie aus Umgebungsvariablen aus.

Als Hintergrunddienst bereitstellen

1Erstelle eine systemd-Dienstdatei, damit dieser Bot automatisch auf meinem Linux-VPS läuft und neu startet, falls er abstürzt.
2
3Der Dienst sollte:
4- Automatisch starten, wenn der Server hochfährt
5- Automatisch neu starten, falls er abstürzt
6- Umgebungsvariablen aus der .env-Datei im Projektordner laden
7- Logs in einer Datei speichern, die ich später überprüfen kann
8
9Schreibe mir auch die genauen Terminal-Befehle, um den Dienst zu installieren, zu starten, zu überprüfen, ob er läuft, und die Logs anzusehen.

Persistentes Gedächtnis zwischen Sitzungen hinzufügen

1Der Bot verliert den Gesprächsverlauf, wenn er neu startet. Behebe das.
2
3Speichere den Gesprächsverlauf jedes Benutzers nach jeder Nachricht in einer JSON-Datei auf der Festplatte. Lade ihn automatisch, wenn der Bot startet.
4
5Füge eine maximale Verlaufslänge hinzu – behalte nur die letzten 20 Nachrichten pro Benutzer, damit der Kontextfenster nie zu lang wird.

Fähigkeiten zu deinem Claude Code Bot hinzufügen

Fähigkeiten sind Funktionen, die du deinem Bot im Laufe der Zeit hinzufügst. Jede ist ein neuer Prompt, den du Claude Code gibst, und es schreibt den Code, um sie funktionsfähig zu machen. Hier sind die nützlichsten.

**Fähigkeit: Websuche

**Dein Agent kann Echtzeitinformationen nachschlagen, anstatt nur aus dem Gedächtnis zu antworten.

1Füge dem Bot eine Websuchfunktion hinzu, die die Tavily-API verwendet.
2
3Wenn der Benutzer etwas fragt, das aktuelle Informationen erfordert – Nachrichten, Preise, aktuelle Ereignisse – durchsucht der Bot automatisch das Internet und bezieht die Ergebnisse in seine Antwort ein.
4
5Der Bot sollte selbst entscheiden, wann er suchen und wann er aus dem Gedächtnis antworten soll. Füge TAVILY_API_KEY zur .env-Dateivorlage hinzu.
6
7Verwende Claudes Tool-Use-Funktion, um dies sauber zu implementieren.

**Fähigkeit: Notizen speichern

**Dein Agent kann alles, was du ihm sagst, in einer Datei speichern – Ideen, Aufgaben, Rechercheergebnisse – und später abrufen.

1Füge dem Bot eine Notiz-Speicherfunktion hinzu.
2
3Wenn der Benutzer "speichere das", "merke dir das" oder "Notiz:" sagt, speichert der Bot den Inhalt mit einem Zeitstempel in einer notes.txt-Datei.
4
5Füge einen /notes-Befehl hinzu, der die letzten 10 gespeicherten Notizen zurückgibt.
6Füge einen /clearnotes-Befehl hinzu, der alle gespeicherten Notizen löscht.

Fähigkeit: Auf dein Konto beschränken

Standardmäßig kann jeder, der deinen Bot findet, ihn nutzen und deine API-Guthaben verbrauchen. Das schränkt ihn auf dich ein.

1Füge eine Benutzerbeschränkung zum Bot hinzu, sodass nur ich ihn verwenden kann.
2
3Füge meine Telegram-Benutzer-ID als ALLOWED_USER_ID zur .env-Datei hinzu.
4Wenn jemand anderes den Bot anschreibt, antwortet er mit "Dieser Bot ist privat." und ignoriert alle weiteren Nachrichten dieses Benutzers.
5
6Füge auch hinzu, wie ich meine eigene Telegram-Benutzer-ID finden kann – entweder über den Bot selbst oder eine andere Methode.

Fähigkeit: API-Kosten verfolgen

Die Claude-API berechnet pro Token. Dies fügt einen einfachen Kosten-Tracker hinzu, sodass du immer weißt, was du ausgibst.

1Füge dem Bot eine grundlegende Kostenverfolgung hinzu.
2
3Protokolliere nach jeder Claude-API-Antwort die Anzahl der verwendeten Eingabe-Token und Ausgabe-Token.
4Führe eine laufende Summe in einer costs.json-Datei.
5
6Füge einen /costs-Befehl hinzu, der anzeigt: insgesamt heute verwendete Token, insgesamt aller Zeiten verwendete Token und eine geschätzte Kostenangabe in USD basierend auf den Preisen von claude-sonnet-4-6.

**Fähigkeit: Geplantes tägliches Briefing

**Der Agent sendet dir jeden Morgen eine Nachricht, ohne dass du fragen musst.

1Füge dem Bot ein geplantes tägliches Briefing hinzu.
2
3Jeden Tag um 8:00 Uhr sendet mir der Bot eine Nachricht mit:
41. Einem motivierenden Einzeiler (kurz, nicht kitschig)
52. Einer Erinnerung, meine wichtigste Priorität des Tages zu überprüfen
63. Einer zufälligen nützlichen Tatsache über Produktivität oder KI
7
8Sende es an meine Telegram-Benutzer-ID aus der .env-Datei.
9Verwende die Schedule- oder APScheduler-Bibliothek, um dies zu implementieren.

Nützliche Dinge nach der Einrichtung

So aktualisierst du die Persönlichkeit deines Agenten. Öffne die Hauptbot-Datei, suche die System-Prompt-Variable oben, ändere sie, speichere die Datei und starte den Dienst mit sudo systemctl restart dein-bot-name neu. Die neue Persönlichkeit ist sofort aktiv.

So überprüfst du, ob der Bot läuft. Führe sudo systemctl status dein-bot-name in deinem Terminal aus. Wenn dort "active (running)" steht, funktioniert er. Wenn "failed" angezeigt wird, überprüfe die Logs.

So liest du Logs. Führe journalctl -u dein-bot-name -n 50 aus, um die letzten 50 Zeilen zu sehen. Hier findest du Fehlermeldungen, wenn etwas kaputt geht.

So fügst du eine neue Fähigkeit hinzu. Öffne Claude Code in deinem Projektordner und beschreibe, was du willst: "Füge dem Bot die X-Funktion hinzu." Claude Code liest deinen vorhandenen Code, fügt die neue Funktion sauber hinzu und teilt dir mit, ob ein Neustart erforderlich ist.

Das Gedächtnisproblem, das jeder Agent hat

Dies ist das häufigste Problem, auf das Leute stoßen. Der Agent verliert den Kontext zwischen Sitzungen, während langer Aufgaben, nach zu vielen Nachrichten – und beginnt, Fehler zu machen oder Arbeit zu wiederholen, die er bereits erledigt hat.

**Dies geschieht auf drei Arten:

**

Lange Aufgaben überschreiten schließlich Claudes Kontextlimit, und der Agent beginnt, den Anfang des Gesprächs zu verlieren: das ursprüngliche Ziel, bereits getroffene Entscheidungen, von dir gesetzte Einschränkungen.

Wenn du eine Sitzung schließt und eine neue öffnest, startet der Agent von Null. -

Wenn der Agent mitten in einer Aufgabe unterbrochen wird, hat er keine Möglichkeit zu wissen, wo er aufgehört hat.

**Vier Dinge können das beheben:

**

Sage dem Agenten, er solle nach jedem größeren Schritt eine Fortschrittsnotiz schreiben: was wurde erledigt, was wurde entschieden, was muss noch passieren. Füge diese Notiz zu Beginn der nächsten Sitzung ein, um den vollständigen Kontext wiederherzustellen.

Bitte den Agenten alle zehn bis fünfzehn Nachrichten, zusammenzufassen, wo er steht. Dies zwingt ihn, den Kontext zu komprimieren, bevor er überläuft.

Bevor das Gespräch zu lang wird, bitte den Agenten, alles in eine kurze Zusammenfassung zu komprimieren und von dort aus fortzufahren. Der Thread bleibt intakt.

Füge die wichtigsten Fakten, die dein Agent immer braucht, direkt in den System-Prompt in deinem Bot-Code ein. Claude liest dies zu Beginn jedes Gesprächs, sodass diese Informationen unabhängig von der Länge immer im Kontext sind.

Checkpoint-Prompt

1Bevor wir fortfahren, schreibe einen kurzen Checkpoint:
21. Was hast du bisher abgeschlossen?
32. Was sind die wichtigsten Entscheidungen oder Erkenntnisse aus dieser Sitzung?
43. Was muss noch getan werden?
54. Welchen Kontext würdest du brauchen, um diese Aufgabe in einer neuen Sitzung fortzusetzen?
6
7Halte es unter 200 Wörtern.

Gedächtnisdatei-Prompt

1Schreibe nach Abschluss jedes größeren Schrittes eine Gedächtnisnotiz in diesem Format:
2
3SCHRITT ABGESCHLOSSEN: [was wurde getan]
4WICHTIGE ENTSCHEIDUNGEN: [getroffene Entscheidungen und warum]
5AKTUELLER STAND: [wo die Aufgabe jetzt steht]
6NÄCHSTER SCHRITT: [was als nächstes passieren sollte]
7
8Diese Notiz wird verwendet, um die Aufgabe in einer neuen Sitzung ohne Kontextverlust fortzusetzen.

Kontextwiederherstellungs-Prompt

1Wir setzen eine Aufgabe aus einer früheren Sitzung fort. Hier ist der Kontext:
2
3[füge hier deine Gedächtnisnotiz ein]
4
5Basierend darauf:
61. Bestätige dein Verständnis davon, wo wir stehen
72. Identifiziere den nächsten Schritt
83. Stelle alle Fragen, die für die Fortsetzung nötig sind
9
10Wiederhole keine Arbeit, die bereits abgeschlossen wurde.

Laufender Zusammenfassungs-Prompt

1Das Gespräch wird lang. Komprimiere alles Wichtige in eine Zusammenfassung:
2
31. Ursprüngliches Ziel
42. Was wurde getan und was wurde gefunden
53. Wichtige getroffene Entscheidungen
64. Was noch passieren muss
7
8Fahre nach dem Schreiben der Zusammenfassung von dort aus fort. Behandle diese Zusammenfassung als neuen Ausgangspunkt.

Du weißt jetzt, was Agenten sind, was sie können und wie du selbst einen bauen kannst. Ich hoffe, das war nützlich.

Wenn du über alles, was in der KI passiert, auf dem Laufenden bleiben möchtest, folge mir auf X und Telegram.

X - https://x.com/AnatoliKopadze

Telegram - https://t.me/kopadzemp