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

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

Das wahre Bild ist nützlicher als das. Agenten sind keine Kategorie. Sie sind ein Spektrum.

Dieser Leitfaden erklärt, wo auf diesem Spektrum verschiedene KI-Tools sitzen, 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 zu schreiben.

Bevor wir loslegen, folge mir auf X.

X -

https://x.com/ai_rohitt

Was macht etwas zu einem Agenten

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 aus, entwerfe einen Beitrag in meinem Stil und speichere ihn in einer Datei" und ihn das alles machen zu lassen, ohne dass du etwas anfasst – das ist ein Agent.

Der Unterschied liegt nicht im Modell. Es 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, Codeausführung, externe APIs. Speicher, der über Aufgaben hinweg bestehen bleibt, nicht nur innerhalb einer Sitzung. Und eine Schleife, die läuft, bis die Aufgabe erledigt ist, nicht nur, bis eine einzelne 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

An einem 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 dem Antworten das Internet durchsucht, eine angehängte Datei liest oder ein Bild generiert, ist es bereits leicht agentisch. Du hast ihm nicht Schritt für Schritt gesagt, diese Dinge zu tun; er hat selbstständig 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 das Ziel einmal und überprüfst die Ausgabe.

Der Unterschied zwischen unten und oben ist nicht ein anderes Modell. Es ist das, was das Modell umgibt: Werkzeuge, die es aufrufen kann, Speicher, der Kontext trägt, und eine Schleife, die weiterlä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 vor. Er kümmert sich um Entwürfe, Umschreibungen und Bearbeitungen, ohne dass du jeden Satz verwalten 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 wiederkehrende 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 jeden Tag manuell machst.

Baue deinen ersten Agenten – Starte hier

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

Die gesamte Einrichtung dauert etwa 10-20 Minuten. Du musst nicht programmieren können.

System-Prompt-Vorlagen – Füge sie in Prompt 2 ein

Wenn du Prompt 2 aus der folgenden Einrichtung ausführst, musst du beschreiben, welche Art von Agent du haben möchtest. Dies sind vorgefertigte Vorlagen; kopiere die passende, füge sie in Prompt 2 an der Stelle ein, wo "Der Agent sollte sein:" steht, 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 gebe, 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, sage es explizit.
12Füge keine Füllwörter hinzu. Jeder Satz sollte Informationen enthalten.

Schreib-Agent

1Du bist ein Schreib-Agent. Du schreibst Inhalte in meiner Stimme und meinem Stil.
2
3Mein Stil:
4- Gesprächig, 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 bedenken 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 dessen, 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 bei den Anforderungen unsicher bist, stelle eine klärende Frage, bevor du fortfährst

Geschäfts-E-Mail-Agent

1Du bist ein Geschäfts-E-Mail-Agent. Du schreibst professionelle E-Mails in meinem Namen.
2
3Mein Kommunikationsstil:
4- Direkt und respektvoll
5- Keine unnötigen Formalitäten
6- Kommt im ersten Satz auf den Punkt
7- Schließt 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. Beende mit einem klaren Aktionspunkt oder 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 hilfst 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 die benötigte Zeit 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 getan werden muss
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 - einen Claude-API-Schlüssel von console.anthropic.com. Dies ist ein Entwicklerschlü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 1-5 $ pro Monat, je nachdem, welches Modell du wählst.

2 - einen 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 genug. 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 npm i -g @anthropic-ai/claude-code in deinem Terminal 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 erschwinglich für den täglichen Gebrauch. 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.

Baue deinen ersten Agenten – 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 seinen eigenen Kontext innerhalb der Sitzung
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.

Bereitstellung als Hintergrunddienst

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

Füge dauerhaften Speicher zwischen Sitzungen hinzu

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 im Laufe der Zeit zu deinem Bot hinzufügst. Jede ist ein neuer Prompt, den du Claude Code gibst, und er schreibt den Code, um sie zum Laufen zu bringen. 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 mit der Tavily-API hinzu.
2
3Wenn der Benutzer etwas fragt, das aktuelle Informationen erfordert – Nachrichten, Preise, aktuelle Ereignisse – durchsucht der Bot automatisch das Web und bezieht die Ergebnisse in seine Antwort ein.
4
5Der Bot sollte selbstständig 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. Dies sperrt ihn nur für dich.

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 von diesem Benutzer.
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, damit 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 einen laufenden Gesamtbetrag 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 Kosten 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 für den Tag 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, finde 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 "active (running)" angezeigt wird, funktioniert es. Wenn "failed" angezeigt wird, überprüfe die Protokolle.

So liest du Protokolle. 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 Funktion X hinzu." Claude Code liest deinen vorhandenen Code, fügt die neue Funktion sauber hinzu und teilt dir mit, ob ein Neustart erforderlich ist.

Das Speicherproblem, das jeder Agent hat

Dies ist das häufigste Problem, auf das Leute stoßen. Der Agent verliert den Kontext zwischen Sitzungen, über lange Aufgaben hinweg, nach zu vielen Nachrichten und beginnt, Fehler zu machen oder bereits erledigte Arbeit zu wiederholen.

Es gibt drei Arten, wie dies passiert:

Lange Aufgaben überschreiten irgendwann 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, beginnt der Agent bei 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 dies beheben:Sage dem Agenten, er soll nach jedem größeren Schritt eine Fortschrittsnotiz schreiben: was getan wurde, was entschieden wurde, was noch passieren muss. 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 einer 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.

Speicherdatei-Prompt

1Schreibe nach Abschluss jedes größeren Schrittes eine Speichernotiz in diesem Format:
2
3SCHRITT ABGESCHLOSSEN: [was getan wurde]
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 fortzusetzen, ohne den Kontext zu verlieren.

Kontextwiederherstellungs-Prompt

1Wir setzen eine Aufgabe aus einer vorherigen Sitzung fort. Hier ist der Kontext:
2
3[füge hier deine Speichernotiz 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 zur Fortsetzung nötig sind
9
10Wiederhole keine Arbeit, die bereits abgeschlossen wurde.

Rollierende Zusammenfassung-Prompt

1Das Gespräch wird lang. Komprimiere alles Wichtige in einer Zusammenfassung:
2
31. Ursprüngliches Ziel
42. Was getan wurde und was gefunden wurde
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 baust. Ich hoffe, das war nützlich.

Wenn du über alles auf dem Laufenden bleiben möchtest, was im KI-Bereich passiert, folge mir auf X.

X - https://x.com/ai_rohitt