DingTalk — ИИ для китайских рабочих мест

Представьте, что вы заходите в офис в Шанхае, где обсуждения у кулера происходят внутри ярко-синей иконки приложения — DingTalk. Это и Slack, и Trello, и HR-портал в одном флаконе, и для сотен миллионов пользователей это и есть рабочее место. Теперь представьте, что ваш ИИ-агент, Hermes, тихо живет внутри этого приложения — отвечает на вопросы, разбирает задачи и отправляет напоминания, не покидая чат. Именно это обещает интеграция DingTalk в Hermes Agent.

Почему DingTalk важен для ИИ-агентов

Большинство туториалов по ИИ-агентам предполагают англоязычные западные инструменты. Но в Китае DingTalk — это стандартная операционная система для делового общения. Если вы создаете опенсорс-агента для команды в Шэньчжэне или фабрики в Чэнду, вам нужен нативный мост. Hermes Agent теперь предоставляет именно это — чистую, настраиваемую через конфиг интеграцию, которая превращает любую группу в DingTalk в командный центр для вашего агента.

Настройка бота DingTalk

У вас есть два пути: webhook (самый простой, односторонний) или callback (полный дуплекс, получает сообщения). Для настоящего ассистента вам нужен callback. Вот как это работает:

1. Создайте бота в консоли разработчика DingTalk.
2. Получите свои AppKey и AppSecret.
3. Настройте публичный callback URL (требуется HTTPS) для входящих сообщений.
4. Настройте исходящий webhook бота для ответов.

В Hermes вы определяете это в config.yaml:

channels:
  dingtalk:
    enabled: true
    mode: callback          # или "webhook" для односторонних уведомлений
    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"  # для ответов
    agent_id: "your_agent_id"
    verify_token: "random_string_for_signature"

Получение сообщений

Как только callback URL заработает, DingTalk будет отправлять каждое сообщение из группы в Hermes. Агент разбирает JSON-запрос, извлекает отправителя, ID чата и текст, а затем направляет его в ваш конвейер навыков. Вы можете фильтровать по ключевым словам, упоминаниям или даже по конкретным группам. Например, отвечать только тогда, когда бота упоминают через @:

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

Отправка ответов

Ответы отправляются обратно через webhook URL. Hermes автоматически оборачивает ответ в правильный формат сообщения DingTalk — обычный текст, markdown или интерактивные карточки. Вот минимальный навык, который отвечает приветствием:

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

Никаких ручных HTTP-вызовов. Hermes сам обрабатывает подпись, временную метку и JSON-оболочку.

Итог

Интеграция с DingTalk превращает Hermes из игрушки для терминала в полноценного участника рабочего процесса для китайских команд. Всего несколько строк в config.yaml — и вы получаете двусторонний обмен сообщениями, фильтрацию по упоминаниям и автоматическое форматирование ответов. Строите ли вы QA-бота для заводского цеха или личного ассистента для занятого менеджера, Hermes + DingTalk означает, что ваш ИИ говорит на языке современного китайского офиса — бегло, надежно и без единого китайского иероглифа в вашем коде.

---