DingTalk — IA pour les Lieux de Travail Chinois

Imaginez que vous entrez dans un bureau à Shanghai où les discussions autour de la machine à café se déroulent dans une application à l’icône bleue éclatante—DingTalk. C’est un peu Slack, un peu Trello, un portail RH, et pour des centaines de millions d’utilisateurs, c’est le lieu de travail. Imaginez maintenant votre agent IA, Hermes, qui vit tranquillement dans cette application—répondant aux questions, triant les tâches et envoyant des relances sans jamais quitter le fil de discussion. C’est la promesse de l’intégration DingTalk dans Hermes Agent.

Pourquoi DingTalk est important pour les agents IA

La plupart des tutoriels sur les agents IA supposent un environnement anglophone et des outils occidentaux. Mais en Chine, DingTalk est le système d’exploitation par défaut pour la communication professionnelle. Si vous développez un agent open-source pour une équipe à Shenzhen ou une usine à Chengdu, vous avez besoin d’un pont natif. Hermes Agent offre désormais exactement cela—une intégration propre, pilotée par configuration, qui transforme n’importe quel groupe DingTalk en centre de commandement pour votre agent.

Configuration du bot DingTalk

Vous avez deux options : webhook (le plus simple, unidirectionnel) ou callback (full duplex, reçoit les messages). Pour un véritable assistant, vous opterez pour le callback. Voici le processus :

1. Créez un bot dans la console développeur DingTalk.
2. Obtenez votre AppKey et votre AppSecret.
3. Configurez une URL de callback publique (HTTPS requis) pour les messages entrants.
4. Configurez le webhook sortant du bot pour les réponses.

Dans Hermes, vous définissez cela dans config.yaml :

channels:
  dingtalk:
    enabled: true
    mode: callback          # ou "webhook" pour les alertes unidirectionnelles
    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"  # pour les réponses
    agent_id: "your_agent_id"
    verify_token: "random_string_for_signature"

Réception des messages

Une fois l’URL de callback active, DingTalk envoie chaque message de groupe à Hermes. L’agent analyse le payload JSON, extrait l’expéditeur, l’ID de la conversation et le texte, puis le route vers votre pipeline de compétences. Vous pouvez filtrer par mot-clé, mention, ou même par groupes spécifiques. Par exemple, ne répondre que lorsque le bot est mentionné avec @ :

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

Envoi de réponses

Les réponses repartent via l’URL du webhook. Hermes enveloppe automatiquement la réponse dans le format de message DingTalk correct—texte brut, markdown ou cartes interactives. Voici une compétence minimale qui renvoie un message de bienvenue :

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

Aucun appel HTTP manuel. Hermes gère la signature, l’horodatage et l’enveloppe JSON pour vous.

Résumé

L’intégration DingTalk transforme Hermes d’un simple jouet en ligne de commande en un véritable acteur du milieu professionnel pour les équipes chinoises. Avec quelques lignes dans config.yaml, vous obtenez une messagerie bidirectionnelle, un filtrage par mention et un formatage automatique des réponses. Que vous construisiez un bot d’assurance qualité pour un atelier ou un assistant personnel pour un manager débordé, Hermes + DingTalk signifie que votre IA parle la langue du bureau chinois moderne—couramment, de manière fiable, et sans un seul caractère chinois dans votre codebase.

---