DingTalk — IA para lugares de trabajo chinos

Imagina caminar hacia una oficina en Shanghái donde las conversaciones de la máquina de agua ocurren dentro de un brillante ícono de aplicación azul: DingTalk. Es parte Slack, parte Trello, parte portal de recursos humanos, y para cientos de millones de usuarios, es el lugar de trabajo. Ahora imagina a tu agente de IA, Hermes, viviendo silenciosamente dentro de esa aplicación: respondiendo consultas, clasificando tareas y enviando seguimientos sin salir nunca del hilo de chat. Esa es la promesa de la integración de DingTalk en Hermes Agent.

Por qué DingTalk importa para los agentes de IA

La mayoría de los tutoriales de agentes de IA asumen herramientas occidentales y de habla inglesa. Pero en China, DingTalk es el sistema operativo predeterminado para la comunicación empresarial. Si estás construyendo un agente de código abierto para un equipo en Shenzhen o una fábrica en Chengdu, necesitas un puente nativo. Hermes Agent ahora proporciona exactamente eso: una integración limpia y basada en configuración que convierte cualquier grupo de DingTalk en un centro de comando para tu agente.

Configuración del bot de DingTalk

Tienes dos caminos: webhook (lo más simple, unidireccional) o callback (dúplex completo, recibe mensajes). Para un asistente real, querrás el callback. Aquí está el flujo:

1. Crea un bot en la consola de desarrollador de DingTalk.
2. Obtén tu AppKey y AppSecret.
3. Configura una URL de callback pública (se requiere HTTPS) para los mensajes entrantes.
4. Configura el webhook de salida del bot para las respuestas.

En Hermes, defines esto en config.yaml:

channels:
  dingtalk:
    enabled: true
    mode: callback          # o "webhook" para alertas unidireccionales
    app_key: "tu_app_key"
    app_secret: "tu_app_secret"
    callback_url: "https://tu-servidor.com/dingtalk/callback"
    webhook_url: "https://oapi.dingtalk.com/robot/send?access_token=xxx"  # para respuestas
    agent_id: "tu_agent_id"
    verify_token: "cadena_aleatoria_para_firma"

Recibiendo mensajes

Una vez que la URL de callback está activa, DingTalk envía cada mensaje de grupo a Hermes. El agente analiza el payload JSON, extrae el remitente, el ID del chat y el texto, y luego lo enruta a tu pipeline de habilidades. Puedes filtrar por palabra clave, mención o incluso grupos específicos. Por ejemplo, responder solo cuando el bot es mencionado con @:

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

Enviando respuestas

Las respuestas se envían de vuelta a través de la URL del webhook. Hermes envuelve automáticamente la respuesta en el formato de mensaje correcto de DingTalk: texto plano, markdown o tarjetas interactivas. Aquí tienes una habilidad mínima que devuelve un saludo:

@agent.skill
async def saludar(ctx, text):
    return f"¡Hola desde Hermes! Dijiste: {text}"

Sin llamadas HTTP manuales. Hermes maneja la firma, la marca de tiempo y el sobre JSON por ti.

Resumen

La integración con DingTalk convierte a Hermes de un juguete de solo terminal a un ciudadano del lugar de trabajo para equipos chinos. Con unas pocas líneas en config.yaml, obtienes mensajería bidireccional, filtrado de menciones y formato automático de respuestas. Ya sea que estés construyendo un bot de control de calidad para una planta de fábrica o un asistente personal para un gerente ocupado, Hermes + DingTalk significa que tu IA habla el idioma de la oficina china moderna: con fluidez, fiabilidad y sin un solo carácter chino en tu código.

---