DingTalk — KI für chinesische Arbeitsplätze

Stell dir vor, du betrittst ein Büro in Shanghai, in dem die Gespräche am Wasserkühler in einer leuchtend blauen App stattfinden – DingTalk. Es ist halb Slack, halb Trello, halb HR-Portal, und für Hunderte Millionen Nutzer ist es der Arbeitsplatz. Stell dir nun vor, dein KI-Agent Hermes lebt still in dieser App – beantwortet Anfragen, priorisiert Aufgaben und verschickt Follow-ups, ohne den Chatthread je zu verlassen. Das ist das Versprechen der DingTalk-Integration in Hermes Agent.

Warum DingTalk für KI-Agenten wichtig ist

Die meisten KI-Agent-Tutorials gehen von englischsprachigen, westlichen Tools aus. Doch in China ist DingTalk das Standard-Betriebssystem für Geschäftskommunikation. Wenn du einen Open-Source-Agenten für ein Team in Shenzhen oder eine Fabrik in Chengdu baust, brauchst du eine native Brücke. Hermes Agent bietet genau das – eine saubere, konfigurationsgesteuerte Integration, die jede DingTalk-Gruppe in ein Kommandozentrum für deinen Agenten verwandelt.

Einrichtung des DingTalk-Bots

Du hast zwei Optionen: Webhook (am einfachsten, einseitig) oder Callback (vollduplex, empfängt Nachrichten). Für einen echten Assistenten willst du Callback. So läuft der Ablauf:

1. Erstelle einen Bot in der DingTalk Developer Console.
2. Hol dir deine AppKey und AppSecret.
3. Richte eine öffentliche Callback-URL (HTTPS erforderlich) für eingehende Nachrichten ein.
4. Konfiguriere den ausgehenden Webhook des Bots für Antworten.

In Hermes definierst du das in config.yaml:

channels:
  dingtalk:
    enabled: true
    mode: callback          # oder "webhook" für einseitige Alerts
    app_key: "your_app_key"
    app_secret: "your_app_secret"
    callback_url: "https://your-server.com/dingtalk/callback"
    webhook_url: "https://oapi.dingtalk.com/robot/send?access_token=xxx"  # für Antworten
    agent_id: "your_agent_id"
    verify_token: "random_string_for_signature"

Nachrichten empfangen

Sobald die Callback-URL aktiv ist, pusht DingTalk jede Gruppennachricht an Hermes. Der Agent parst das JSON-Payload, extrahiert Absender, Chat-ID und Text und leitet es an deine Skill-Pipeline weiter. Du kannst nach Schlüsselwörtern, Erwähnungen oder sogar bestimmten Gruppen filtern. Zum Beispiel nur antworten, wenn der Bot @erwähnt wird:

channels:
  dingtalk:
    filters:
      require_mention: true
      allow_groups:
        - "ops-alerts"
        - "ai-assistant"

Antworten senden

Antworten gehen über die Webhook-URL zurück. Hermes verpackt die Antwort automatisch im korrekten DingTalk-Nachrichtenformat – Klartext, Markdown oder interaktive Karten. Hier ist ein minimaler Skill, der einen Gruß zurückschickt:

@agent.skill
async def greet(ctx, text):
    return f"Hello from Hermes! You said: {text}"

Keine manuellen HTTP-Aufrufe nötig. Hermes übernimmt Signatur, Zeitstempel und JSON-Envelope für dich.

Zusammenfassung

Die DingTalk-Integration verwandelt Hermes von einem Terminal-Spielzeug in einen vollwertigen Arbeitsplatz-Bürger für chinesische Teams. Mit ein paar Zeilen in config.yaml bekommst du bidirektionale Nachrichtenübermittlung, Erwähnungsfilter und automatische Antwortformatierung. Ob du einen QA-Bot für die Fabrikhalle oder einen persönlichen Assistenten für einen vielbeschäftigten Manager baust – Hermes + DingTalk bedeutet, dass deine KI die Sprache des modernen chinesischen Büros spricht: fließend, zuverlässig und ohne ein einziges chinesisches Zeichen in deiner Codebasis.