Persönlicher Telegram-Assistent

Überblick

Der multimodale persönliche Assistent in Telegram verarbeitet Text, Bilder, Sprachnachrichten, Audio, Video und Dokumente. Middleware fügt jeder Nachricht die aktuelle UTC-Zeit für Zeitplanberechnungen hinzu und leitet Antworten über die Chat ID zurück. Nach Chat ID benannte persistente Sessions bewahren den Gesprächsverlauf über mehrere Nachrichten hinweg. Der Agent durchsucht das Web nach Echtzeitinformationen, liest vollständige Seiten, speichert und lädt kurze Notizen über die Datenbank, hinterlegt umfangreichere Informationen für die semantische Suche im Retrieval und plant mit trigger_agent_at Erinnerungen bis zu 7 Tage im Voraus. Antworten werden mit Telegram HTML Tags formatiert und über die ausgehende Verbindung gesendet.

Use Cases

Architektur

Wichtige Template-Dateien

Installiere diese Dateien mit connic init my-project --templates=telegram-personal-assistant. Die CLI legt die Agentendefinitionen unter agents/ in einem Ordner mit dem Namen des Templates ab.

telegram-personal-assistant/
  agents/
    telegram-assistant.yaml
  tools/
    assistant_tools.py
  middleware/
    telegram-assistant.py
  requirements.txt
  README.md

Loslegen

Installiere das Template, erstelle ein Connic-Projekt und starte das Deployment über ein verbundenes Git-Repository oder die CLI.

1. 1

   Installieren und Projekt anlegen

   Installiere das SDK und erstelle aus diesem Template ein Projekt.

   terminal

   Copy

   pip install connic-composer-sdk
   connic init my-project --templates=telegram-personal-assistant

   Danach cd my-project

2. 2

   Bereitstellen

   Wähle eine Deployment-Methode. Bei einem verbundenen Git-Repository startet jeder Push ein Deployment. Nutze die CLI für Projekte ohne verbundenes Git-Repository.

   Git-Integration

   1. 1

      Verbinde in Connic unter Projekt Settings → Git & Environments das GitHub-Repository

   2. 2

      Ordne auf derselben Seite den Branch (z. B. main) der Produktivumgebung zu

   3. 3

      Pushe das erzeugte Projekt in dieses Repository

   terminal

   Copy

   git add .
   git commit -m "Persönlicher Telegram-Assistent Template hinzufügen"
   git push origin main

   CLI Deployment

   1. 1

      Erstelle in Connic unter Projekt Settings → API Keys & MCP Auth einen API Key und kopiere die Projekt-ID

   2. 2

      Führe im Projektverzeichnis connic login aus

   3. 3

      Teste mit connic dev und Hot Reload, führe mit connic test Testsuiten aus oder starte mit connic deploy das Deployment für den Produktivbetrieb

   terminal

   Copy

   connic login
   connic dev     # Temporäre Entwicklungsumgebung mit Hot Reload
   connic test    # Deklarative Test Suites ausführen
   connic deploy  # In den Produktivbetrieb deployen

3. 3

   Verbinden und konfigurieren

   Erstelle über @BotFather einen Telegram Bot und füge anschließend mit dem Bot Token je eine eingehende und ausgehende Telegram-Verbindung hinzu. Der Webhook wird automatisch registriert. Ein connic/* KI-Modell nutzen oder BYOK-Zugangsdaten unter Projekt Settings → LLM Provider hinterlegen.

   Vollständiger Einrichtungsleitfaden für VerbindungenQuickstart GuideDocs zu Verbindungen