DingTalk — IA per i Luoghi di Lavoro Cinesi

Immagina di entrare in un ufficio a Shanghai dove le chiacchiere davanti al distributore d’acqua avvengono dentro un’icona blu brillante: DingTalk. È un po’ Slack, un po’ Trello, un po’ portale HR, e per centinaia di milioni di utenti, è il posto di lavoro. Ora immagina il tuo agente AI, Hermes, che vive silenziosamente dentro quell’app: risponde alle domande, smista i compiti e invia promemoria senza mai uscire dalla chat. Questa è la promessa dell’integrazione DingTalk in Hermes Agent.

Perché DingTalk è Importante per gli Agenti AI

La maggior parte dei tutorial sugli agenti AI presuppone strumenti occidentali e di lingua inglese. Ma in Cina, DingTalk è il sistema operativo predefinito per la comunicazione aziendale. Se stai costruendo un agente open-source per un team a Shenzhen o una fabbrica a Chengdu, ti serve un ponte nativo. Hermes Agent ora fornisce esattamente questo: un’integrazione pulita e guidata dalla configurazione che trasforma qualsiasi gruppo DingTalk in un centro di comando per il tuo agente.

Configurazione del Bot DingTalk

Hai due strade: webhook (il più semplice, unidirezionale) o callback (full duplex, riceve messaggi). Per un vero assistente, vorrai il callback. Ecco il flusso:

1. Crea un bot nella Console Sviluppatori DingTalk.
2. Ottieni il tuo AppKey e AppSecret.
3. Configura un URL di callback pubblico (HTTPS richiesto) per i messaggi in arrivo.
4. Configura il webhook in uscita del bot per le risposte.

In Hermes, definisci tutto in config.yaml:

channels:
  dingtalk:
    enabled: true
    mode: callback          # oppure "webhook" per avvisi unidirezionali
    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"  # per le risposte
    agent_id: "your_agent_id"
    verify_token: "random_string_for_signature"

Ricevere Messaggi

Una volta attivo l’URL di callback, DingTalk invia ogni messaggio di gruppo a Hermes. L’agente analizza il payload JSON, estrae mittente, ID chat e testo, poi lo instrada alla tua pipeline di skill. Puoi filtrare per parola chiave, menzione o persino gruppi specifici. Ad esempio, rispondi solo quando il bot viene menzionato con @:

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

Inviare Risposte

Le risposte tornano indietro tramite l’URL del webhook. Hermes avvolge automaticamente la risposta nel formato messaggio DingTalk corretto: testo semplice, markdown o card interattive. Ecco una skill minimale che risponde con un saluto:

@agent.skill
async def greet(ctx, text):
    return f"Ciao da Hermes! Hai detto: {text}"

Niente chiamate HTTP manuali. Hermes gestisce firma, timestamp e busta JSON per te.

Riepilogo

L’integrazione DingTalk trasforma Hermes da un giocattolo da terminale a un cittadino del posto di lavoro per i team cinesi. Con poche righe in config.yaml, ottieni messaggistica bidirezionale, filtri per menzione e formattazione automatica delle risposte. Che tu stia costruendo un bot per il controllo qualità in una fabbrica o un assistente personale per un manager indaffarato, Hermes + DingTalk significa che la tua AI parla la lingua dell’ufficio cinese moderno: fluentemente, in modo affidabile e senza un singolo carattere cinese nel tuo codice.

---